- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- BiddingInfo
- AdGroupInfo
- SeedInfo
- इसे आज़माएं!
अनुरोध किए गए सिफारिश टाइप के आधार पर सुझाव जनरेट करता है.
दिखने वाली गड़बड़ियों की सूची: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RecommendationError RequestError
एचटीटीपी अनुरोध
POST https://googleads.googleapis.com/v16/customers/{customerId}/recommendations:generate
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ पैरामीटर
पैरामीटर | |
---|---|
customer |
ज़रूरी है. सुझाव जनरेट करने वाले ग्राहक का आईडी. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, यहां दिए गए स्ट्रक्चर का डेटा शामिल होता है:
JSON के काेड में दिखाना |
---|
{ "recommendationTypes": [ enum ( |
फ़ील्ड | |
---|---|
recommendation |
ज़रूरी है. जनरेट करने के लिए, ज़रूरी शर्तें पूरी करने वाले recommendationTypes की सूची. अगर अपलोड किया गया मानदंड, सुझाव देने के लिए काफ़ी नहीं है या कैंपेन पहले से ही सुझाई गई स्थिति में है, तो उस टाइप के लिए कोई सुझाव नहीं दिया जाएगा. आम तौर पर, सुझाव के तौर पर उस टाइप के लिए सभी ज़रूरी फ़ील्ड अपलोड किए जाने पर सुझाव दिखाया जाता है. हालांकि, कुछ मामलों में यह जानकारी काफ़ी नहीं होती. ये सुझाव टाइप काम करते हैं: 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_IN |
advertising |
ज़रूरी है. कैंपेन का विज्ञापन चैनल टाइप. सुझाव जनरेट करने के लिए, ये advertisingChannelTypes काम करते हैं: PERFORMANCE_MAX और SEARCH |
ad |
ज़रूरी नहीं. मौजूदा विज्ञापन ग्रुप की जानकारी. यह किसी एक AdGroup की जानकारी के साथ काम करता है. यह फ़ील्ड, इन recommendationTypes के लिए ज़रूरी नहीं है: कीवर्ड |
campaign |
ज़रूरी नहीं. कैंपेन में साइटलिंक की संख्या. यह फ़ील्ड, इन recommendationTypes के लिए ज़रूरी है: SITELINK_ASSET |
conversion |
ज़रूरी नहीं. कन्वर्ज़न ट्रैकिंग की मौजूदा स्थिति. यह फ़ील्ड, इन recommendationTypes के लिए ज़रूरी है: 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 |
ज़रूरी नहीं. कैंपेन की बिडिंग की मौजूदा जानकारी. यह फ़ील्ड, इन recommendationTypes के लिए ज़रूरी है: 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 |
seed |
ज़रूरी नहीं. कीवर्ड के लिए सीड की जानकारी. नीचे दिए गए सिफारिश प्रकारों के लिए यह फ़ील्ड आवश्यक है: KEYWORD |
जवाब का मुख्य भाग
RecommendationService.GenerateRecommendations
के लिए जवाब देने वाला मैसेज.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
JSON के काेड में दिखाना |
---|
{
"recommendations": [
{
object ( |
फ़ील्ड | |
---|---|
recommendations[] |
अनुरोध किए गएसुझाव टाइप के सेट में पास किए गए सुझावों से, जनरेट किए गए सुझावों की सूची. अगर आपने जिन recommendationTypes के लिए सुझाव मांगा है उनके लिए सुझाव जनरेट करने के लिए ज़रूरत के मुताबिक डेटा उपलब्ध नहीं है, तो नतीजों के सेट में उस टाइप के लिए कोई सुझाव नहीं होगा. |
अनुमति के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/adwords
ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.
BiddingInfo
कैंपेन की मौजूदा बिडिंग की जानकारी. बिडिंग से जुड़े सिग्नल के लिए एक रैपर उपलब्ध कराता है, जो सुझावों की जानकारी देता है.
JSON के काेड में दिखाना |
---|
{ "biddingStrategyType": enum ( |
फ़ील्ड | |
---|---|
bidding |
बिडिंग की मौजूदा रणनीति. यह फ़ील्ड, इन recommendationTypes के लिए ज़रूरी है: 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_target_info इनमें से सिर्फ़ एक हो सकता है: |
|
target |
माइक्रो में मौजूदा टारगेट सीपीए. यह वैल्यू, TARGET_CPA या MAXIMIZE_CONVERSIONS टाइप की बिडिंग की रणनीति वाले कैंपेन के लिए अपने-आप भर सकती है. |
target |
मौजूदा टारगेट आरओएएस. यह TARGET_ROAS या MAXIMIZE_CONVERSION_VALUE की बोली लगाने की रणनीति वाले कैंपेन के लिए भरा जा सकता है. |
AdGroupInfo
अभियान के वर्तमान विज्ञापन समूह की जानकारी.
JSON के काेड में दिखाना |
---|
{ "keywords": [ { object ( |
फ़ील्ड | |
---|---|
keywords[] |
ज़रूरी नहीं. मौजूदा कीवर्ड. अगर adGroupInfo सेट है, तो यह फ़ील्ड इन recommendationTypes के लिए ज़रूरी नहीं है: कीवर्ड |
ad |
ज़रूरी नहीं. विज्ञापन समूह का प्रकार. अगर adGroupInfo सेट है, तो नीचे दिए गएसुझाव टाइप के लिए यह फ़ील्ड ज़रूरी है: KEYWORD |
SeedInfo
कीवर्ड सीड और कोई खास यूआरएल, जिससे कीवर्ड जनरेट किए जा सकते हैं.
JSON के काेड में दिखाना |
---|
{ "keywordSeeds": [ string ], "urlSeed": string } |
फ़ील्ड | |
---|---|
keyword |
ज़रूरी नहीं. आइडिया जनरेट करने के लिए कीवर्ड या वाक्यांश. उदाहरण के लिए: कार या "मेरे आस-पास कार डीलरशिप". |
url |
आइडिया जनरेट करने के लिए कोई खास यूआरएल, जैसे कि: www.example.com/cars. |