Method: customers.generateKeywordIdeas

कीवर्ड के आइडिया की सूची दिखाता है.

दिखने वाली गड़बड़ियों की सूची: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError KeywordPlanIdeaError QuotaError RequestError

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

POST https://googleads.googleapis.com/v18/customers/{customerId}:generateKeywordIdeas

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

पाथ पैरामीटर

पैरामीटर
customerId

string

सुझाव वाले ग्राहक का आईडी.

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

अनुरोध के मुख्य भाग में नीचे दिए गए स्ट्रक्चर वाला डेटा होता है:

JSON के काेड में दिखाना 
{
  "geoTargetConstants": [
    string
  ],
  "includeAdultKeywords": boolean,
  "pageToken": string,
  "pageSize": integer,
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "keywordAnnotation": [
    enum (KeywordPlanKeywordAnnotation)
  ],
  "aggregateMetrics": {
    object (KeywordPlanAggregateMetrics)
  },
  "historicalMetricsOptions": {
    object (HistoricalMetricsOptions)
  },
  "language": string,

  // Union field seed can be only one of the following:
  "keywordAndUrlSeed": {
    object (KeywordAndUrlSeed)
  },
  "keywordSeed": {
    object (KeywordSeed)
  },
  "urlSeed": {
    object (UrlSeed)
  },
  "siteSeed": {
    object (SiteSeed)
  }
  // End of list of possible types for union field seed.
}
फ़ील्ड
geoTargetConstants[]

string

टारगेट की जाने वाली जगह के संसाधनों के नाम. ज़्यादा से ज़्यादा 10 हो सकते हैं. सभी टारगेटिंग जियो को बताने के लिए, खाली सूची का इस्तेमाल किया जा सकता है.
includeAdultKeywords

boolean

अगर यह सही है, तो जवाब में वयस्कों के लिए बने कीवर्ड शामिल किए जाएंगे. डिफ़ॉल्ट वैल्यू गलत है.
pageToken

string

जिस पेज को वापस लाना है उसका टोकन. अगर कोई नंबर नहीं दिया जाता है, तो नतीजों का पहला पेज दिखेगा. नतीजों के अगले पेज का अनुरोध करने के लिए, पिछले जवाब में nextPageToken से मिली वैल्यू का इस्तेमाल करें. अनुरोध फ़ील्ड, सभी पेजों पर मैच होने चाहिए.
pageSize

integer

एक पेज पर दिखाए जाने वाले नतीजों की संख्या. ज़्यादा से ज़्यादा 10,000 नतीजे दिखाए जा सकते हैं. अगर pageSize की वैल्यू इससे ज़्यादा है, तो उसे अनदेखा कर दिया जाता है. अगर कोई वैल्यू नहीं दी जाती है, तो ज़्यादा से ज़्यादा 10,000 नतीजे दिखाए जाएंगे. सर्वर, दिखाए जाने वाले संसाधनों की संख्या को और भी सीमित कर सकता है. अगर जवाब में 10,000 से कम नतीजे हैं, तो हो सकता है कि नतीजों के आखिरी पेज के तौर पर न माना जाए.
keywordPlanNetwork

enum (KeywordPlanNetwork)

टारगेटिंग नेटवर्क. अगर यह सेट नहीं है, तो Google Search और पार्टनर नेटवर्क का इस्तेमाल किया जाएगा.
keywordAnnotation[]

enum (KeywordPlanKeywordAnnotation)

जवाब में शामिल किए जाने वाले कीवर्ड एनोटेशन.
aggregateMetrics

object (KeywordPlanAggregateMetrics)

जवाब में शामिल करने के लिए एग्रीगेट किए गए फ़ील्ड.
historicalMetricsOptions

object (HistoricalMetricsOptions)

मेट्रिक के पुराने डेटा के विकल्प.
language

string

