Method: customers.merchantCenterLinks.mutate

وضعیت را به روز می کند یا پیوند Merchant Center را حذف می کند.

لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError FieldMaskError HeaderError داخلی خطا QuotaError RequestError

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
customerId

string

ضروری. شناسه مشتری در حال تغییر است.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "operation": {
    object (MerchantCenterLinkOperation)
  },
  "validateOnly": boolean
}
زمینه های
operation

object ( MerchantCenterLinkOperation )

ضروری. عملیاتی که باید روی پیوند انجام شود

validateOnly

boolean

اگر درست باشد، درخواست تایید می شود اما اجرا نمی شود. فقط خطاها برگردانده می شوند، نه نتایج.

بدن پاسخگو

پیام پاسخ برای جهش پیوند Merchant Center.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "result": {
    object (MutateMerchantCenterLinkResult)
  }
}
زمینه های
result

object ( MutateMerchantCenterLinkResult )

نتیجه برای جهش یافته

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

MerchantCenterLinkOperation

یک به‌روزرسانی واحد در پیوند Merchant Center.

نمایندگی 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" .

operation میدانی اتحادیه عملیات انجام operation تنها می تواند یکی از موارد زیر باشد:
update

object ( MerchantCenterLink )

عملیات به روز رسانی: انتظار می رود پیوند مرکز تجاری دارای یک نام منبع معتبر باشد.

remove

string

عملیات حذف: یک نام منبع برای پیوند مرکز تجاری حذف شده در این قالب انتظار می رود:

customers/{customerId}/merchantCenterLinks/{merchantCenterId}

MutateMerchantCenterLinkResult

نتیجه جهش پیوند Merchant Center.

نمایندگی JSON
{
  "resourceName": string
}
زمینه های
resourceName

string

برای عملیات موفقیت آمیز بازگشت.