Method: customers.generateKeywordIdeas

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

इस्तेमाल की गई गड़बड़ियों की सूची: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError KeywordPlanIdeaError QuotaError RequestError

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

POST https://googleads.googleapis.com/v16/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

एक पेज में वापस लाए जाने वाले नतीजों की संख्या. अगर pageSize इससे ज़्यादा हो जाता है, तो ज़्यादा से ज़्यादा 10,000 नतीजे लौटाए जा सकते हैं. अगर इसे तय नहीं किया गया है, तो ज़्यादा से ज़्यादा 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

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

string

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

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 पर आधारित नहीं है. यह ऐसे सामान्य कीवर्ड के लिए दिखाया जाता है जिनका किसी ब्रैंड से कोई लेना-देना नहीं है.