Method: customers.customerManagerLinks.mutate

顧客マネージャーのリンクを更新します。オペレーションのステータスが返されます。

スローされるエラーのリスト: AuthenticationError AuthorizationError DatabaseError FieldError FieldMaskError HeaderError InternalError ManagerLinkError MutateError QuotaError RequestError

HTTP リクエスト

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

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

パスパラメータ

パラメータ
customerId

string

必須。クライアント マネージャーのリンクを変更中の顧客の ID。

リクエスト本文

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

JSON 表現 
{
  "operations": [
    {
      object (CustomerManagerLinkOperation)
    }
  ],
  "validateOnly": boolean
}
フィールド
operations[]

object (CustomerManagerLinkOperation)

必須。個々の顧客管理者のリンクに対して行う操作のリストです。
validateOnly

boolean

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

レスポンスの本文

CustomerManagerLink の変換に対するレスポンス メッセージ。

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

JSON 表現 
{
  "results": [
    {
      object (MutateCustomerManagerLinkResult)
    }
  ]
}
フィールド
results[]

object (MutateCustomerManagerLinkResult)

変換リクエストの影響を受けるリソースを識別する結果。

承認スコープ

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

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

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

CustomerManagerLinkOperation

CustomerManagerLink のステータスを更新します。次のような対応が可能です。 1. ステータスが ACTIVE の更新オペレーションで保留中の招待を承諾します。2. ステータスが REFUSED の更新オペレーションでは、保留中の招待が拒否されます。3.ステータスが INACTIVE の更新オペレーションでマネージャーへのリンクを終了します。

JSON 表現 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "update": {
    object (CustomerManagerLink)
  }
  // End of list of possible types for union field operation.
}
フィールド
updateMask

string (FieldMask format)

更新で変更されるリソース フィールドを決定する FieldMask。

これは、フィールドの完全修飾名のカンマ区切りリストです。（例: "user.displayName,photo"）。
共用体フィールド operation。変換オペレーション。operation は次のいずれかになります。
update

object (CustomerManagerLink)

更新オペレーション: リンクには有効なリソース名が含まれていることが求められます。

MutateCustomerManagerLinkResult

顧客マネージャー リンクの結果が変わります。

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

string

オペレーションが正常に完了した場合に返されます。