- درخواست HTTP
- پارامترهای مسیر
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- AccountBudgetProposalOperation
- MutateAccountBudgetProposalResult
- آن را امتحان کنید!
پیشنهادهای بودجه حساب را ایجاد، بهروزرسانی یا حذف میکند. وضعیت عملیات برگردانده می شود.
فهرست خطاهای پرتاب شده: AccountBudgetProposalError AuthenticationError AuthorizationError DatabaseError DateError FieldError FieldMaskError HeaderError داخلی Error MutateError QuotaError RequestError StringLengthError
POST https://googleads.googleapis.com/v15/customers/{customerId}/accountBudgetProposals:mutate
URL از دستور GRPC Transcoding استفاده می کند.
مولفه های | |
---|---|
customerId | ضروری. شناسه مشتری. |
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"operation": {
object ( |
زمینه های | |
---|---|
operation | ضروری. عملیاتی که باید براساس پیشنهاد بودجه در سطح حساب فردی انجام شود. |
validateOnly | اگر درست باشد، درخواست تایید می شود اما اجرا نمی شود. فقط خطاها برگردانده می شوند، نه نتایج. |
پیام پاسخ برای عملیات جهش بودجه در سطح حساب.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"result": {
object ( |
زمینه های | |
---|---|
result | نتیجه جهش. |
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/adwords
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
یک عملیات واحد برای پیشنهاد ایجاد یک بودجه جدید در سطح حساب یا ویرایش/پایان/حذف بودجه موجود.
نمایندگی JSON |
---|
{ "updateMask": string, // Union field |
زمینه های | |
---|---|
updateMask | FieldMask که تعیین می کند کدام فیلدهای بودجه اصلاح می شوند. در حالی که بودجه ممکن است اصلاح شود، پیشنهادهایی که چنین اصلاحاتی را پیشنهاد می کنند نهایی هستند. بنابراین، عملیات به روز رسانی برای پیشنهادات پشتیبانی نمی شود. پیشنهادهایی که بودجه را اصلاح میکنند، نوع پیشنهاد «بهروزرسانی» دارند. تعیین ماسک برای هر نوع پیشنهاد دیگری یک خطا در نظر گرفته می شود. این فهرستی از نامهای فیلدهای کاملاً واجد شرایط با کاما است. مثال: |
operation میدانی اتحادیه عملیات جهش. operation می تواند تنها یکی از موارد زیر باشد: | |
create | ایجاد عملیات: یک پیشنهاد جدید برای ایجاد یک بودجه جدید، ویرایش یک بودجه موجود، پایان دادن به یک بودجه فعال یا حذف یک بودجه تایید شده برای شروع در آینده. هیچ نام منبعی برای پیشنهاد جدید انتظار نمی رود. |
remove | عملیات حذف: یک نام منبع برای پیشنهاد حذف شده در این قالب انتظار می رود: |
نتیجه پیشنهاد بودجه حساب تغییر می کند.
نمایندگی JSON |
---|
{ "resourceName": string } |
زمینه های | |
---|---|
resourceName | برای عملیات موفقیت آمیز بازگشت. |