Method: customers.customInterests.mutate

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

فهرست خطاهای پرتاب شده: AuthenticationError AuthorizationError CriterionError CustomInterestError HeaderError خطای داخلی MutateError PolicyViolationError QuotaError RequestError StringLengthError

درخواست HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}/customInterests:mutate

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

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

پارامترها
customer Id

string

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

درخواست بدن

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

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

object ( CustomInterestOperation )

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

validate Only

boolean

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

بدن پاسخگو

پیام پاسخ برای جهش علاقه سفارشی.

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

نمایندگی JSON 
{
  "results": [
    {
      object (MutateCustomInterestResult)
    }
  ]
}
فیلدها
results[]

object ( MutateCustomInterestResult )

همه نتایج برای جهش.

محدوده مجوز

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

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

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

CustomInterestOperation

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

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

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

string ( FieldMask format)

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

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

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

object ( CustomInterest )

ایجاد عملیات: هیچ نام منبعی برای علاقه سفارشی جدید انتظار نمی رود.

update

object ( CustomInterest )

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

MutateCustomInterest Result

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

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

string

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