Method: customers.generateAdGroupThemes

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

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

בקשת HTTP

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