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)

الحالة الحالية للعلامة التجارية.