Method: customers.generateKeywordIdeas

מחזירה רשימה של רעיונות למילות מפתח.

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

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

פרמטרים
customerId

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.
}
שדות
geoTargetConstants[]

string

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

boolean

אם הערך הוא true, מילות מפתח למבוגרים בלבד ייכללו בתגובה. ערך ברירת המחדל הוא False.
pageToken

string

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

integer

מספר התוצאות שיש לאחזר בדף יחיד. המערכת תתעלם מ-10,000 תוצאות לכל היותר. אם הערך של pageSize חורג מהערך הזה, המערכת תתעלם ממנו. אם לא צוין, יוחזרו 10,000 תוצאות לכל היותר. השרת עשוי להחליט להגביל עוד יותר את מספר המשאבים שמוחזרים. אם התשובה מכילה פחות מ-10,000 תוצאות, ייתכן שהיא לא תיחשב כדף התוצאות האחרון.
keywordPlanNetwork

enum (KeywordPlanNetwork)

טירגוט לרשת. אם המדיניות לא מוגדרת, ייעשה שימוש ברשת החיפוש והשותפים של Google.
keywordAnnotation[]

enum (KeywordPlanKeywordAnnotation)

ההערות של מילת המפתח שיש לכלול בתגובה.
aggregateMetrics

object (KeywordPlanAggregateMetrics)

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

object (HistoricalMetricsOptions)

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

string

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

object (KeywordAndUrlSeed)

מילת מפתח וכתובת URL ספציפית שמהן יתקבלו רעיונות, לדוגמה: מכוניות, www.example.com/cars.
keywordSeed

object (KeywordSeed)

מילת מפתח או ביטוי ליצירת רעיונות, לדוגמה, מכוניות.
urlSeed

object (UrlSeed)

כתובת URL ספציפית ליצירת רעיונות, לדוגמה www.example.com/cars.
siteSeed

object (SiteSeed)

האתר שממנו אפשר ליצור רעיונות, לדוגמה, www.example.com.

גוף התשובה

הודעת תשובה לגבי KeywordPlanIdeaService.GenerateKeywordIdeas.

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

ייצוג JSON 
{
  "results": [
    {
      object (GenerateKeywordIdeaResult)
    }
  ],
  "aggregateMetricResults": {
    object (KeywordPlanAggregateMetricResults)
  },
  "nextPageToken": string,
  "totalSize": string
}
שדות
results[]

object (GenerateKeywordIdeaResult)

תוצאות יצירת רעיונות למילות מפתח.
aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

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

string

אסימון העימוד המשמש לאחזור דף התוצאות הבא. העברת התוכן של המחרוזת הזו בתור המאפיין pageToken של הבקשה הבאה. לא מוחזר nextPageToken עבור הדף האחרון.
totalSize

string (int64 format)

סך כל התוצאות הזמינות.

היקפי הרשאות

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

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

למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.

KeywordPlanKeywordAnnotation

כוללת פירוט של הערות לגבי תוכנית מילות מפתח שאפשר לבקש.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא ידוע בגרסה הזו.
KEYWORD_CONCEPT החזר את נתוני הקונספט של מילת המפתח וקבוצת הקונספטים.

KeywordAndUrlSeed

המקור של מילת המפתח וכתובת האתר

ייצוג JSON 
{
  "keywords": [
    string
  ],
  "url": string
}
שדות
keywords[]

string

נדרשת לפחות מילת מפתח אחת.
url

string

כתובת ה-URL לסריקה כדי ליצור רעיונות למילות מפתח.

KeywordSeed

מקור מילת המפתח

ייצוג JSON 
{
  "keywords": [
    string
  ]
}
שדות
keywords[]

string

נדרשת לפחות מילת מפתח אחת.

UrlSeed

מקור של כתובת URL

ייצוג JSON 
{
  "url": string
}
שדות
url

string

כתובת ה-URL לסריקה כדי ליצור רעיונות למילות מפתח.

SiteSeed

מקור של אתר

ייצוג JSON 
{
  "site": string
}
שדות
site

string

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

GenerateKeywordIdeaResult

התוצאה של יצירת רעיונות למילות מפתח.

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

object (KeywordPlanHistoricalMetrics)

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

object (KeywordAnnotations)

ההערות של מילת המפתח. נתוני ההערות מסופקים רק אם התבקשו.
closeVariants[]

string

רשימה של גרסאות קרובות ממילות המפתח המבוקשות, שמשולבות ב-GenerateKeywordIdeaResult הזו. הגדרה של 'גרסאות קרובות' מופיעה בכתובת https://support.google.com/google-ads/answer/9342105.
text

string

טקסט של הרעיון למילת מפתח. כמו במדדים ההיסטוריים של תוכנית מילות המפתח, ייתכן שהטקסט הזה לא יהיה מילת מפתח בפועל אלא הצורה הקנונית של מילות מפתח מרובות. ראה את ההודעה KeywordPlanKeywordHistoricalMetrics ב-KeywordPlanService.

KeywordAnnotations

ההערות שקשורות למילות המפתח של תוכנית מילות המפתח.

ייצוג JSON 
{
  "concepts": [
    {
      object (KeywordConcept)
    }
  ]
}
שדות
concepts[]

object (KeywordConcept)

רשימת המושגים של מילת המפתח.

KeywordConcept

הקונספט של מילת המפתח.

ייצוג JSON 
{
  "name": string,
  "conceptGroup": {
    object (ConceptGroup)
  }
}
שדות
name

string

שם הקונספט של מילת המפתח בקבוצת הקונספט.
conceptGroup

object (ConceptGroup)

קבוצת הקונספט של פרטי הקונספט.

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