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

CreateUserLinkRequest

userLinks.create RPC 的要求訊息。

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

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

string

必要欄位。格式範例：accounts/1234
notifyNewUser

boolean

選用設定。設定完成後，系統會發送電子郵件通知新使用者，說明他們已獲得資源權限。