Method: customers.assetGroups.mutate

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

درخواست HTTP

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

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

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

مولفه های
customerId

string

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

درخواست بدن

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

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

object ( AssetGroupOperation )

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

validateOnly

boolean

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

بدن پاسخگو

پیام پاسخ برای جهش گروه دارایی.

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

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

object ( MutateAssetGroupResult )

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

partialFailureError

object ( Status )

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

محدوده مجوز

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

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

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