Method: projects.locations.notebooks.share

Partilha um bloco de notas com outras contas.

Pedido HTTP

POST https://discoveryengine.googleapis.com/v1alpha/{name=projects/*/locations/*/notebooks/*}:share

O URL usa a sintaxe de transcodificação de gRPC.

Parâmetros de caminho

Parâmetros
name

string

Obrigatório. Nome completo do recurso de Notebook, como projects/{project}/locations/{location}/notebooks/{notebookId}.

Corpo do pedido

O corpo do pedido contém dados com a seguinte estrutura:

Representação JSON 
{
  "accountAndRoles": [
    {
      object (AccountAndRole)
    }
  ],
  "notifyViaEmail": boolean
}
Campos
accountAndRoles[]

object (AccountAndRole)

Obrigatório. A lista de contas e funções com as quais quer partilhar o bloco de notas.
notifyViaEmail

boolean

Obrigatório. Se deve notificar os utilizadores com quem partilhou por email.

Corpo da resposta

Se for bem-sucedido, o corpo da resposta está vazio.

Âmbitos de autorização

Requer um dos seguintes âmbitos do OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.readwrite

Para mais informações, consulte o Authentication Overview.

Autorizações de IAM

Requer as seguintes autorizações de IAM no recurso name:

  • discoveryengine.notebooks.getIamPolicy
  • discoveryengine.notebooks.setIamPolicy

Para mais informações, consulte a documentação do IAM.

AccountAndRole

Informações da conta e da função.

Representação JSON 
{
  "email": string,
  "role": enum (ProjectRole)
}
Campos
email

string

Obrigatório. O endereço de email associado à conta.
role

enum (ProjectRole)

Obrigatório. A função no bloco de notas.

ProjectRole

A função do projeto.

Enumerações
PROJECT_ROLE_UNKNOWN Função desconhecida.
PROJECT_ROLE_OWNER O utilizador é proprietário do projeto.
PROJECT_ROLE_WRITER O utilizador tem autorizações de gravação no projeto.
PROJECT_ROLE_READER O utilizador tem autorizações de leitor no projeto.
PROJECT_ROLE_NOT_SHARED O utilizador não tem acesso ao projeto.