Method: customers.generateKeywordHistoricalMetrics

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

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

درخواست HTTP

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

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

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

پارامترها
customer Id

string

شناسه مشتری با توصیه.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "keywords": [
    string
  ],
  "includeAdultKeywords": boolean,
  "geoTargetConstants": [
    string
  ],
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "aggregateMetrics": {
    object (KeywordPlanAggregateMetrics)
  },
  "historicalMetricsOptions": {
    object (HistoricalMetricsOptions)
  },
  "language": string
}
فیلدها
keywords[]

string

لیستی از کلمات کلیدی برای به دست آوردن معیارهای تاریخی. همه ورودی‌ها در نتیجه کپی‌برداری تقریباً دقیق بازگردانده نمی‌شوند. برای مثال، اگر آمار مربوط به «ماشین» و «ماشین» درخواست شود، فقط «ماشین» برگردانده خواهد شد. حداکثر می توان از 10000 کلمه کلیدی استفاده کرد.

include Adult Keywords

boolean

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

geo Target Constants[]

string

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

keyword Plan Network

enum ( KeywordPlanNetwork )

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

aggregate Metrics

object ( KeywordPlanAggregateMetrics )

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

historical Metrics Options

object ( HistoricalMetricsOptions )

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

language

string

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

بدن پاسخگو

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

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

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

object ( GenerateKeywordHistoricalMetricsResult )

فهرست کلمات کلیدی و معیارهای تاریخی آنها.

aggregate Metric Results

object ( KeywordPlanAggregateMetricResults )

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

محدوده مجوز

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

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

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

Generate KeywordHistoricalMetrics Result

نتیجه تولید معیارهای تاریخی کلمه کلیدی.

نمایندگی JSON 
{
  "closeVariants": [
    string
  ],
  "keywordMetrics": {
    object (KeywordPlanHistoricalMetrics)
  },
  "text": string
}
فیلدها
close Variants[]

string

لیستی از انواع نزدیک از کلمات کلیدی درخواستی که آمار آنها در این GenerateKeywordHistoricalMetricsResult ترکیب شده است.

keyword Metrics

object ( KeywordPlanHistoricalMetrics )

معیارهای تاریخی برای متن و انواع نزدیک آن

text

string

متن درخواست مرتبط با یک یا چند کلمه کلیدی. توجه داشته باشید که ما لیست کلمات کلیدی شما را حذف می کنیم و انواع نزدیک را قبل از برگرداندن کلمات کلیدی به عنوان متن حذف می کنیم. به عنوان مثال، اگر درخواست شما در ابتدا حاوی کلمات کلیدی "cars" و "cars" بود، عبارت جستجوی بازگشتی فقط حاوی "cars" خواهد بود. لیست پرس و جوهای فریب خورده در قسمت closeVariants گنجانده خواهد شد.