Method: customers.accountLinks.mutate

پیوند حساب را ایجاد یا حذف می کند. از V5، ایجاد از طریق AccountLinkService.MutateAccountLink پشتیبانی نمی‌شود. به جای آن از AccountLinkService.CreateAccountLink استفاده کنید.

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

درخواست HTTP

POST https://googleads.googleapis.com/v19/customers/{customerId}/accountLinks:mutate

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

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

پارامترها
customerId

string

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

درخواست بدن

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

نمایندگی JSON 
{
  "operation": {
    object (AccountLinkOperation)
  },
  "partialFailure": boolean,
  "validateOnly": boolean
}
فیلدها
operation

object ( AccountLinkOperation )

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

partialFailure

boolean

اگر درست باشد، عملیات موفقیت آمیز انجام می شود و عملیات نامعتبر خطاها را برمی گرداند. اگر نادرست باشد، تمام عملیات در یک تراکنش انجام می‌شود، اگر و تنها در صورتی که همه آنها معتبر باشند. پیش فرض نادرست است.

validateOnly

boolean

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

بدن پاسخگو

پیام پاسخ برای تغییر پیوند حساب.

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

نمایندگی JSON 
{
  "result": {
    object (MutateAccountLinkResult)
  },
  "partialFailureError": {
    object (Status)
  }
}
فیلدها
result

object ( MutateAccountLinkResult )

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

partialFailureError

object ( Status )

خطاهایی که مربوط به خرابی عملیات در حالت شکست جزئی است. فقط زمانی که partialFailure = true باشد و تمام خطاها در داخل عملیات رخ دهد، برگردانده می شود. اگر هر گونه خطایی خارج از عملیات رخ دهد (مثلاً خطاهای تأیید اعتبار)، یک خطای سطح RPC را برمی گردانیم.

محدوده مجوز

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

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

AccountLinkOperation

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

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

  // Union field operation can be only one of the following:
  "update": {
    object (AccountLink)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
فیلدها
updateMask

string ( FieldMask format)

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

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

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

object ( AccountLink )

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

remove

string

عملیات حذف: یک نام منبع برای پیوند حساب برای حذف انتظار می رود، در این قالب:

customers/{customerId}/accountLinks/{accountLinkId}

MutateAccountLinkResult

نتیجه پیوند حساب تغییر می کند.

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

string

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