Method: projects.locations.notebooks.share

Partage un notebook avec d'autres comptes.

Requête HTTP


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

Les URL utilisent la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Nom complet de la ressource Notebook, par exemple projects/{project}/locations/{location}/notebooks/{notebookId}.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "accountAndRoles": [
    {
      object (AccountAndRole)
    }
  ],
  "notifyViaEmail": boolean
}
Champs
accountAndRoles[]

object (AccountAndRole)

Obligatoire. Liste des comptes et des rôles avec lesquels partager le notebook.
notifyViaEmail

boolean

Obligatoire. Indique si les utilisateurs avec lesquels le fichier est partagé doivent être avertis par e-mail.

Corps de la réponse

Si la requête aboutit, le corps de la réponse est vide.

Niveaux d'accès des autorisations

Nécessite l'un des niveaux d'accès OAuth suivants :

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

Pour plus d'informations, consultez la page Authentication Overview.

Autorisations IAM

Nécessite les autorisations IAM suivantes sur la ressource name :

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

Pour en savoir plus, consultez la documentation IAM.

AccountAndRole

Informations sur le compte et le rôle.

Représentation JSON 
{
  "email": string,
  "role": enum (ProjectRole)
}
Champs
email

string

Obligatoire. Adresse e-mail associée au compte.
role

enum (ProjectRole)

Obligatoire. Rôle dans le notebook.

ProjectRole

Rôle du projet.

Enums
PROJECT_ROLE_UNKNOWN Rôle inconnu.
PROJECT_ROLE_OWNER L'utilisateur est propriétaire du projet.
PROJECT_ROLE_WRITER L'utilisateur dispose d'autorisations d'écriture sur le projet.
PROJECT_ROLE_READER L'utilisateur dispose des autorisations de lecteur sur le projet.
PROJECT_ROLE_NOT_SHARED L'utilisateur n'a pas accès au projet.