Method: customers.generateKeywordHistoricalMetrics

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

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

בקשת HTTP

POST https://googleads.googleapis.com/v14/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

אם כן, מילות מפתח למבוגרים בלבד ייכללו בתגובה. ערך ברירת המחדל הוא 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

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