Method: projects.locations.notebooks.share

與其他帳戶共用筆記本。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
name

string

這是必要旗標，Notebook 的完整資源名稱，例如 projects/{project}/locations/{location}/notebooks/{notebookId}。

要求主體

要求主體包含下列結構的資料：

JSON 表示法 
{
  "accountAndRoles": [
    {
      object (AccountAndRole)
    }
  ],
  "notifyViaEmail": boolean
}
欄位
accountAndRoles[]

object (AccountAndRole)

這是必要旗標，要共用筆記本的帳戶和角色清單。
notifyViaEmail

boolean

這是必要旗標，是否透過電子郵件通知共用使用者。

回應主體

如果成功，回應主體會留白。

授權範圍

需要下列其中一種 OAuth 範圍：

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

詳情請參閱Authentication Overview。

IAM 權限

需要 name 資源的下列 IAM 權限：

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

詳情請參閱 IAM 說明文件。

AccountAndRole

帳戶和角色資訊。

JSON 表示法 
{
  "email": string,
  "role": enum (ProjectRole)
}
欄位
email

string

這是必要旗標，與帳戶相關聯的電子郵件地址。
role

enum (ProjectRole)

這是必要旗標，筆記本中的角色。

ProjectRole

專案的角色。

列舉
PROJECT_ROLE_UNKNOWN 不明角色。
PROJECT_ROLE_OWNER 使用者是專案擁有者。
PROJECT_ROLE_WRITER 使用者擁有專案的寫入者權限。
PROJECT_ROLE_READER 使用者擁有專案的讀者權限。
PROJECT_ROLE_NOT_SHARED 使用者沒有專案存取權。