Method: customers.suggestSmartCampaignBudgetOptions

تؤدي إلى عرض اقتراحات BudgetOption.

طلب HTTP

POST https://googleads.googleapis.com/v15/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 مطلوبة. لأول مرة لإنشاء حملة، استخدم UseInfo، وعند إجراء تعديلات لاحقة على خيار الميزانية استنادًا إلى حملة تم إنشاؤها مسبقًا، استخدم هذه الحملة. يمكن أن تكون السمة "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)

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