टारगेट की जाने वाली भाषा के संसाधन का नाम. हर कीवर्ड, भाषाओं के किसी सेट से जुड़ा होता है. अगर भाषा, कीवर्ड के सेट में शामिल है, तो कीवर्ड को शामिल किया जाता है. अगर यह सेट नहीं किया जाता है, तो सभी कीवर्ड शामिल किए जाएंगे.
यूनियन फ़ील्ड seed. कीवर्ड के आइडिया जनरेट करने के लिए, सीड का टाइप. seed इनमें से कोई एक हो सकता है:
keywordAndUrlSeed

object (KeywordAndUrlSeed)

आइडिया जनरेट करने के लिए कीवर्ड और कोई खास यूआरएल, जैसे कि कारें, www.example.com/cars.
keywordSeed

object (KeywordSeed)

कोई कीवर्ड या वाक्यांश, जिससे आइडिया जनरेट किए जा सकें. उदाहरण के लिए, कार.
urlSeed

object (UrlSeed)

आइडिया जनरेट करने के लिए कोई खास यूआरएल, जैसे कि www.example.com/cars.
siteSeed

object (SiteSeed)

वह साइट जिससे आइडिया जनरेट करने हैं, जैसे कि www.example.com.

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

KeywordPlanIdeaService.GenerateKeywordIdeas के लिए जवाब का मैसेज.

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

JSON के काेड में दिखाना 
{
  "results": [
    {
      object (GenerateKeywordIdeaResult)
    }
  ],
  "aggregateMetricResults": {
    object (KeywordPlanAggregateMetricResults)
  },
  "nextPageToken": string,
  "totalSize": string
}
फ़ील्ड
results[]

object (GenerateKeywordIdeaResult)

कीवर्ड के आइडिया जनरेट करने के नतीजे.
aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

सभी कीवर्ड आइडिया के लिए एग्रीगेट मेट्रिक.
nextPageToken

string

पेजेशन टोकन, नतीजों के अगले पेज को वापस लाने के लिए इस्तेमाल किया जाता है. इस स्ट्रिंग के कॉन्टेंट को अगले अनुरोध के pageToken एट्रिब्यूट के तौर पर पास करें. nextPageToken, आखिरी पेज के लिए नहीं दिखाया जाता.
totalSize

string (int64 format)

उपलब्ध नतीजों की कुल संख्या.

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

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

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

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

KeywordPlanKeywordAnnotation

कीवर्ड प्लान के उन एनोटेशन की जानकारी देता है जिनका अनुरोध किया जा सकता है.

Enums
UNSPECIFIED इसकी जानकारी नहीं दी गई है.
UNKNOWN इस वर्शन में वैल्यू की जानकारी नहीं है.
KEYWORD_CONCEPT कीवर्ड कॉन्सेप्ट और कॉन्सेप्ट ग्रुप का डेटा दिखाता है.

KeywordAndUrlSeed

कीवर्ड और यूआरएल सीड

JSON के काेड में दिखाना 
{
  "keywords": [
    string
  ],
  "url": string
}
फ़ील्ड
keywords[]

string

इसमें कम से कम एक और ज़्यादा से ज़्यादा 20 कीवर्ड होने चाहिए.
url

string

कीवर्ड के आइडिया जनरेट करने के लिए क्रॉल किया जाने वाला यूआरएल.

KeywordSeed

कीवर्ड सीड

JSON के काेड में दिखाना 
{
  "keywords": [
    string
  ]
}
फ़ील्ड
keywords[]

string

इसमें कम से कम एक और ज़्यादा से ज़्यादा 20 कीवर्ड होने चाहिए.

UrlSeed

यूआरएल सीड

JSON के काेड में दिखाना 
{
  "url": string
}
फ़ील्ड
url

string

कीवर्ड के आइडिया जनरेट करने के लिए क्रॉल किया जाने वाला यूआरएल.

SiteSeed

साइट के लिए सीड

JSON के काेड में दिखाना 
{
  "site": string
}
फ़ील्ड
site

string

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

GenerateKeywordIdeaResult

कीवर्ड के आइडिया जनरेट करने का नतीजा.

