Method: projects.locations.notebooks.share

Shares a notebook to other accounts.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. Full resource name of Notebook, such as projects/{project}/locations/{location}/notebooks/{notebookId}.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "accountAndRoles": [
    {
      object (AccountAndRole)
    }
  ],
  "notifyViaEmail": boolean
}
Fields
accountAndRoles[]

object (AccountAndRole)

Required. The list of accounts and roles to share the notebook with.
notifyViaEmail

boolean

Required. Whether to notify the shared users via email.

Response body

If successful, the response body is empty.

Authorization scopes

Requires one of the following OAuth scopes:

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

For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permissions on the name resource:

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

For more information, see the IAM documentation.

AccountAndRole

Account and role information.

JSON representation 
{
  "email": string,
  "role": enum (ProjectRole)
}
Fields
email

string

Required. The email address associated with the account.
role

enum (ProjectRole)

Required. The role in the notebook.

ProjectRole

The role of the project.

Enums
PROJECT_ROLE_UNKNOWN Unknown role.
PROJECT_ROLE_OWNER The user owns the project.
PROJECT_ROLE_WRITER The user has writer permissions on the project.
PROJECT_ROLE_READER The user has reader permissions on the project.
PROJECT_ROLE_NOT_SHARED The user has no access to the project.