Rpc برای بازگرداندن فهرستی از مارک های منطبق بر اساس پیشوندی برای این مشتری.
درخواست HTTP
POST https://googleads.googleapis.com/v16/customers/{customerId}:suggestBrands
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های | |
---|---|
customerId | ضروری. شناسه مشتری که عملیات پیشنهاد برند را روی آن اعمال می کند. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "selectedBrands": [ string ], "brandPrefix": string } |
زمینه های | |
---|---|
selectedBrands[] | اختیاری. شناسه مارکهایی که قبلاً توسط تبلیغکنندگان انتخاب شدهاند. آنها در پاسخ حذف خواهند شد. انتظار می رود اینها شناسه های برند باشند نه نام های تجاری. |
brandPrefix | ضروری. پیشوند یک نام تجاری. |
بدن پاسخگو
پیام پاسخ برای BrandSuggestionService.SuggestBrands
.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"brands": [
{
object ( |
زمینه های | |
---|---|
brands[] | پیشنهادات نام تجاری از مارک های تأیید شده برای پیشوند داده شده ایجاد شد. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/adwords
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
پیشنهاد برند
اطلاعات پیشنهاد برند.
نمایندگی JSON |
---|
{
"id": string,
"name": string,
"urls": [
string
],
"state": enum ( |
زمینه های | |
---|---|
id | شناسه برای برند این CKG MID برای مارکهای دارای دامنه تأیید شده/جهانی است. |
name | نام برند. |
urls[] | نشانیهای اینترنتی که به طور منحصربهفردی برند را شناسایی میکنند. |
state | وضعیت فعلی برند |