Method: customers.merchantCenterLinks.mutate

ステータスを更新するか、Merchant Center リンクを削除します。

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

HTTP リクエスト

POST https://googleads.googleapis.com/v14/customers/{customerId}/merchantCenterLinks:mutate

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

パスパラメータ

パラメータ
customerId

string

必須。変更対象のお客様の ID。

リクエスト本文

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

JSON 表現
{
  "operation": {
    object (MerchantCenterLinkOperation)
  },
  "validateOnly": boolean
}
フィールド
operation

object (MerchantCenterLinkOperation)

必須。リンクで実行するオペレーション

validateOnly

boolean

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

レスポンスの本文

Merchant Center リンクの変更に対するレスポンス メッセージです。

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

JSON 表現
{
  "result": {
    object (MutateMerchantCenterLinkResult)
  }
}
フィールド
result

object (MutateMerchantCenterLinkResult)

ミューテーションの結果。

認可スコープ

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

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

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

MerchantCenterLinkOperation

Merchant Center リンクの更新が 1 回のみ。

JSON 表現
{
  "updateMask": string,

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

string (FieldMask format)

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

完全修飾フィールド名のカンマ区切りリストです。(例: "user.displayName,photo")。

共用体フィールド operationoperation を実行するオペレーションは、次のいずれかになります。
update

object (MerchantCenterLink)

更新オペレーション: Merchant Center リンクには有効なリソース名が必要です。

remove

string

削除オペレーション: 削除された Merchant Center リンクのリソース名は次の形式で指定します。

customers/{customerId}/merchantCenterLinks/{merchantCenterId}

MutateMerchantCenterLinkResult

Merchant Center リンクの結果が変化する。

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

string

成功したオペレーションに対して返されます。