Method: customers.generateKeywordIdeas

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

רשימת השגיאות שהמערכת זרקה: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError KeywordPlanIdeaError QuotaError RequestError

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של 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 ספציפית ליצירת רעיונות, לדוגמה: cars, ‏ 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 Overview.

KeywordPlanKeywordAnnotation

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

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

KeywordAndUrlSeed

מילת מפתח וכתובת URL ראשוניות

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

string

צריך להוסיף לפחות מילת מפתח אחת ולא יותר מ-20 מילות מפתח.
url

string

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

KeywordSeed

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

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

string

צריך להוסיף לפחות מילת מפתח אחת ולא יותר מ-20 מילות מפתח.

UrlSeed

זרע של כתובת URL

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

string

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

SiteSeed

Site Seed

ייצוג ב-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.
conceptGroup

object (ConceptGroup)

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

ConceptGroup

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

ייצוג ב-JSON 
{
  "name": string,
  "type": enum (KeywordPlanConceptGroupType)
}
שדות
name

string

השם של קבוצת הקונספט.
type

enum (KeywordPlanConceptGroupType)

סוג קבוצת הקונספט.

KeywordPlanConceptGroupType

מציגה את סוגי הקבוצות לפי קונספט בתוכנית מילות מפתח.

טיפוסים בני מנייה (enum)
UNSPECIFIED הסיווג של קבוצת המושגים שונה מסיווג 'מותג'/'לא מותג'. קטגוריה כללית לכל הסיווגים שלא נכללים בקטגוריות הבאות.
UNKNOWN הערך לא מוכר בגרסה הזו.
BRAND הסיווג של קבוצות המושגים מבוסס על המאפיין BRAND.
OTHER_BRANDS הסיווג של קבוצת הקונספט על סמך מותג, שלא התאים היטב לסיווגים של המותג. בדרך כלל מדובר בערכים חריגים, ויכול להיות שיש להם מעט מאוד מילות מפתח בסיווג מהסוג הזה.
NON_BRAND הסיווג של קבוצות המושגים האלה לא מבוסס על המותג. הערך הזה מוחזר למילות מפתח כלליות שאין להן שיוך למותג.