Method: customers.generateKeywordHistoricalMetrics

מחזירה רשימה של ערכים היסטוריים של מילות מפתח.

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של 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.

GenerateKeywordHistoricalMetricsResult

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

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

string

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

object (KeywordPlanHistoricalMetrics)

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

string

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