Method: customers.generateKeywordIdeas

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

थ्रो की गई गड़बड़ियों की सूची: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError KeywordPlanIdeaError QuotaError RequestError

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

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

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

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

पैरामीटर
customerId

string

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

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

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

जेएसओएन के काेड में दिखाना 
{
  "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 Network का इस्तेमाल किया जाएगा.
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 के लिए जवाब.

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

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

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

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

string

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

string

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

KeywordSeed

कीवर्ड सीड

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

string

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

UrlSeed

यूआरएल सीड

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

string

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

SiteSeed

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

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

string

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

GenerateKeywordIdeaResult

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

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

object (KeywordPlanHistoricalMetrics)

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

object (KeywordAnnotations)

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

string

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

string

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

KeywordAnnotations

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

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

object (KeywordConcept)

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

KeywordConcept

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

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

string

ConceptGroup में कीवर्ड के कॉन्सेप्ट का नाम.
conceptGroup

object (ConceptGroup)

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

ConceptGroup

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

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

string

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

enum (KeywordPlanConceptGroupType)

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

KeywordPlanConceptGroupType

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

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