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 di 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 degli account e dei ruoli con cui condividere il notebook.
notifyViaEmail

boolean

Obbligatorio. Se inviare una notifica via email agli utenti con cui è stato condiviso il report.

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

Per ulteriori informazioni, consulta 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 è il 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.