Method: customers.generateKeywordIdeas

فهرستی از ایده های کلمه کلیدی را برمی گرداند.

فهرست خطاهای پرتاب شده: AuthenticationError AuthorizationError CollectionSizeError HeaderError داخلی خطای کلید واژهPlanIdeaError QuotaError RequestError

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
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

تعداد نتایج برای بازیابی در یک صفحه حداکثر 10000 نتیجه ممکن است برگردانده شود، اگر اندازه صفحه بیشتر از این باشد، نادیده گرفته می شود. اگر نامشخص باشد، حداکثر 10000 نتیجه برگردانده می شود. سرور ممکن است تصمیم بگیرد که تعداد منابع برگشتی را بیشتر محدود کند. اگر پاسخ حاوی کمتر از 10000 نتیجه باشد، ممکن است به عنوان آخرین صفحه نتایج در نظر گرفته نشود.

keywordPlanNetwork

enum ( KeywordPlanNetwork )

شبکه هدف. اگر تنظیم نشود، Google Search And Partners Network استفاده خواهد شد.

keywordAnnotation[]

enum ( KeywordPlanKeywordAnnotation )

حاشیه نویسی کلمه کلیدی که باید در پاسخ گنجانده شود.

aggregateMetrics

object ( KeywordPlanAggregateMetrics )

فیلدهای انبوهی که باید در پاسخ گنجانده شوند.

historicalMetricsOptions

object ( HistoricalMetricsOptions )

گزینه های داده های سنجه های تاریخی

language

string

نام منبع زبان مورد نظر. هر کلمه کلیدی به مجموعه ای از زبان ها تعلق دارد. اگر زبان یکی از زبان های آن باشد، یک کلمه کلیدی گنجانده می شود. اگر تنظیم نشود، همه کلمات کلیدی گنجانده می شوند.

seed مزرعه اتحادیه . نوع بذر برای تولید ایده های کلیدواژه. seed فقط می تواند یکی از موارد زیر باشد:
keywordAndUrlSeed

object ( KeywordAndUrlSeed )

یک کلمه کلیدی و یک URL خاص برای ایجاد ایده از مثلاً cars، 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 .

Keyword PlanKeyword Annotation

حاشیه نویسی طرح کلمه کلیدی را که می توان درخواست کرد را برمی شمارد.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN مقدار در این نسخه ناشناخته است.
KEYWORD_CONCEPT مفهوم کلمه کلیدی و داده های گروه مفهومی را برگردانید.

KeywordAndUrlSeed

کلمه کلیدی و آدرس URL

نمایندگی JSON 
{
  "keywords": [
    string
  ],
  "url": string
}
فیلدها
keywords[]

string

حداقل به یک کلمه کلیدی و حداکثر 20 کلمه کلیدی نیاز دارد.

url

string

URL برای خزیدن به منظور تولید ایده های کلمه کلیدی.

KeywordSeed

کلمه کلیدی بذر

نمایندگی JSON 
{
  "keywords": [
    string
  ]
}
فیلدها
keywords[]

string

حداقل به یک کلمه کلیدی و حداکثر 20 کلمه کلیدی نیاز دارد.

UrlSeed

Url Seed

نمایندگی JSON 
{
  "url": string
}
فیلدها
url

string

URL برای خزیدن به منظور تولید ایده های کلمه کلیدی.

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

متن ایده کلمه کلیدی. همانطور که در معیارهای تاریخی طرح کلیدواژه، این متن ممکن است یک کلمه کلیدی واقعی نباشد، بلکه شکل متعارف چند کلمه کلیدی باشد. پیام KeywordPlanKeywordHistoricalMetrics را در KeywordPlanService ببینید.

یادداشت های کلیدواژه

حاشیه نویسی برای کلمات کلیدی طرح کلمه کلیدی.

نمایندگی JSON 
{
  "concepts": [
    {
      object (KeywordConcept)
    }
  ]
}
فیلدها
concepts[]

object ( KeywordConcept )

فهرست مفاهیم برای کلمه کلیدی.

مفهوم کلمه کلیدی

مفهوم کلمه کلیدی

نمایندگی JSON 
{
  "name": string,
  "conceptGroup": {
    object (ConceptGroup)
  }
}
فیلدها
name

string

نام مفهومی برای کلمه کلیدی در conceptGroup.

conceptGroup

object ( 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 نیست. این برای کلمات کلیدی عمومی که تداعی برند ندارند بازگردانده می شود.