Method: customers.generateAdGroupThemes

מחזירה רשימה של הצעות לקבוצות של מודעות והצעות לשינויים (טקסט, סוג התאמה) למילות המפתח הנתונות.

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

בקשת HTTP

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

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

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

פרמטרים
customerId

string

חובה. המזהה של הלקוח.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

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

string

חובה. רשימה של מילות מפתח לקיבוץ בקבוצות של המודעות שסופקו.
adGroups[]

string

חובה. רשימה של שמות המשאבים של קבוצות של מודעות שלפיהם צריך לקבץ את מילות המפתח. פורמט שם המשאב: customers/{customerId}/adGroups/{adGroupId}

גוף התשובה

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

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

ייצוג JSON 
{
  "adGroupKeywordSuggestions": [
    {
      object (AdGroupKeywordSuggestion)
    }
  ],
  "unusableAdGroups": [
    {
      object (UnusableAdGroup)
    }
  ]
}
שדות
adGroupKeywordSuggestions[]

object (AdGroupKeywordSuggestion)

רשימת הצעות לצמדים של קבוצת מודעות/מילות מפתח.
unusableAdGroups[]

object (UnusableAdGroup)

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

היקפי הרשאות

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

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

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

AdGroupKeywordSuggestion

ההתאמה המוצעת של טקסט וקבוצת מודעות/קמפיין למילת מפתח נתונה.

ייצוג JSON 
{
  "keywordText": string,
  "suggestedKeywordText": string,
  "suggestedMatchType": enum (KeywordMatchType),
  "suggestedAdGroup": string,
  "suggestedCampaign": string
}
שדות
keywordText

string

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

string

הגרסה המנורמלת של keywordText עבור הצעות רחבה/מדויקת/לביטוי.
suggestedMatchType

enum (KeywordMatchType)

סוג ההתאמה של מילת המפתח שהוצעה.
suggestedAdGroup

string

קבוצת המודעות המוצעת עבור מילת המפתח. פורמט שם המשאב: customers/{customerId}/adGroups/{adGroupId}
suggestedCampaign

string

הקמפיין המוצע עבור מילת המפתח. פורמט שם המשאב: customers/{customerId}/campaigns/{campaignId}

UnusableAdGroup

צמד של קבוצת מודעות/קמפיין שלא ניתן להשתמש בו כהצעה למילות מפתח.

לא ניתן להשתמש בקבוצות מודעות אם קבוצת המודעות

  • שייך לקמפיין שאינו מופעל או מושהה
  • כשלעצמו לא מופעל
ייצוג JSON 
{
  "adGroup": string,
  "campaign": string
}
שדות
adGroup

string

שם המשאב של קבוצת המודעות. פורמט שם המשאב: customers/{customerId}/adGroups/{adGroupId}
campaign

string

שם המשאב של הקמפיין. פורמט שם המשאב: customers/{customerId}/campaigns/{campaignId}