Method: customers.generateAdGroupThemes

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

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

בקשת HTTP

POST https://googleads.googleapis.com/v17/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 להצעות BROAD/מדויקת/PHRASE.
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}