Method: customers.recommendations.generate

यह सुझाव, अनुरोध किए गए सुझाव के टाइप के हिसाब से सुझाव जनरेट करता है.

इस्तेमाल की गई गड़बड़ियों की सूची: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RecommendationError RequestError

एचटीटीपी अनुरोध

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

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ के पैरामीटर

पैरामीटर
customerId

string

ज़रूरी है. सुझाव जनरेट करने वाले ग्राहक का आईडी.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:

जेएसओएन के काेड में दिखाना 
{
  "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_ कौशल_OPT_IN, MAXIMIZE_CHANGES_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, SITELINK_ASSET, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN
advertisingChannelType

enum (AdvertisingChannelType)

ज़रूरी है. कैंपेन के विज्ञापन चैनल का टाइप. नीचे दिए गए AdvertisingChannelTypes, सुझाव जनरेट करने के लिए काम करते हैं: PERFORMANCE_MAX और search
adGroupInfo[]

object (AdGroupInfo)

ज़रूरी नहीं. विज्ञापन ग्रुप की मौजूदा जानकारी. एक विज्ञापन समूह की जानकारी का समर्थन करता है. इस फ़ील्ड का इस्तेमाल, नीचे दिए गए सुझाव के टाइप के लिए नहीं किया जा सकता: KEYWORD
conversionTrackingStatus

enum (ConversionTrackingStatus)

ज़रूरी नहीं. कन्वर्ज़न ट्रैकिंग की मौजूदा स्थिति. यह फ़ील्ड इन सुझावों के टाइप के लिए ज़रूरी है: MAXIMIZE_KEYWORD_OPT_IN, MAXIMIZE_CHANGES_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_KEYWORD_OPT_IN, MAXIMIZE_CHANGES_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN
seedInfo

object (SeedInfo)

ज़रूरी नहीं. कीवर्ड के लिए सीड जानकारी. इन सुझावों के टाइप के लिए यह फ़ील्ड ज़रूरी है: KEYWORD

जवाब का मुख्य भाग

RecommendationService.GenerateRecommendations के लिए जवाब मैसेज.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

जेएसओएन के काेड में दिखाना 
{
  "recommendations": [
    {
      object (Recommendation)
    }
  ]
}
फ़ील्ड
recommendations[]

object (Recommendation)

अनुरोध किए गए सुझाव के सेट में से पास किए गए, जनरेट किए गए सुझावों की सूची. अगर अनुरोध किए गए सुझाव के टाइप के लिए सुझाव जनरेट करने के लिए ज़रूरी डेटा नहीं है, तो नतीजे के सेट में उस टाइप के लिए सुझाव नहीं होगा.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

BiddingInfo

कैंपेन की बिडिंग की मौजूदा जानकारी. सुझावों के बारे में जानकारी देने वाले बिडिंग से जुड़े सिग्नल के लिए रैपर देता है.

जेएसओएन के काेड में दिखाना 
{
  "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_KEYWORD_OPT_IN, MAXIMIZE_CHANGES_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)

माइक्रो में मौजूदा targetCpa. यह TARGET_CPA या MAXIMIZE_कन्वर्ज़न बोली लगाने की रणनीति प्रकार वाले कैंपेन के लिए भरा जा सकता है.
targetRoas

number

मौजूदा targetRoas. यह TARGET_ROAS या MAXIMIZE_CONVERSION_VALUE वाले बोली लगाने की रणनीति वाले कैंपेन के लिए भरा जा सकता है.

AdGroupInfo

कैंपेन के विज्ञापन ग्रुप की मौजूदा जानकारी.

जेएसओएन के काेड में दिखाना 
{
  "keywords": [
    {
      object (KeywordInfo)
    }
  ],
  "adGroupType": enum (AdGroupType)
}
फ़ील्ड
keywords[]

object (KeywordInfo)

ज़रूरी नहीं. वर्तमान कीवर्ड. अगर adGroupInfo को सेट किया गया हो, तो नीचे दिए गए सुझाव के प्रकारों के लिए यह फ़ील्ड ज़रूरी नहीं है: KEYWORD
adGroupType

enum (AdGroupType)

ज़रूरी नहीं. विज्ञापन ग्रुप का टाइप. अगर adGroupInfo को सेट किया गया हो, तो इन सुझावों के टाइप के लिए यह फ़ील्ड ज़रूरी है: KEYWORD

SeedInfo

कीवर्ड सीड और कीवर्ड जनरेट करने के लिए कोई खास यूआरएल.

जेएसओएन के काेड में दिखाना 
{
  "keywordSeeds": [
    string
  ],
  "urlSeed": string
}
फ़ील्ड
keywordSeeds[]

string

ज़रूरी नहीं. ऐसे कीवर्ड या वाक्यांश जिनसे आइडिया जनरेट करने हैं. उदाहरण के लिए: "मेरे आस-पास की कार डीलरशिप".
urlSeed

string

आइडिया जनरेट करने के लिए कोई खास यूआरएल, उदाहरण के लिए: www.example.com/cars.