- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- KeywordPlanKeywordAnnotation
- KeywordAndUrlSeed
- KeywordSeed
- UrlSeed
- SiteSeed
- GenerateKeywordIdeaResult
- KeywordAnnotations
- KeywordConcept
- ConceptGroup
- KeywordPlanConceptGroupType
- इसे आज़माएं!
कीवर्ड के आइडिया की सूची दिखाता है.
थ्रो की गई गड़बड़ियों की सूची: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError KeywordPlanIdeaError QuotaError RequestError
एचटीटीपी अनुरोध
POST https://googleads.googleapis.com/v15/customers/{customerId}:generateKeywordIdeas
यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ के पैरामीटर
पैरामीटर | |
---|---|
customerId |
सुझाव के साथ ग्राहक का आईडी. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में इस तरह का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना |
---|
{ "geoTargetConstants": [ string ], "includeAdultKeywords": boolean, "pageToken": string, "pageSize": integer, "keywordPlanNetwork": enum ( |
फ़ील्ड | |
---|---|
geoTargetConstants[] |
टारगेट की जाने वाली जगह के संसाधन के नाम. यह वैल्यू ज़्यादा से ज़्यादा 10 हो सकती है. सभी टारगेटिंग जगहों को बताने के लिए, एक खाली सूची का इस्तेमाल किया जा सकता है. |
includeAdultKeywords |
सही होने पर, वयस्क कीवर्ड को जवाब में शामिल किया जाएगा. डिफ़ॉल्ट वैल्यू 'गलत' पर सेट होती है. |
pageToken |
हासिल किए जाने वाले पेज का टोकन. अगर इसके बारे में तय नहीं किया गया है, तो नतीजों का पहला पेज दिखाया जाएगा. नतीजों के अगले पेज का अनुरोध करने के लिए, पिछले जवाब में |
pageSize |
एक पेज में वापस पाने के लिए नतीजों की संख्या. ज़्यादा से ज़्यादा 10,000 नतीजे दिखाए जा सकते हैं, अगर pageSize इससे ज़्यादा होता है, तो इसे अनदेखा कर दिया जाता है. अगर यह जानकारी नहीं दी गई है, तो ज़्यादा से ज़्यादा 10,000 नतीजे दिखाए जाएंगे. सर्वर, लौटाए गए संसाधनों की संख्या को और सीमित कर सकता है. अगर जवाब में 10,000 से कम नतीजे शामिल हैं, तो हो सकता है कि इसे नतीजों का आखिरी पेज न माना जाए. |
keywordPlanNetwork |
नेटवर्क टारगेटिंग. नीति को सेट न करने पर, Google Search & Partners Network का इस्तेमाल किया जाएगा. |
keywordAnnotation[] |
जवाब में शामिल किए जाने वाले कीवर्ड एनोटेशन. |
aggregateMetrics |
जवाब में शामिल करने के लिए एग्रीगेट फ़ील्ड. |
historicalMetricsOptions |
मेट्रिक के पुराने डेटा के विकल्प. |
language |
टारगेट की जाने वाली भाषा के संसाधन का नाम. हर कीवर्ड किसी भाषा के सेट से जुड़ा होता है. कीवर्ड तब शामिल किया जाता है, जब भाषा उसकी किसी भाषा का इस्तेमाल करती हो. अगर यह नीति सेट नहीं है, तो सभी कीवर्ड शामिल कर दिए जाएंगे. |
यूनियन फ़ील्ड seed . कीवर्ड के आइडिया जनरेट करने के लिए सीड का टाइप. seed इनमें से सिर्फ़ एक हो सकता है: |
|
keywordAndUrlSeed |
आइडिया जनरेट करने के लिए कोई कीवर्ड और कोई यूआरएल, जैसे कि कार, www.example.com/cars. |
keywordSeed |
उदाहरण के लिए, कार से संबंधित अनुमान जनरेट करने वाला कीवर्ड या वाक्यांश. |
urlSeed |
कोई खास यूआरएल जिससे आइडिया जनरेट किए जा सकते हैं. उदाहरण के लिए, www.example.com/cars. |
siteSeed |
वह साइट जिससे आइडिया जनरेट करने हैं, उदाहरण के लिए, www.example.com. |
जवाब का मुख्य भाग
KeywordPlanIdeaService.GenerateKeywordIdeas
के लिए जवाब.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{ "results": [ { object ( |
फ़ील्ड | |
---|---|
results[] |
कीवर्ड अनुमान जनरेट करने के परिणाम. |
aggregateMetricResults |
सभी कीवर्ड के आइडिया के लिए एग्रीगेट की गई मेट्रिक. |
nextPageToken |
नतीजों का अगला पेज पाने के लिए इस्तेमाल किए जाने वाले पेजिनेशन टोकन. इस स्ट्रिंग के कॉन्टेंट को अगले अनुरोध के |
totalSize |
उपलब्ध नतीजों की कुल संख्या. |
अनुमति देने के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/adwords
ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.
KeywordPlanKeywordAnnotation
अनुरोध किए जा सकने वाले कीवर्ड प्लान एनोटेशन की गिनती करता है.
Enums | |
---|---|
UNSPECIFIED |
जानकारी नहीं दी गई. |
UNKNOWN |
इस वर्शन में वैल्यू की जानकारी नहीं है. |
KEYWORD_CONCEPT |
कीवर्ड के कॉन्सेप्ट और कॉन्सेप्ट ग्रुप का डेटा दिखाएं. |
KeywordAndUrlSeed
कीवर्ड और यूआरएल सीड
जेएसओएन के काेड में दिखाना |
---|
{ "keywords": [ string ], "url": string } |
फ़ील्ड | |
---|---|
keywords[] |
कम से कम एक कीवर्ड होना चाहिए. |
url |
कीवर्ड के आइडिया जनरेट करने के लिए क्रॉल किया जाने वाला यूआरएल. |
KeywordSeed
कीवर्ड सीड
जेएसओएन के काेड में दिखाना |
---|
{ "keywords": [ string ] } |
फ़ील्ड | |
---|---|
keywords[] |
कम से कम एक कीवर्ड होना चाहिए. |
UrlSeed
यूआरएल सीड
जेएसओएन के काेड में दिखाना |
---|
{ "url": string } |
फ़ील्ड | |
---|---|
url |
कीवर्ड के आइडिया जनरेट करने के लिए क्रॉल किया जाने वाला यूआरएल. |
SiteSeed
साइट के लिए सीड
जेएसओएन के काेड में दिखाना |
---|
{ "site": string } |
फ़ील्ड | |
---|---|
site |
साइट का डोमेन नेम. अगर विचारों का अनुरोध करने वाला ग्राहक साइट का मालिक न हो, तो सिर्फ़ सार्वजनिक जानकारी दिखाई जाती है. |
GenerateKeywordIdeaResult
कीवर्ड के आइडिया जनरेट करने का नतीजा.
जेएसओएन के काेड में दिखाना |
---|
{ "keywordIdeaMetrics": { object ( |
फ़ील्ड | |
---|---|
keywordIdeaMetrics |
कीवर्ड के लिए पुरानी मेट्रिक. |
keywordAnnotations |
कीवर्ड के लिए एनोटेशन. एनोटेशन का डेटा सिर्फ़ अनुरोध किए जाने पर ही दिया जाता है. |
closeVariants[] |
अनुरोध किए गए कीवर्ड के ऐसे मिलते-जुलते वैरिएंट की सूची जो इस generateKeywordIdearesults में शामिल किए गए हैं. "मिलते-जुलते वैरिएंट" की परिभाषा जानने के लिए, https://support.google.com/google-ads/answer/9342105 पर जाएं. |
text |
कीवर्ड के आइडिया का टेक्स्ट. कीवर्ड प्लान की पुरानी मेट्रिक की तरह, हो सकता है कि यह टेक्स्ट, कोई असल कीवर्ड न हो, लेकिन कई कीवर्ड का कैननिकल फ़ॉर्मैट हो. KeywordPlanService में आपको KeywordPlanKeywordKeywordMetrics मैसेज देखें. |
KeywordAnnotations
कीवर्ड प्लान वाले कीवर्ड के लिए एनोटेशन.
जेएसओएन के काेड में दिखाना |
---|
{
"concepts": [
{
object ( |
फ़ील्ड | |
---|---|
concepts[] |
कीवर्ड के लिए कॉन्सेप्ट की सूची. |
KeywordConcept
कीवर्ड का कॉन्सेप्ट.
जेएसओएन के काेड में दिखाना |
---|
{
"name": string,
"conceptGroup": {
object ( |
फ़ील्ड | |
---|---|
name |
ConceptGroup में कीवर्ड के कॉन्सेप्ट का नाम. |
conceptGroup |
कॉन्सेप्ट की जानकारी देने वाला ग्रुप. |
ConceptGroup
कीवर्ड के कॉन्सेप्ट के लिए कॉन्सेप्ट ग्रुप.
जेएसओएन के काेड में दिखाना |
---|
{
"name": string,
"type": enum ( |
फ़ील्ड | |
---|---|
name |
कॉन्सेप्ट ग्रुप का नाम. |
type |
कॉन्सेप्ट ग्रुप का टाइप. |
KeywordPlanConceptGroupType
कीवर्ड प्लान के कॉन्सेप्ट ग्रुप के टाइप की गिनती करता है.
Enums | |
---|---|
UNSPECIFIED |
कॉन्सेप्ट ग्रुप की कैटगरी, ब्रैंड/नॉन-ब्रैंड से अलग है. यह उन सभी कैटगरी के लिए कैच ऑल बकेट है, जो इनमें से कोई नहीं हैं. |
UNKNOWN |
इस वर्शन में वैल्यू की जानकारी नहीं है. |
BRAND |
कॉन्सेप्ट ग्रुप का वर्गीकरण BRAND के आधार पर किया जाता है. |
OTHER_BRANDS |
BRAND के आधार पर कॉन्सेप्ट ग्रुप की कैटगरी, जो BRAND की कैटगरी के साथ सही नहीं है. ये आम तौर पर आउटलायर होते हैं और इस तरह की कैटगरी में रखने के लिए, इनमें बहुत कम कीवर्ड हो सकते हैं. |
NON_BRAND |
कॉन्सेप्ट ग्रुप की कैटगरी, BRAND के आधार पर नहीं तय की जाती है. यह उन सामान्य कीवर्ड के लिए दिखाया जाता है जिनकी कोई ब्रैंड असोसिएशन नहीं है. |