گروههای دارایی را ایجاد، بهروزرسانی یا حذف میکند. وضعیت عملیات برگردانده می شود.
درخواست HTTP
POST https://googleads.googleapis.com/v17/customers/{customerId}/assetGroups:mutate
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های | |
---|---|
customerId | ضروری. شناسه مشتری که گروه های دارایی او در حال تغییر هستند. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"operations": [
{
object ( |
زمینه های | |
---|---|
operations[] | ضروری. فهرست عملیاتی که باید روی گروههای دارایی منفرد انجام شود. |
validateOnly | اگر درست باشد، درخواست تایید می شود اما اجرا نمی شود. فقط خطاها برگردانده می شوند، نه نتایج. |
بدن پاسخگو
پیام پاسخ برای جهش گروه دارایی.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "results": [ { object ( |
زمینه های | |
---|---|
results[] | همه نتایج برای جهش. |
partialFailureError | خطاهایی که مربوط به خرابی عملیات در حالت شکست جزئی است. فقط زمانی که partialFailure = true باشد و تمام خطاها در داخل عملیات رخ دهد، برگردانده می شود. اگر هر گونه خطایی خارج از عملیات رخ دهد (مثلاً خطاهای تأیید اعتبار)، یک خطای سطح RPC را برمی گردانیم. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/adwords
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.