Method: customers.customerManagerLinks.mutate

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

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

درخواست HTTP

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

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

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

مولفه های
customerId

string

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

درخواست بدن

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

نمایندگی JSON
{
  "operations": [
    {
      object (CustomerManagerLinkOperation)
    }
  ],
  "validateOnly": boolean
}
زمینه های
operations[]

object ( CustomerManagerLinkOperation )

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

validateOnly

boolean

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

بدن پاسخگو

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

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

نمایندگی JSON
{
  "results": [
    {
      object (MutateCustomerManagerLinkResult)
    }
  ]
}
زمینه های
results[]

object ( MutateCustomerManagerLinkResult )

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

محدوده مجوز

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

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

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

CustomerManagerLinkOperation

وضعیت CustomerManagerLink را به روز می کند. اقدامات زیر ممکن است: 1. عملیات به روز رسانی با وضعیت ACTIVE یک دعوت در انتظار را می پذیرد. 2. عملیات به روز رسانی با وضعیت رد شده، دعوت معلق را رد می کند. 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

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