- درخواست HTTP
- پارامترهای مسیر
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- AccountBudgetProposalOperation
- MutateAccountBudgetProposalResult
- آن را امتحان کنید!
پیشنهادهای بودجه حساب را ایجاد، بهروزرسانی یا حذف میکند. وضعیت عملیات برگردانده می شود.
فهرست خطاهای پرتاب شده: AccountBudgetProposalError AuthenticationError AuthorizationError DatabaseError DateError FieldError FieldMaskError HeaderError داخلی Error MutateError QuotaError RequestError StringLengthError
درخواست HTTP
POST https://googleads.googleapis.com/v17/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 مراجعه کنید.
AccountBudgetProposalOperation
یک عملیات واحد برای پیشنهاد ایجاد یک بودجه جدید در سطح حساب یا ویرایش/پایان/حذف بودجه موجود.
نمایندگی JSON |
---|
{ "updateMask": string, // Union field |
فیلدها | |
---|---|
updateMask | FieldMask که تعیین می کند کدام فیلدهای بودجه اصلاح می شوند. در حالی که بودجه ممکن است اصلاح شود، پیشنهادهایی که چنین اصلاحاتی را پیشنهاد می کنند نهایی هستند. بنابراین، عملیات به روز رسانی برای پیشنهادات پشتیبانی نمی شود. پیشنهادهایی که بودجه را اصلاح میکنند، نوع پیشنهاد «بهروزرسانی» دارند. تعیین ماسک برای هر نوع پیشنهاد دیگری یک خطا در نظر گرفته می شود. این فهرستی از نامهای فیلدهای کاملاً واجد شرایط با کاما است. مثال: |
operation میدانی اتحادیه عملیات جهش. operation می تواند تنها یکی از موارد زیر باشد: | |
create | ایجاد عملیات: یک پیشنهاد جدید برای ایجاد یک بودجه جدید، ویرایش یک بودجه موجود، پایان دادن به یک بودجه فعال یا حذف یک بودجه تایید شده برای شروع در آینده. هیچ نام منبعی برای پیشنهاد جدید انتظار نمی رود. |
remove | عملیات حذف: یک نام منبع برای پیشنهاد حذف شده در این قالب انتظار می رود: |
MutateAccountBudgetProposalResult
نتیجه پیشنهاد بودجه حساب تغییر می کند.
نمایندگی JSON |
---|
{ "resourceName": string } |
فیلدها | |
---|---|
resourceName | برای عملیات موفقیت آمیز بازگشت. |