アカウントまたはプロパティへの複数のユーザーのリンクに関する情報を作成します。
このメソッドはトランザクション型です。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
userLinks.create RPC に対するリクエスト メッセージ。
ユーザーは複数のメールアドレスを Google アカウントに関連付けることができ、そのうちの 1 つが「メイン」のメールアドレスとなります。Google アカウントに関連付けられているメールアドレスはいずれも新しい UserLink に使用できますが、返される UserLink には常に「メイン」のメールアドレスが含まれます。そのため、このリクエストの入力メールアドレスと出力メールアドレスが一致しないことがあります。
JSON 表現 |
---|
{
"parent": string,
"notifyNewUser": boolean,
"userLink": {
object ( |
フィールド | |
---|---|
parent |
必須。形式の例: accounts/1234 |
notifyNewUser |
(省略可)設定されている場合は、新しいユーザーにメールを送信して、リソースに対する権限が付与されたことを通知します。 |
userLink |
必須。作成するユーザーリンク。 |