- درخواست HTTP
- پارامترهای مسیر
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- CustomerAssetSetOperation
- MutateCustomerAssetSetResult
- آن را امتحان کنید!
مجموعههای دارایی مشتری را ایجاد یا حذف میکند. وضعیت عملیات برگردانده می شود.
درخواست HTTP
POST https://googleads.googleapis.com/v17/customers/{customerId}/customerAssetSets:mutate
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های | |
---|---|
customerId | ضروری. شناسه مشتری که مجموعه دارایی های مشتری او در حال تغییر است. |
درخواست بدن
بدنه درخواست شامل داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "operations": [ { object ( |
زمینه های | |
---|---|
operations[] | ضروری. فهرست عملیاتی که باید روی مجموعههای دارایی مشتری منفرد انجام شود. |
partialFailure | اگر درست باشد، عملیات موفقیت آمیز انجام می شود و عملیات نامعتبر خطاها را برمی گرداند. اگر نادرست باشد، همه عملیات در یک تراکنش انجام میشود، اگر و تنها در صورتی که همه آنها معتبر باشند. پیش فرض نادرست است. |
validateOnly | اگر درست باشد، درخواست تایید می شود اما اجرا نمی شود. فقط خطاها برگردانده می شوند، نه نتایج. |
responseContentType | تنظیم نوع محتوای پاسخ. تعیین می کند که آیا منبع قابل تغییر یا فقط نام منبع باید به پست جهش برگردانده شود. |
بدن پاسخگو
پیام پاسخ برای جهش مجموعه دارایی مشتری.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "results": [ { object ( |
زمینه های | |
---|---|
results[] | همه نتایج برای جهش. |
partialFailureError | خطاهایی که مربوط به خرابی عملیات در حالت شکست جزئی است. فقط زمانی که partialFailure = true و تمام خطاها در داخل عملیات رخ می دهد، برگردانده می شود. اگر هر گونه خطایی در خارج از عملیات رخ دهد (مثلاً خطاهای تأیید اعتبار)، یک خطای سطح RPC را برمی گردانیم. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/adwords
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
CustomerAssetSetOperation
یک عملیات واحد (ایجاد، حذف) روی مجموعه دارایی مشتری.
نمایندگی JSON |
---|
{ // Union field |
زمینه های | |
---|---|
operation میدانی اتحادیه عملیات جهش. operation می تواند تنها یکی از موارد زیر باشد: | |
create | ایجاد عملیات: هیچ نام منبعی برای مجموعه دارایی مشتری جدید انتظار نمی رود. |
remove | عملیات حذف: یک نام منبع برای مجموعه دارایی مشتری حذف شده انتظار می رود، در این قالب: |
MutateCustomerAssetSetResult
نتیجه برای مجموعه دارایی مشتری تغییر می کند.
نمایندگی JSON |
---|
{
"resourceName": string,
"customerAssetSet": {
object ( |
زمینه های | |
---|---|
resourceName | برای عملیات موفقیت آمیز بازگشت. |
customerAssetSet | مجموعه دارایی مشتری جهش یافته با تنها فیلدهای قابل تغییر پس از جهش. این فیلد تنها زمانی برگردانده میشود که answerContentType روی "MUTABLE_RESOURCE" تنظیم شود. |