Method: customers.suggestBrands

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

בקשת HTTP

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

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