Method: customers.suggestBrands

Rpc برای بازگرداندن فهرستی از مارک های منطبق بر اساس پیشوندی برای این مشتری.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
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 مراجعه کنید.

پیشنهاد برند

اطلاعات پیشنهاد برند.

نمایندگی JSON
{
  "id": string,
  "name": string,
  "urls": [
    string
  ],
  "state": enum (BrandState)
}
زمینه های
id

string

شناسه برای برند این CKG MID برای مارک‌های دارای دامنه تأیید شده/جهانی است.

name

string

نام برند.

urls[]

string

نشانی‌های اینترنتی که به طور منحصربه‌فردی برند را شناسایی می‌کنند.

state

enum ( BrandState )

وضعیت فعلی برند