Method: customers.recommendations.generate

تُنشئ اقتراحات استنادًا إلى أنواع الاقتراحات المطلوبة.

قائمة بالأخطاء التي تمّ طرحها: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RecommendationError RequestError

طلب HTTP

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

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

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

المعلمات
customerId

string

مطلوب. رقم تعريف العميل الذي ينشئ الاقتراحات.

نص الطلب

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

تمثيل JSON 
{
  "recommendationTypes": [
    enum (RecommendationType)
  ],
  "advertisingChannelType": enum (AdvertisingChannelType),
  "adGroupInfo": [
    {
      object (AdGroupInfo)
    }
  ],
  "campaignSitelinkCount": integer,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "biddingInfo": {
    object (BiddingInfo)
  },
  "seedInfo": {
    object (SeedInfo)
  }
}
الحقول
recommendationTypes[]

enum (RecommendationType)

مطلوب. قائمة بأنواع الاقتراحات المؤهَّلة التي يمكن إنشاؤها. إذا لم تكن المعايير التي تمّ تحميلها كافية لتقديم اقتراح، أو إذا كانت الحملة في حالة "مُقترَحة"، لن يتمّ عرض أيّ اقتراح لهذا النوع. بشكل عام، يتم عرض اقتراح في حال تحميل جميع الحقول المطلوبة لنوع السمة هذا المقترَح، ولكن لا يزال هذا الإجراء غير كافٍ في بعض الحالات.

يمكن إنشاء الاقتراحات التالية باستخدام أنواع الاقتراحات: KEYWORD وMAXIMIZE_CLICKS_OPT_IN وMAXIMIZE_CONVERSIONS_OPT_IN وMAXIMIZE_CONVERSION_VALUE_OPT_IN وSET_TARGET_CPA وSET_TARGET_ROAS وSITELINK_ASSET وTARGET_CPA_OPT_IN وTARGET_ROAS_OPT_ININ.
advertisingChannelType

enum (AdvertisingChannelType)

مطلوب. نوع القناة الإعلانية للحملة. تتوفّر أنواع advertisingChannelTypes التالية لإنشاء الاقتراحات: PERFORMANCE_MAX وSEARCH.
adGroupInfo[]

object (AdGroupInfo)

اختياريّ. معلومات المجموعة الإعلانية الحالية. يتيح الحصول على معلومات من مجموعة إعلانية واحدة. هذا الحقل اختياري لأنواع الاقتراحات التالية: KEYWORD
conversionTrackingStatus

enum (ConversionTrackingStatus)

اختياريّ. حالة تتبُّع الإحالات الناجحة الحالية هذا الحقل ضروري لأنواع التوصيات التالية: MAXIMIZE_CLICKS_OPT_IN وMAXIMIZE_CONVERSIONS_OPT_IN وMAXIMIZE_CONVERSION_VALUE_OPT_IN وSET_TARGET_CPA وSET_TARGET_ROAS وTARGET_CPA_OPT_IN وTARGET_ROAS_OPT_IN
biddingInfo

object (BiddingInfo)

اختياريّ. معلومات عروض الأسعار الحالية للحملة هذا الحقل ضروري لأنواع الاقتراحات التالية: MAXIMIZE_CLICKS_OPT_IN وMAXIMIZE_CONVERSIONS_OPT_IN وMAXIMIZE_CONVERSION_VALUE_OPT_IN وSET_TARGET_CPA وSET_TARGET_ROAS وTARGET_CPA_OPT_IN وTARGET_ROAS_OPT_IN
seedInfo

object (SeedInfo)

اختياريّ. معلومات أولية للكلمات الرئيسية هذا الحقل ضروري لأنواع الاقتراحات التالية: الكلمة الرئيسية

نص الاستجابة

رسالة الردّ بشأن RecommendationService.GenerateRecommendations

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

تمثيل JSON 
{
  "recommendations": [
    {
      object (Recommendation)
    }
  ]
}
الحقول
recommendations[]

object (Recommendation)

قائمة بالاقتراحات التي تم إنشاؤها من مجموعة أنواع الاقتراحات المطلوبة التي تم تمريرها إذا لم تتوفّر بيانات كافية لإنشاء اقتراح لـ recommendationsTypes المطلوبة، لن تحتوي مجموعة النتائج على اقتراح لهذا النوع.

نطاقات الأذونات

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

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

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

BiddingInfo

معلومات عروض الأسعار الحالية للحملة. توفِّر برنامج تضمين للإشارات ذات الصلة بعروض الأسعار التي تساعد في توجيه الاقتراحات.

تمثيل JSON 
{
  "biddingStrategyType": enum (BiddingStrategyType),

  // Union field bidding_strategy_target_info can be only one of the following:
  "targetCpaMicros": string,
  "targetRoas": number
  // End of list of possible types for union field bidding_strategy_target_info.
}
الحقول
biddingStrategyType

enum (BiddingStrategyType)

استراتيجية عروض الأسعار الحالية. هذا الحقل ضروري لأنواع التوصيات التالية: MAXIMIZE_CLICKS_OPT_IN وMAXIMIZE_CONVERSIONS_OPT_IN وMAXIMIZE_CONVERSION_VALUE_OPT_IN وSET_TARGET_CPA وSET_TARGET_ROAS وTARGET_CPA_OPT_IN وTARGET_ROAS_OPT_IN
حقل الربط bidding_strategy_target_info تفاصيل اختيارية مرتبطة بـ Bidding_strategy_type. يمكن أن يكون bidding_strategy_target_info واحدًا فقط مما يلي:
targetCpaMicros

string (int64 format)

التكلفة المستهدَفة الحالية للإجراء بالمايكرو يمكن تعبئة هذا الحقل للحملات التي يكون نوع استراتيجية عروض الأسعار فيها TARGET_CPA أو MAXIMIZE_CONVERSIONS.
targetRoas

number

عائد النفقات الإعلانية المستهدف الحالي يمكن تعبئة هذا الحقل للحملات التي يكون نوع استراتيجية عروض أسعارها TARGET_ROAS أو MAXIMIZE_CONVERSION_VALUE.

AdGroupInfo

معلومات المجموعة الإعلانية الحالية للحملة.

تمثيل JSON 
{
  "keywords": [
    {
      object (KeywordInfo)
    }
  ],
  "adGroupType": enum (AdGroupType)
}
الحقول
keywords[]

object (KeywordInfo)

اختياريّ. الكلمات الرئيسية الحالية هذا الحقل اختياري لأنواع التوصيات التالية في حالة تعيين معلومات المجموعة الإعلانية: KEYWORD
adGroupType

enum (AdGroupType)

اختياريّ. نوع المجموعة الإعلانية للمجموعة الإعلانية. هذا الحقل ضروري لأنواع الاقتراحات التالية في حال ضبط adGroupInfo: KEYWORD

SeedInfo

كلمة رئيسية أساسية وعنوان URL محدد لإنشاء كلمات رئيسية منها.

تمثيل JSON 
{
  "keywordSeeds": [
    string
  ],
  "urlSeed": string
}
الحقول
keywordSeeds[]

string

اختياريّ. الكلمات الرئيسية أو العبارات التي يمكن إنشاء أفكار منها، مثل: السيارات أو "تاجر سيارات بالقرب مني"
urlSeed

string

عنوان URL محدد لإنشاء الأفكار منه، على سبيل المثال: www.example.com/cars.