Method: customers.generateKeywordIdeas

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

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

درخواست HTTP

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

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

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

پارامترها
customer Id

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.
}
فیلدها
geo Target Constants[]

string

نام منابع مکان مورد نظر حداکثر 10 است. ممکن است از یک لیست خالی برای تعیین تمام مکان های هدف استفاده شود.

include Adult Keywords

boolean

اگر درست باشد، کلمات کلیدی بزرگسالان در پاسخ گنجانده خواهند شد. مقدار پیش فرض نادرست است.

page Token

string

نشانه صفحه برای بازیابی. اگر مشخص نشده باشد، صفحه اول نتایج برگردانده خواهد شد. برای درخواست صفحه بعدی نتایج از مقدار بدست آمده از nextPageToken در پاسخ قبلی استفاده کنید. فیلدهای درخواست باید در بین صفحات مطابقت داشته باشند.

page Size

integer

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

keyword Plan Network

enum ( KeywordPlanNetwork )

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

keyword Annotation[]

enum ( KeywordPlanKeywordAnnotation )

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

aggregate Metrics

object ( KeywordPlanAggregateMetrics )

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

historical Metrics Options

object ( HistoricalMetricsOptions )

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

language

string

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

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

object ( KeywordAndUrlSeed )

یک کلمه کلیدی و یک URL خاص برای ایجاد ایده از مثلاً cars، www.example.com/cars.

keyword Seed

object ( KeywordSeed )

یک کلمه یا عبارت کلیدی برای ایجاد ایده از مثلاً اتومبیل.

url Seed

object ( UrlSeed )

یک نشانی اینترنتی خاص برای ایجاد ایده از مثلاً www.example.com/cars.

site Seed

object ( SiteSeed )

سایتی برای تولید ایده از مثلاً www.example.com.

بدن پاسخگو

پیام پاسخ برای KeywordPlanIdeaService.GenerateKeywordIdeas .

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "results": [
    {
      object (GenerateKeywordIdeaResult)
    }
  ],
  "aggregateMetricResults": {
    object (KeywordPlanAggregateMetricResults)
  },
  "nextPageToken": string,
  "totalSize": string
}
فیلدها
results[]

object ( GenerateKeywordIdeaResult )

نتایج تولید ایده های کلیدواژه

aggregate Metric Results

object ( KeywordPlanAggregateMetricResults )

معیارهای کل برای همه ایده های کلیدواژه.

next Page Token

string

نشانه صفحه بندی برای بازیابی صفحه بعدی نتایج استفاده می شود. محتوای این رشته را به عنوان صفت pageToken درخواست بعدی ارسال کنید. nextPageToken برای صفحه آخر بازگردانده نمی شود.

total Size

string ( int64 format)

تعداد کل نتایج موجود

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

Keyword PlanKeyword Annotation

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

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

KeywordAndUrlSeed

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

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

string

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

url

string

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

KeywordSeed

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

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

string

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

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
}
فیلدها
keyword Idea Metrics

object ( KeywordPlanHistoricalMetrics )

معیارهای تاریخی برای کلمه کلیدی

keyword Annotations

object ( KeywordAnnotations )

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

close Variants[]

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.

concept Group

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