Method: customers.generateKeywordHistoricalMetrics

הפונקציה מחזירה רשימה של מדדים היסטוריים של מילות מפתח.

רשימת השגיאות שהושלחו: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

פרמטרים של נתיב

פרמטרים
customerId

string

המזהה של הלקוח שאליו מתייחסת ההמלצה.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "keywords": [
    string
  ],
  "includeAdultKeywords": boolean,
  "geoTargetConstants": [
    string
  ],
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "aggregateMetrics": {
    object (KeywordPlanAggregateMetrics)
  },
  "historicalMetricsOptions": {
    object (HistoricalMetricsOptions)
  },
  "language": string
}
שדות
keywords[]

string

רשימה של מילות מפתח לקבלת מדדים היסטוריים. לא כל הקלט יוחזר כתוצאה מביטול כפילויות כמעט מדויק. לדוגמה, אם מבקשים נתונים סטטיסטיים לגבי 'מכונית' ו'מכוניות', המערכת תחזיר רק את 'מכונית'. אפשר להשתמש ב-10,000 מילות מפתח לכל היותר.
includeAdultKeywords

boolean

אם הערך הוא true, מילות מפתח למבוגרים ייכללו בתגובה. ערך ברירת המחדל הוא false.
geoTargetConstants[]

string

שמות המשאבים של המיקום שאליו רוצים לטרגט. המספר המקסימלי הוא 10. אפשר להשתמש ברשימה ריקה כדי לציין את כל המיקומים הגיאוגרפיים לטירגוט.
keywordPlanNetwork

enum (KeywordPlanNetwork)

רשת הטירגוט. אם לא תגדירו את הערך, המערכת תשתמש ברשת החיפוש של Google ובאתרים של שותפי החיפוש.
aggregateMetrics

object (KeywordPlanAggregateMetrics)

השדות המצטברים שרוצים לכלול בתשובה.
historicalMetricsOptions

object (HistoricalMetricsOptions)

האפשרויות לנתוני מדדים היסטוריים.
language

string

שם המשאב של שפת היעד. כל מילת מפתח שייכת לקבוצה מסוימת של שפות. מילת מפתח נכללת אם השפה היא אחת מהשפות שלה. אם לא תגדירו את המאפיין, כל מילות המפתח ייכללו.

גוף התשובה

הודעת התשובה עבור KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics.

אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "results": [
    {
      object (GenerateKeywordHistoricalMetricsResult)
    }
  ],
  "aggregateMetricResults": {
    object (KeywordPlanAggregateMetricResults)
  }
}
שדות
results[]

object (GenerateKeywordHistoricalMetricsResult)

רשימה של מילות מפתח והמדדים ההיסטוריים שלהן.
aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

המדדים המצטברים של כל מילות המפתח.

היקפי הרשאה

נדרש היקף הרשאות OAuth הבא:

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

מידע נוסף זמין בOAuth 2.0 Overview.

GenerateKeywordHistoricalMetricsResult

התוצאה של יצירת מדדים היסטוריים של מילות מפתח.

ייצוג ב-JSON 
{
  "closeVariants": [
    string
  ],
  "keywordMetrics": {
    object (KeywordPlanHistoricalMetrics)
  },
  "text": string
}
שדות
closeVariants[]

string

רשימת הגרסאות הקרובות של מילות המפתח המבוקשות, שהנתונים הסטטיסטיים שלהן משולבים ב-GenerateKeywordHistoricalMetricsResult הזה.
keywordMetrics

object (KeywordPlanHistoricalMetrics)

המדדים ההיסטוריים של הטקסט והגרסאות הקרובות שלו
text

string

טקסט השאילתה שמשויך למילת מפתח אחת או יותר. חשוב לזכור שאנחנו מסירים כפילויות מרשימת מילות המפתח, ומבטלים גרסאות דומות לפני שאנחנו מחזירים את מילות המפתח כטקסט. לדוגמה, אם הבקשה המקורית הכילה את מילות המפתח 'מכונית' ו'מכוניות', שאילתת החיפוש שתוחזר תכלול רק את 'מכוניות'. רשימת השאילתות שהוסר מהן הכפילויות תכלול את השדה closeVariants.