Method: customers.adGroupAssetSets.mutate

مجموعه‌های دارایی گروه تبلیغات را ایجاد یا حذف می‌کند. وضعیت عملیات برگردانده می شود.

درخواست HTTP

POST https://googleads.googleapis.com/v17/customers/{customerId}/adGroupAssetSets:mutate

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

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

پارامترها
customer Id

string

مورد نیاز. شناسه مشتری که مجموعه‌های دارایی گروه تبلیغات او در حال تغییر است.

درخواست بدن

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

نمایندگی JSON 
{
  "operations": [
    {
      object (AdGroupAssetSetOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "responseContentType": enum (ResponseContentType)
}
فیلدها
operations[]

object ( AdGroupAssetSetOperation )

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

partial Failure

boolean

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

validate Only

boolean

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

response Content Type

enum ( ResponseContentType )

تنظیم نوع محتوای پاسخ. تعیین می کند که آیا منبع قابل تغییر یا فقط نام منبع باید به پست جهش برگردانده شود.

بدن پاسخگو

پیام پاسخ برای یک مجموعه دارایی گروه تبلیغاتی تغییر می کند.

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

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

object ( MutateAdGroupAssetSetResult )

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

partial Failure Error

object ( Status )

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

محدوده مجوز

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

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

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

AdGroupAssetSetOperation

یک عملیات واحد (ایجاد، حذف) روی مجموعه دارایی گروه تبلیغات.

نمایندگی JSON 
{

  // Union field operation can be only one of the following:
  "create": {
    object (AdGroupAssetSet)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
فیلدها
operation میدانی اتحادیه عملیات جهش. operation می تواند تنها یکی از موارد زیر باشد:
create

object ( AdGroupAssetSet )

ایجاد عملیات: هیچ نام منبعی برای مجموعه دارایی گروه تبلیغات جدید انتظار نمی رود.

remove

string

عملیات حذف: یک نام منبع برای مجموعه دارایی گروه تبلیغات حذف شده انتظار می رود، در این قالب: customers/{customerId}/adGroupAssetSets/{adGroupId}~{asset_set_id}

MutateAdGroupAssetSetResult

نتیجه مجموعه دارایی گروه آگهی تغییر می کند.

نمایندگی JSON 
{
  "resourceName": string,
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  }
}
فیلدها
resource Name

string

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

ad Group Asset Set

object ( AdGroupAssetSet )

دارایی گروه آگهی جهش یافته با تنها فیلدهای قابل تغییر پس از جهش مجموعه. این فیلد فقط زمانی برگردانده می شود که answerContentType روی "MUTABLE_RESOURCE" تنظیم شود.