Method: customers.suggestBrands

متوسط تكلفة النقرة لعرض قائمة بالعلامات التجارية المطابقة استنادًا إلى بادئة لهذا العميل.

طلب 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

تعداد حالات العلامة التجارية المختلفة.

عمليات التعداد
UNSPECIFIED لم يتم تحديد أي قيمة.
UNKNOWN يُستخدم للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
ENABLED تم إثبات ملكية العلامة التجارية وهي متاحة للاختيار عالميًا.
DEPRECATED كانت العلامة التجارية متاحة على مستوى العالم في الماضي ولكنها لم تعد صالحة (استنادًا إلى معايير النشاط التجاري).
UNVERIFIED لم يتم إثبات ملكية العلامة التجارية وعلى نطاق العميل، ولكن يمكن أن يختارها العميل (الذي طلب ذلك فقط) للاستهداف
APPROVED كانت علامة تجارية على مستوى العميل (لم يتم إثبات ملكيتها) ووافق عليها النشاط التجاري وتمّت إضافتها إلى القائمة العالمية. يجب استخدام CKG MID الذي تم تعيينه له بدلاً من هذا
CANCELLED كانت علامة تجارية على مستوى العميل (لم يتم إثبات ملكيتها) ولكن ألغى العميل الطلب ولم يعُد رقم تعريف العلامة التجارية هذا صالحًا.
REJECTED كانت علامة تجارية على مستوى العميل (لم يتم إثبات ملكيتها) ولكن رفض فريق النشاط التجاري الداخلي الطلب، ولم يعُد رقم تعريف العلامة التجارية هذا صالحًا.