Method: customers.generateAdGroupThemes

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

רשימת שגיאות שנדחתו: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של 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}