Method: customers.suggestSmartCampaignAd

تقترح إعلانًا على حملة ذكية متوافقًا مع مجموعة مصادر الإعلانات، وذلك استنادًا إلى نقاط بيانات مثل الاستهداف والنشاط التجاري المراد الإعلان عنه.

طلب HTTP

POST https://googleads.googleapis.com/v15/customers/{customerId}:suggestSmartCampaignAd

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
customerId

string

مطلوبة. رقم تعريف العميل.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "suggestionInfo": {
    object (SmartCampaignSuggestionInfo)
  }
}
الحقول
suggestionInfo

object (SmartCampaignSuggestionInfo)

مطلوبة. الإدخالات المستخدَمة لاقتراح إعلان "حملة ذكية" الحقول المطلوبة: finalUrl وlanguageCode وkeywordThemes. حقول اختيارية ولكن يُنصح باستخدامها لتحسين جودة الاقتراح: business_setting وgeo_target.

نص الاستجابة

رسالة الرد على SmartCampaignSuggestService.SuggestSmartCampaignAd.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "adInfo": {
    object (SmartCampaignAdInfo)
  }
}
الحقول
adInfo

object (SmartCampaignAdInfo)

اختياريّ. تتضمّن معلومات الإعلان 3 عناوين لتصميمات الإعلانات ووصفَين للمواد الإبداعية.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.