Method: customers.accountBudgetProposals.mutate

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

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

בקשת HTTP

POST https://googleads.googleapis.com/v14/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

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