Method: customers.suggestSmartCampaignBudgetOptions

تعرِض اقتراحات BudgetOption.

طلب HTTP

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

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)

الحد الأقصى المقدَّر للنقرات اليومية.