گروه های تبلیغاتی را ایجاد، به روز رسانی یا حذف می کند. وضعیت عملیات برگردانده می شود.
لیست خطاهای پرتاب شده: AdGroupError AdxError AuthenticationError AuthorizationError BiddingError BiddingStrategyError DatabaseError DateError DistinctError FieldError FieldMaskError HeaderError IdError داخلی خطای فهرست عملیات خطای خطا MultiplierError MultiplierErrorOperationError MultiplierError NotError MutateCoreErrorNewErrorDateErrorErrorDateError torError QuotaError RangeError RequestError ResourceCountLimitExceededError SettingError SizeLimitError StringFormatError StringLengthError UrlFieldError
درخواست HTTP
POST https://googleads.googleapis.com/v16/customers/{customerId}/adGroups:mutate
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های | |
---|---|
customerId | ضروری. شناسه مشتری که گروه های تبلیغاتی او در حال تغییر هستند. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "operations": [ { object ( |
زمینه های | |
---|---|
operations[] | ضروری. فهرست عملیاتی که باید روی گروههای تبلیغاتی انجام شود. |
partialFailure | اگر درست باشد، عملیات موفقیت آمیز انجام می شود و عملیات نامعتبر خطاها را برمی گرداند. اگر نادرست باشد، تمام عملیات در یک تراکنش انجام میشود، اگر و تنها در صورتی که همه آنها معتبر باشند. پیش فرض نادرست است. |
validateOnly | اگر درست باشد، درخواست تایید می شود اما اجرا نمی شود. فقط خطاها برمی گردند، نه نتایج. |
responseContentType | تنظیم نوع محتوای پاسخ. تعیین می کند که آیا منبع قابل تغییر یا فقط نام منبع باید به پست جهش برگردانده شود. |
بدن پاسخگو
پیام پاسخ برای جهش گروه تبلیغاتی.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "partialFailureError": { object ( |
زمینه های | |
---|---|
partialFailureError | خطاهایی که مربوط به خرابی عملیات در حالت شکست جزئی است. فقط زمانی که partialFailure = true باشد و تمام خطاها در داخل عملیات رخ دهد، برگردانده می شود. اگر هر گونه خطایی خارج از عملیات رخ دهد (مثلاً خطاهای تأیید اعتبار)، یک خطای سطح RPC را برمی گردانیم. |
results[] | همه نتایج برای جهش. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/adwords
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.