Method: accounts.userLinks.batchCreate

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

複数のユーザーに関する情報を作成し、アカウントやプロパティにリンクします。

このメソッドはトランザクション形式です。UserLink を作成できない場合、UserLink は作成されません。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
parent

string

必須。リクエストのすべてのユーザーリンクの対象となるアカウントまたはプロパティ。このフィールドは必須です。CreateUserLinkRequest メッセージの親フィールドは空にするか、このフィールドと一致する必要があります。形式例: accounts/1234

リクエスト本文

リクエストの本文には次の構造のデータが含まれます。

JSON 表現
{
  "notifyNewUsers": boolean,
  "requests": [
    {
      object (CreateUserLinkRequest)
    }
  ]
}
フィールド
notifyNewUsers

boolean

(省略可)設定すると、リソースへのアクセス権が付与されたことを新しいユーザーにメールで通知します。設定されているかどうかに関係なく、各リクエスト内の notificationNewUser フィールドは無視されます。

requests[]

object (CreateUserLinkRequest)

必須。作成するユーザーリンクを指定するリクエスト。1 つのバッチに作成できるユーザーリンクは 1,000 個までです。

レスポンスの本文

成功した場合、レスポンスの本文には BatchCreateUserLinksResponse のインスタンスが含まれます。

認証スコープ

次の OAuth スコープが必要です。

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

CreateUserLinkRequest

CreateUserLink RPC に対するリクエスト メッセージ。

Google アカウントには複数のメールアドレスを関連付けられます。メールアドレスの 1 つは「メイン」のメールアドレスです。Google アカウントに関連付けられている任意のメールアドレスを新しい UserLink に使用できますが、返される UserLink には常に「primary」のメールアドレスが含まれます。そのため、このリクエストの入力メールアドレスと出力メールアドレスは異なる場合があります。

JSON 表現
{
  "parent": string,
  "notifyNewUser": boolean,
  "userLink": {
    object (UserLink)
  }
}
フィールド
parent

string

必須。形式例: accounts/1234

notifyNewUser

boolean

(省略可)設定されている場合、リソースへのアクセス権が付与されたことを新しいユーザーに通知します。