Method: customers.customAudiences.mutate

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

فهرست خطاهای پرتاب شده: AuthenticationError AuthorizationError CustomAudienceError CustomInterestError FieldError FieldMaskError HeaderError داخلی خطا تغییر خطا عملیات دسترسی رد خط مشیخطا خطا QuotaError RequestError

درخواست HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}/customAudiences:mutate

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

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

مولفه های
customerId

string

ضروری. شناسه مشتری که مخاطبان سفارشی او در حال تغییر هستند.

درخواست بدن

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

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

object ( CustomAudienceOperation )

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

validateOnly

boolean

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

بدن پاسخگو

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

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

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

object ( MutateCustomAudienceResult )

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

محدوده مجوز

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

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

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

CustomAudienceOperation

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

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

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

string ( FieldMask format)

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

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

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

object ( CustomAudience )

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

update

object ( CustomAudience )

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

remove

string

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

customers/{customerId}/customAudiences/{custom_audience_id}

MutateCustomAudienceResult

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

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

string

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