Method: customers.suggestBrands

Rpc כדי להחזיר רשימה של מותגים תואמים על סמך הקידומת של הלקוח.

בקשת HTTP

POST https://googleads.googleapis.com/v15/customers/{customerId}:suggestBrands

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

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

פרמטרים
customerId

string

חובה. מספר הלקוח שבו צריך להחיל את פעולת ההצעה למותג.

גוף הבקשה

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

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

string

אפשרות. המזהים של המותגים שכבר נבחרו על ידי המפרסמים. הם יוחרגו בתגובה. השמות צריכים להיות מזהי מותגים, ולא שמות מותגים.
brandPrefix

string

חובה. הקידומת של שם המותג.

גוף התגובה

הודעת תשובה לגבי BrandSuggestionService.SuggestBrands.

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

ייצוג JSON 
{
  "brands": [
    {
      object (BrandSuggestion)
    }
  ]
}
שדות
brands[]

object (BrandSuggestion)

הצעות המותגים שנוצרו עבור מותגים מאומתים עבור הקידומת הנתונה.

היקפי הרשאות

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

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

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

BrandSuggestion

מידע של הצעה למותג.

ייצוג JSON 
{
  "id": string,
  "name": string,
  "urls": [
    string
  ],
  "state": enum (BrandState)
}
שדות
id

string

המזהה של המותג. הוא יהיה CKG MID למותגים מאומתים/בהיקף גלובלי.
name

string

שם המותג.
urls[]

string

כתובות URL שמזהות את המותג באופן ייחודי.
state

enum (BrandState)

המצב הנוכחי של המותג.

BrandState

במספור של מצבי המותג השונים.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין ערך.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
ENABLED המותג מאומת וזמין לבחירה בכל העולם
DEPRECATED המותג היה זמין בעבר בכל העולם, אבל הוא כבר לא מותג תקף (על סמך קריטריונים עסקיים)
UNVERIFIED המותג לא מאומת ובהיקף ברמת הלקוח, אבל הלקוח יכול לבחור אותו (רק שביקש אותו) לצורך טירגוט
APPROVED היה מותג ברמת הלקוח (לא מאומת), שאושר על ידי העסק ונוסף לרשימה הגלובלית. יש להשתמש ב-CKG MID שהוקצה לו במקום
CANCELLED היה מותג ברמת הלקוח (לא מאומת), אבל הלקוח ביטל את הבקשה ומזהה המותג הזה כבר לא חוקי
REJECTED היה מותג ברמת הלקוח (לא מאומת), אבל הבקשה נדחתה על ידי הצוות הפנימי של העסק ומזהה המותג הזה כבר לא חוקי