Method: customers.suggestSmartCampaignBudgetOptions

הפונקציה מחזירה הצעות של אפשרות תקציב.

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
customerId

string

חובה. המזהה של הלקוח שברצונך להציע לו את אפשרויות התקציב.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON
{

  // Union field suggestion_data can be only one of the following:
  "campaign": string,
  "suggestionInfo": {
    object (SmartCampaignSuggestionInfo)
  }
  // End of list of possible types for union field suggestion_data.
}
שדות
שדה איחוד suggestion_data. חובה. כשיוצרים קמפיין בפעם הראשונה, משתמשים ב-SuggestionInfo, כדי לקבל עדכונים נוספים על BudgetOptions שמבוססים על קמפיין שכבר נוצר, משתמשים באותו קמפיין. suggestion_data יכול להיות רק אחד מהבאים:
campaign

string

חובה. שם המשאב של הקמפיין שלגביו יש לקבל הצעה.

suggestionInfo

object (SmartCampaignSuggestionInfo)

חובה. המידע הדרוש כדי לקבל אפשרויות תקציב

גוף התשובה

הודעת תשובה לגבי SmartCampaignSuggestService.SuggestSmartCampaignBudgetOptions. בהתאם למידת היכולת של המערכת להציע את האפשרויות, ייתכן שכל האפשרויות או אף אחת מהן לא יוחזרו.

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

ייצוג JSON
{
  "low": {
    object (BudgetOption)
  },
  "recommended": {
    object (BudgetOption)
  },
  "high": {
    object (BudgetOption)
  }
}
שדות
low

object (BudgetOption)

אפשרות. אפשרות התקציב הנמוכה ביותר.

recommended

object (BudgetOption)

אפשרות. אפשרות התקציב המומלצת.

high

object (BudgetOption)

אפשרות. אפשרות התקציב הגבוהה ביותר.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/adwords

למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.

BudgetOption

אפשרות לתקציב של קמפיין חכם.

ייצוג JSON
{
  "dailyAmountMicros": string,
  "metrics": {
    object (Metrics)
  }
}
שדות
dailyAmountMicros

string (int64 format)

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

metrics

object (Metrics)

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

מדדים

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

ייצוג JSON
{
  "minDailyClicks": string,
  "maxDailyClicks": string
}
שדות
minDailyClicks

string (int64 format)

אומדן של מספר הקליקים היומי המשוער.

maxDailyClicks

string (int64 format)

אומדן של מספר הקליקים היומי המקסימלי.