Method: customers.customerClientLinks.mutate

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

لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError DatabaseError FieldError FieldMaskError HeaderError داخلیError ManagerLinkError MutateError NewResourceCreationError QuotaError RequestError

درخواست HTTP

POST https://googleads.googleapis.com/v15/customers/{customerId}/customerClientLinks:mutate

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

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

مولفه های
customerId

string

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

درخواست بدن

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

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

object ( CustomerClientLinkOperation )

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

validateOnly

boolean

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

بدن پاسخگو

پیام پاسخ برای جهش CustomerClientLink.

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

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

object ( MutateCustomerClientLinkResult )

نتیجه ای که منبع تحت تاثیر درخواست جهش را شناسایی می کند.

محدوده مجوز

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

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

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

CustomerClientLinkOperation

یک عملیات واحد (ایجاد، به روز رسانی) در CustomerClientLink.

نمایندگی JSON
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "create": {
    object (CustomerClientLink)
  },
  "update": {
    object (CustomerClientLink)
  }
  // End of list of possible types for union field operation.
}
زمینه های
updateMask

string ( FieldMask format)

FieldMask که تعیین می کند کدام فیلدهای منبع در یک به روز رسانی اصلاح می شوند.

این فهرستی از نام‌های فیلدهای کاملاً واجد شرایط با کاما است. مثال: "user.displayName,photo" .

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

object ( CustomerClientLink )

ایجاد عملیات: هیچ نام منبعی برای پیوند جدید انتظار نمی رود.

update

object ( CustomerClientLink )

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

MutateCustomerClientLinkResult

نتیجه جهش پیوند مشتری تک مشتری.

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

string

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