- בקשת HTTP
- פרמטרים של נתיב
- גוף הבקשה
- גוף התשובה
- היקפי ההרשאות
- AdGroupKeywordSuggestion
- UnusableAdGroup
- רוצים לנסות?
הפונקציה מחזירה רשימה של הצעות לקבוצות מודעות והצעות לשינויים (טקסט, סוג התאמה) של מילות המפתח הנתונות.
רשימת שגיאות שנדחתו: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError
בקשת HTTP
POST https://googleads.googleapis.com/v17/customers/{customerId}:generateAdGroupThemes
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
customerId |
חובה. המזהה של הלקוח. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "keywords": [ string ], "adGroups": [ string ] } |
שדות | |
---|---|
keywords[] |
חובה. רשימה של מילות מפתח לקיבוץ בקבוצות המודעות שהוקצו. |
adGroups[] |
חובה. רשימה של שמות המשאבים בקבוצות של המודעות שאליהם צריך לקבץ מילות מפתח. הפורמט של שם המשאב: |
גוף התשובה
הודעת תשובה עבור KeywordPlanIdeaService.GenerateAdGroupThemes
.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "adGroupKeywordSuggestions": [ { object ( |
שדות | |
---|---|
adGroupKeywordSuggestions[] |
רשימה של הצעות לצמדים של קבוצות מודעות ומילות מפתח. |
unusableAdGroups[] |
רשימה של קבוצות מודעות שסופקו שלא ניתן להשתמש בהן כהצעות. |
היקפי ההרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/adwords
למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
AdGroupKeywordSuggestion
ההתאמה של הטקסט המוצע לקבוצת המודעות/הקמפיין למילת מפתח נתונה.
ייצוג JSON |
---|
{
"keywordText": string,
"suggestedKeywordText": string,
"suggestedMatchType": enum ( |
שדות | |
---|---|
keywordText |
הטקסט המקורי של מילת המפתח. |
suggestedKeywordText |
הגרסה המנורמלת של keywordText להצעות BROAD/מדויקת/PHRASE. |
suggestedMatchType |
סוג ההתאמה של מילת המפתח המוצעת. |
suggestedAdGroup |
קבוצת המודעות המוצעת עבור מילת המפתח. הפורמט של שם המשאב: |
suggestedCampaign |
הקמפיין המוצע למילת המפתח. הפורמט של שם המשאב: |
UnusableAdGroup
צמד קבוצת מודעות/קמפיין שאי אפשר להשתמש בו כהצעה למילות מפתח.
אי אפשר להשתמש בקבוצת המודעות אם קבוצת המודעות
- שייך לקמפיין שאינו מופעל או מושבת
- עצמו לא מופעל
ייצוג JSON |
---|
{ "adGroup": string, "campaign": string } |
שדות | |
---|---|
adGroup |
שם המשאב של קבוצת המודעות. הפורמט של שם המשאב: |
campaign |
שם המשאב של הקמפיין. הפורמט של שם המשאב: |