Method: projects.locations.notebooks.share

Condivide un notebook con altri account.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatorio. Nome completo della risorsa Notebook, ad esempio projects/{project}/locations/{location}/notebooks/{notebookId}.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "accountAndRoles": [
    {
      object (AccountAndRole)
    }
  ],
  "notifyViaEmail": boolean
}
Campi
accountAndRoles[]

object (AccountAndRole)

Obbligatorio. L'elenco di account e ruoli con cui condividere il notebook.
notifyViaEmail

boolean

Obbligatorio. Indica se inviare una notifica via email agli utenti condivisi.

Corpo della risposta

In caso di esito positivo, il corpo della risposta è vuoto.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per saperne di più, consulta la Authentication Overview.

Autorizzazioni IAM

Richiede le seguenti autorizzazioni IAM per la risorsa name:

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

Per saperne di più, consulta la documentazione di IAM.

AccountAndRole

Informazioni sull'account e sul ruolo.

Rappresentazione JSON 
{
  "email": string,
  "role": enum (ProjectRole)
}
Campi
email

string

Obbligatorio. L'indirizzo email associato all'account.
role

enum (ProjectRole)

Obbligatorio. Il ruolo nel notebook.

ProjectRole

Il ruolo del progetto.

Enum
PROJECT_ROLE_UNKNOWN Ruolo sconosciuto.
PROJECT_ROLE_OWNER L'utente è proprietario del progetto.
PROJECT_ROLE_WRITER L'utente dispone delle autorizzazioni di scrittura per il progetto.
PROJECT_ROLE_READER L'utente dispone delle autorizzazioni di lettura per il progetto.
PROJECT_ROLE_NOT_SHARED L'utente non ha accesso al progetto.