JSON के काेड में दिखाना 
{
  "keywordIdeaMetrics": {
    object (KeywordPlanHistoricalMetrics)
  },
  "keywordAnnotations": {
    object (KeywordAnnotations)
  },
  "closeVariants": [
    string
  ],
  "text": string
}
फ़ील्ड
keywordIdeaMetrics

object (KeywordPlanHistoricalMetrics)

कीवर्ड की पुरानी मेट्रिक.
keywordAnnotations

object (KeywordAnnotations)

कीवर्ड के लिए एनोटेशन. एनोटेशन का डेटा सिर्फ़ तब दिया जाता है, जब अनुरोध किया जाता है.
closeVariants[]

string

अनुरोध किए गए कीवर्ड के मिलते-जुलते वैरिएंट की सूची, जिन्हें GenerateKeywordIdeaResult में जोड़ा जाता है. "मिलते-जुलते वैरिएंट" की परिभाषा के लिए, https://support.google.com/google-ads/answer/9342105 पर जाएं.
text

string

कीवर्ड के आइडिया का टेक्स्ट. कीवर्ड प्लान की पुरानी मेट्रिक की तरह, यह टेक्स्ट कोई असली कीवर्ड नहीं हो सकता, बल्कि कई कीवर्ड का कैननिकल फ़ॉर्म हो सकता है. KeywordPlanService में KeywordPlanKeywordHistoricalMetrics मैसेज देखें.

KeywordAnnotations

कीवर्ड प्लान के कीवर्ड के लिए एनोटेशन.

JSON के काेड में दिखाना 
{
  "concepts": [
    {
      object (KeywordConcept)
    }
  ]
}
फ़ील्ड
concepts[]

object (KeywordConcept)

कीवर्ड के लिए कॉन्सेप्ट की सूची.

KeywordConcept

कीवर्ड का कॉन्सेप्ट.

JSON के काेड में दिखाना 
{
  "name": string,
  "conceptGroup": {
    object (ConceptGroup)
  }
}
फ़ील्ड
name

string

conceptGroup में मौजूद कीवर्ड के कॉन्सेप्ट का नाम.
conceptGroup

object (ConceptGroup)

कॉन्सेप्ट की जानकारी का कॉन्सेप्ट ग्रुप.

ConceptGroup

कीवर्ड कॉन्सेप्ट के लिए कॉन्सेप्ट ग्रुप.

JSON के काेड में दिखाना 
{
  "name": string,
  "type": enum (KeywordPlanConceptGroupType)
}
फ़ील्ड
name

string

कॉन्सेप्ट ग्रुप का नाम.
type

enum (KeywordPlanConceptGroupType)

कॉन्सेप्ट ग्रुप का टाइप.

KeywordPlanConceptGroupType

कीवर्ड प्लान के कॉन्सेप्ट ग्रुप टाइप की जानकारी देता है.

Enums
UNSPECIFIED कॉन्सेप्ट ग्रुप का बंटवारा, ब्रैंड/नॉन-ब्रैंड से अलग होता है. यह उन सभी कैटगरी के लिए एक बकेट है जो यहां दी गई कैटगरी में शामिल नहीं हैं.
UNKNOWN इस वर्शन में वैल्यू की जानकारी नहीं है.
BRAND कॉन्सेप्ट ग्रुप का क्लासिफ़िकेशन, ब्रैंड के आधार पर किया जाता है.
OTHER_BRANDS ब्रैंड के आधार पर कॉन्सेप्ट ग्रुप की कैटगरी, जो ब्रैंड की कैटगरी के हिसाब से सही नहीं है. आम तौर पर, ये आउटलायर होते हैं और इस तरह के क्लासिफ़िकेशन में बहुत कम कीवर्ड हो सकते हैं.
NON_BRAND कॉन्सेप्ट ग्रुप का यह क्लासिफ़िकेशन, ब्रैंड के आधार पर नहीं किया जाता. यह वैल्यू, उन सामान्य कीवर्ड के लिए दिखती है जिनमें ब्रैंड असोसिएशन नहीं होता.