Method: projects.locations.notebooks.share

Gibt ein Notebook für andere Konten frei.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Vollständiger Ressourcenname von Notebook, z. B. projects/{project}/locations/{location}/notebooks/{notebookId}.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "accountAndRoles": [
    {
      object (AccountAndRole)
    }
  ],
  "notifyViaEmail": boolean
}
Felder
accountAndRoles[]

object (AccountAndRole)

Erforderlich. Die Liste der Konten und Rollen, für die das Notebook freigegeben werden soll.
notifyViaEmail

boolean

Erforderlich. Ob die freigegebenen Nutzer per E‑Mail benachrichtigt werden sollen.

Antworttext

Wenn der Vorgang erfolgreich ist, ist der Antworttext leer.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentication Overview.

IAM-Berechtigungen

Erfordert die folgenden IAM-Berechtigungen für die Ressource name:

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

Weitere Informationen finden Sie in der IAM-Dokumentation.

AccountAndRole

Konto- und Rolleninformationen.

JSON-Darstellung 
{
  "email": string,
  "role": enum (ProjectRole)
}
Felder
email

string

Erforderlich. Die mit dem Konto verknüpfte E‑Mail-Adresse.
role

enum (ProjectRole)

Erforderlich. Die Rolle im Notebook.

ProjectRole

Die Rolle des Projekts.

Enums
PROJECT_ROLE_UNKNOWN Unbekannte Rolle.
PROJECT_ROLE_OWNER Der Nutzer ist Inhaber des Projekts.
PROJECT_ROLE_WRITER Der Nutzer hat Schreibberechtigungen für das Projekt.
PROJECT_ROLE_READER Der Nutzer hat Leseberechtigungen für das Projekt.
PROJECT_ROLE_NOT_SHARED Der Nutzer hat keinen Zugriff auf das Projekt.