- בקשת HTTP
- פרמטרים של נתיב
- גוף הבקשה
- גוף התשובה
- היקפי הרשאות
- AccountBudgetProposalOperation
- MutateAccountBudgetProposalResult
- רוצים לנסות?
יצירה, עדכון או הסרה של הצעות לתקציב החשבון. הסטטוסים של הפעולות מוחזרים.
רשימה של שגיאות התרעה: AccountBudgetProposalError AuthenticationError AuthorizationError DatabaseError DateError FieldError FieldMaskError HeaderError InternalError MutateError QuotaError שגיאהשגיאהQuotaErrorRequestErrorStringLengthError
בקשת HTTP
POST https://googleads.googleapis.com/v15/customers/{customerId}/accountBudgetProposals:mutate
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
customerId |
חובה. מספר הלקוח. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"operation": {
object ( |
שדות | |
---|---|
operation |
חובה. הפעולה שצריך לבצע בהצעת תקציב ברמת החשבון הפרטי. |
validateOnly |
אם הערך הוא true, הבקשה מאומתת אבל לא מבוצעת. רק שגיאות מוחזרות, לא תוצאות. |
גוף התגובה
הודעת תגובה לפעולות של שינוי תקציב ברמת החשבון.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג 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 |
הוחזר בגלל פעולות שבוצעו בהצלחה. |