Method: customers.searchAudienceInsightsAttributes

يبحث عن سمات الجمهور التي يمكن استخدامها لإنشاء إحصاءات.

قائمة بالأخطاء المعروضة: AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز gRPC.

معلمات المسار

المَعلمات
customerId

string

مطلوبة. رقم تعريف العميل.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON
{
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "queryText": string,
  "customerInsightsGroup": string,
  "locationCountryFilters": [
    {
      object (LocationInfo)
    }
  ]
}
الحقول
dimensions[]

enum (AudienceInsightsDimension)

مطلوبة. أنواع السمات المراد عرضها.

queryText

string

مطلوبة. استعلام نصي حر. إذا كانت السمات المطلوبة تتضمن السمات CATEGORY أو KNOWLEDGE_GRAPH، فعندئذٍ ستتطابق السمات المعروضة لتلك الأبعاد مع هذه السلسلة أو ستكون مرتبطة بها. بالنسبة إلى السمات الأخرى، يتم تجاهل هذا الحقل وعرض جميع السمات المتاحة.

customerInsightsGroup

string

اسم العميل الذي يتم التخطيط له. هذه قيمة من تحديد المستخدم.

locationCountryFilters[]

object (LocationInfo)

إذا كانت سمات SUB_COUNTRY_LOCATION هي إحدى السمات المطلوبة وكان هذا الحقل متوفّرًا، ستظهر سمات SUB_COUNTRY_LOCATION التي يتم عرضها في هذه البلدان. إذا لم يكن هذا الحقل متوفرًا، لن تتم فلترة سمات الموقع الجغرافي حسب البلد. سيؤدي إعداد هذا الحقل عند عدم طلب سمات SUB_COUNTRY_LOCATION إلى عرض خطأ.

نص الاستجابة

رسالة الرد لـ "AudienceInsightsService.ListAudienceInsightsAttributes".

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON
{
  "attributes": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ]
}
الحقول
attributes[]

object (AudienceInsightsAttributeMetadata)

السمات التي تطابق طلب البحث.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/adwords

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.