Method: customers.keywordPlanAdGroups.mutate

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

فهرست خطاهای پرتاب شده: AuthenticationError AuthorizationError DatabaseError FieldError FieldMaskError HeaderError داخلی خطای کلید واژهPlanAdGroupError کلید واژه PlanError MutateError NewResourceCreationError QuotaError RequestError ResourceCountLimitExceededError

درخواست HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}/keywordPlanAdGroups:mutate

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

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

مولفه های
customerId

string

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

درخواست بدن

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

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

object ( KeywordPlanAdGroupOperation )

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

partialFailure

boolean

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

validateOnly

boolean

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

بدن پاسخگو

پیام پاسخ برای جهش گروه تبلیغاتی طرح کلمه کلیدی.

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

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

object ( Status )

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

results[]

object ( MutateKeywordPlanAdGroupResult )

همه نتایج برای جهش. ترتیب نتایج بر اساس ترتیب کلمات کلیدی در درخواست اصلی تعیین می شود.

محدوده مجوز

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

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

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