Method: customers.customInterests.mutate

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

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

درخواست HTTP

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

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

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

مولفه های
customerId

string

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

درخواست بدن

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

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

object ( CustomInterestOperation )

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

validateOnly

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.
}
زمینه های
updateMask

string ( FieldMask format)

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

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

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

object ( CustomInterest )

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

update

object ( CustomInterest )

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

MutateCustomInterestResult

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

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

string

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