Method: customers.accountBudgetProposals.mutate

יצירה, עדכון או הסרה של הצעות לתקציב חשבון. הסטטוסים של הפעולות מוחזרים.

רשימת שגיאות שקרו: AccountBudgetProposalError AuthenticationError AuthorizationError DatabaseError DateError FieldError FieldMaskError HeaderError InternalError MutateError שגיאהשגיאהQuotaErrorRequestErrorStringLengthError

בקשת 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

אם הערך הוא True, הבקשה מאומתת אבל לא מבוצעת. רק שגיאות מוחזרות, לא תוצאות.

גוף התשובה

הודעת תגובה לפעולות של שינויים בתקציב ברמת החשבון.

אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:

ייצוג 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

מוחזר עבור פעולות שבוצעו בהצלחה.