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 और Partners नेटवर्क का इस्तेमाल किया जाएगा.
keywordAnnotation[]

enum (KeywordPlanKeywordAnnotation)

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

object (KeywordPlanAggregateMetrics)

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

object (HistoricalMetricsOptions)

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

string

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

object (KeywordAndUrlSeed)

एक कीवर्ड और एक विशिष्ट Url, जिनसे सुझाव जनरेट किए जा सकते हैं, उदाहरण के लिए, कार, 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 की खास जानकारी देखें.

KeywordPlanKeywordAnnotation

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

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

KeywordAndUrlSeed

कीवर्ड और Url सीड

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

string

कम से कम एक कीवर्ड होना चाहिए.
url

string

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

KeywordSeed

कीवर्ड सीड

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

string

कम से कम एक कीवर्ड होना चाहिए.

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 कॉन्सेप्ट ग्रुप की कैटगरी, BRAND पर आधारित है.
OTHER_BRANDS BRAND के आधार पर कॉन्सेप्ट ग्रुप की कैटगरी, जो BRAND की कैटगरी में फ़िट नहीं आई. आम तौर पर, ये आउटलायर होते हैं और इस तरह के क्लासिफ़िकेशन में बहुत कम कीवर्ड हो सकते हैं.
NON_BRAND इन कॉन्सेप्ट ग्रुप की कैटगरी, BRAND पर आधारित नहीं है. यह वैल्यू, उन सामान्य कीवर्ड के लिए दिखती है जिनमें ब्रैंड असोसिएशन नहीं होता.