複数のユーザーに関する情報を作成し、アカウントやプロパティにリンクします。
このメソッドはトランザクション形式です。UserLink を作成できない場合、UserLink は作成されません。
HTTP リクエスト
POST https://analyticsadmin.googleapis.com/v1alpha/{parent=accounts/*}/userLinks:batchCreate
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
parent |
必須。リクエストのすべてのユーザーリンクの対象となるアカウントまたはプロパティ。このフィールドは必須です。CreateUserLinkRequest メッセージの親フィールドは空にするか、このフィールドと一致する必要があります。形式例: accounts/1234 |
リクエスト本文
リクエストの本文には次の構造のデータが含まれます。
JSON 表現 |
---|
{
"notifyNewUsers": boolean,
"requests": [
{
object ( |
フィールド | |
---|---|
notifyNewUsers |
(省略可)設定すると、リソースへのアクセス権が付与されたことを新しいユーザーにメールで通知します。設定されているかどうかに関係なく、各リクエスト内の notificationNewUser フィールドは無視されます。 |
requests[] |
必須。作成するユーザーリンクを指定するリクエスト。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 ( |
フィールド | |
---|---|
parent |
必須。形式例: accounts/1234 |
notifyNewUser |
(省略可)設定されている場合、リソースへのアクセス権が付与されたことを新しいユーザーに通知します。 |
userLink |
必須。作成するユーザーリンク。 |