Method: customers.createCustomerClient

マネージャーの下に新しいクライアントを作成します。新しい顧客の顧客が返されます。

スローされるエラーのリスト: AccessInvitationError AuthenticationError AuthorizationError CurrencyCodeError HeaderError InternalError ManagerLinkError QuotaError RequestError StringLengthError TimeZoneError

HTTP リクエスト

POST https://googleads.googleapis.com/v16/customers/{customerId}:createCustomerClient

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

パスパラメータ

パラメータ
customerId

string

必須。クライアントのお客様が作成されるマネージャーの ID。

リクエスト本文

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

JSON 表現
{
  "customerClient": {
    object (Customer)
  },
  "accessRole": enum (AccessRole),
  "validateOnly": boolean,
  "emailAddress": string
}
フィールド
customerClient

object (Customer)

必須。作成する新規顧客。この顧客のリソース名は無視されます。

accessRole

enum (AccessRole)

作成されたクライアントのお客様に対して提案されたユーザーのロール。許可リストに登録されているお客様のみがアクセスできます。

validateOnly

boolean

true の場合、リクエストは検証されますが、実行されません。エラーのみが返され、結果は返されません。

emailAddress

string

作成したクライアントのお客様に招待するユーザーのメールアドレス。許可リストに登録されているお客様のみがアクセスできます。

レスポンスの本文

customers.createCustomerClient の変更に対するレスポンス メッセージ。

成功すると、レスポンスの本文に次の構造のデータが含まれます。

JSON 表現
{
  "resourceName": string,
  "invitationLink": string
}
フィールド
resourceName

string

新しく作成された顧客のリソース名。顧客リソース名の形式は customers/{customerId} です。

承認スコープ

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

  • https://www.googleapis.com/auth/adwords

詳細については、OAuth 2.0 の概要をご覧ください。