Method: customers.accountBudgetProposals.mutate

يُنشئ اقتراحات ميزانية الحساب أو يعدّلها أو يزيلها. يتم عرض حالات العمليات.

قائمة بالأخطاء المعروضة: AccountBudgetProposalError AuthenticationError AuthorizationError DatabaseError DateError FieldError FieldMaskError HeaderError InternalError MutateError QuotaError DataError RequestErrorStringLengthError

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز gRPC.

معلمات المسار

المَعلمات
customerId

string

مطلوبة. رقم تعريف العميل.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "operation": {
    object (AccountBudgetProposalOperation)
  },
  "validateOnly": boolean
}
الحقول
operation

object (AccountBudgetProposalOperation)

مطلوبة. العملية التي يتم تنفيذها على اقتراح ميزانية فردي على مستوى الحساب.
validateOnly

boolean

إذا كانت الإجابة "صحيح"، يتم التحقّق من صحة الطلب ولكن لا يتم تنفيذه. يتم عرض الأخطاء فقط وليس النتائج.

نص الاستجابة

رسالة استجابة لعمليات تغيير الميزانية على مستوى الحساب

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "result": {
    object (MutateAccountBudgetProposalResult)
  }
}
الحقول
result

object (MutateAccountBudgetProposalResult)

نتيجة دالة mutate.

نطاقات التفويض

يجب توفير نطاق 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)

قناع الحقل الذي يحدِّد حقول الميزانية التي يتم تعديلها. بينما يمكن تعديل الميزانيات، تعد المقترحات التي تقترح مثل هذه التعديلات نهائية. لذلك، لا تتوفر عمليات التحديث للمقترحات.

تحتوي الاقتراحات التي تعدِّل الميزانيات من نوع العرض "تعديل". يُعد تحديد قناع لأي نوع عرض آخر بمثابة خطأ.

هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: "user.displayName,photo"
حقل الاتحاد operation عملية التبديل. يمكن أن يكون الحقل "operation" واحدًا فقط مما يلي:
create

object (AccountBudgetProposal)

إنشاء عملية: اقتراح جديد لإنشاء ميزانية جديدة أو تعديل ميزانية حالية أو إنهاء ميزانية قيد التنفيذ أو إزالة ميزانية معتمدة للبدء في المستقبل. ليس من المتوقع وجود اسم مورد للاقتراح الجديد.
remove

string

عملية الإزالة: يُتوقَّع اسم مورد للاقتراح الذي تمت إزالته، بالتنسيق التالي:

customers/{customerId}/accountBudgetProposals/{account_budget_proposal_id} قد يتم إلغاء الطلب إذا كان في انتظار المراجعة.

MutateAccountBudgetProposalResult

تغيير نتيجة اقتراح ميزانية الحساب.

تمثيل JSON 
{
  "resourceName": string
}
الحقول
resourceName

string

تم إرجاعها لإجراء عمليات ناجحة.