Method: accounts.userLinks.batchCreate

建立多個使用者的相關資訊|連結帳戶或資源的連結。

這種方法屬於交易性質。無法建立任何 UserLink。系統不會建立任何 UserLink。

HTTP 要求

POST https://analyticsadmin.googleapis.com/v1alpha/{parent=accounts/*}/userLinks:batchCreate

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

路徑參數

參數
parent

string

必要，請求中所有使用者連結的目標帳戶或資源。這是必填欄位。CreateUserLinkRequest 訊息中的上層欄位必須為空白或符合這個欄位。格式範例：accounts/1234

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "notifyNewUsers": boolean,
  "requests": [
    {
      object (CreateUserLinkRequest)
    }
  ]
}
欄位
notifyNewUsers

boolean

選用，設定完成後，請傳送電子郵件給新使用者，說明他們已獲得資源存取權。無論是否設定這項政策，系統會忽略每個要求中的 notificationNewUser 欄位。
requests[]

object (CreateUserLinkRequest)

必要，指定要求建立使用者連結的要求。您最多可建立 1000 個使用者連結。

回應主體

如果成功，回應主體會包含 BatchCreateUserLinksResponse 的執行例項。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/analytics.manage.users

建立使用者連結要求

CreateUserLink RPC 的要求訊息。

使用者可以有多個與 Google 帳戶相關聯的電子郵件地址，其中一個電子郵件地址為「主要」電子郵件地址。任何與 Google 帳戶相關聯的電子郵件地址皆可用於新的 UserLink，但傳回的 UserLink 一律會包含「primary」。因此，這項要求的輸入和輸出電子郵件地址可能會有所不同。

JSON 表示法 
{
  "parent": string,
  "notifyNewUser": boolean,
  "userLink": {
    object (UserLink)
  }
}
欄位
parent

string

必要，格式範例：accounts/1234
notifyNewUser

boolean

選用，設定完成後，請傳送電子郵件給新使用者，通知他們已獲得資源權限。