Method: projects.locations.notebooks.share

Compartilha um notebook com outras contas.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação 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 da solicitação

O corpo da solicitação 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 papéis com que o notebook será compartilhado.
notifyViaEmail

boolean

Obrigatório. Se os usuários compartilhados serão notificados por e-mail.

Corpo da resposta

Se a solicitação for concluída, o corpo da resposta estará vazio.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer as seguintes permissões do 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 e-mail associado à conta.
role

enum (ProjectRole)

Obrigatório. A função no notebook.

ProjectRole

A função do projeto.

Tipos enumerados
PROJECT_ROLE_UNKNOWN Função desconhecida.
PROJECT_ROLE_OWNER O usuário é proprietário do projeto.
PROJECT_ROLE_WRITER O usuário tem permissões de gravação no projeto.
PROJECT_ROLE_READER O usuário tem permissões de leitura no projeto.
PROJECT_ROLE_NOT_SHARED O usuário não tem acesso ao projeto.