Method: customers.generateKeywordIdeas

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

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

בקשת HTTP

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

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

מילת מפתח וכתובת אתר ספציפית שמהן תיצור רעיונות, לדוגמה, מכוניות, 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

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

KeywordSeed

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

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

string

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

UrlSeed

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

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

string

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

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

רשימת הגרסאות הקרובות ממילות המפתח המבוקשות, המשולבות ב-GenerateKeywordIdea Results הזה. ההגדרה של 'גרסאות קרובות' זמינה בכתובת 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.
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. הערך הזה מוחזר למילות מפתח כלליות שאין להן שיוך למותג.