Method: customers.accountBudgetProposals.mutate

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

فهرست خطاهای پرتاب شده: AccountBudgetProposalError AuthenticationError AuthorizationError DatabaseError DateError FieldError FieldMaskError HeaderError داخلی Error MutateError QuotaError RequestError StringLengthError

درخواست HTTP

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

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

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

مولفه های
customerId

string

ضروری. شناسه مشتری.

درخواست بدن

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

نمایندگی JSON
{
  "operation": {
    object (AccountBudgetProposalOperation)
  },
  "validateOnly": boolean
}
زمینه های
operation

object ( AccountBudgetProposalOperation )

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

validateOnly

boolean

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

بدن پاسخگو

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

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

نمایندگی JSON
{
  "result": {
    object (MutateAccountBudgetProposalResult)
  }
}
زمینه های
result

object ( MutateAccountBudgetProposalResult )

نتیجه جهش.

محدوده مجوز

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

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

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

AccountBudgetProposalOperation

یک عملیات واحد برای پیشنهاد ایجاد یک بودجه جدید در سطح حساب یا ویرایش/پایان/حذف بودجه موجود.

نمایندگی JSON
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "create": {
    object (AccountBudgetProposal)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
زمینه های
updateMask

string ( FieldMask format)

FieldMask که تعیین می کند کدام فیلدهای بودجه اصلاح می شوند. در حالی که بودجه ممکن است اصلاح شود، پیشنهادهایی که چنین اصلاحاتی را پیشنهاد می کنند نهایی هستند. بنابراین، عملیات به روز رسانی برای پیشنهادات پشتیبانی نمی شود.

پیشنهادهایی که بودجه را اصلاح می‌کنند، نوع پیشنهاد «به‌روزرسانی» دارند. تعیین ماسک برای هر نوع پیشنهاد دیگری یک خطا در نظر گرفته می شود.

این فهرستی از نام‌های فیلدهای کاملاً واجد شرایط با کاما است. مثال: "user.displayName,photo" .

operation میدانی اتحادیه عملیات جهش. operation می تواند تنها یکی از موارد زیر باشد:
create

object ( AccountBudgetProposal )

ایجاد عملیات: یک پیشنهاد جدید برای ایجاد یک بودجه جدید، ویرایش یک بودجه موجود، پایان دادن به یک بودجه فعال یا حذف یک بودجه تایید شده برای شروع در آینده. هیچ نام منبعی برای پیشنهاد جدید انتظار نمی رود.

remove

string

عملیات حذف: یک نام منبع برای پیشنهاد حذف شده در این قالب انتظار می رود:

customers/{customerId}/accountBudgetProposals/{account_budget_proposal_id} در صورتی که درخواستی معلق باشد، ممکن است لغو شود.

MutateAccountBudgetProposalResult

نتیجه پیشنهاد بودجه حساب تغییر می کند.

نمایندگی JSON
{
  "resourceName": string
}
زمینه های
resourceName

string

برای عملیات موفقیت آمیز بازگشت.