Method: customers.searchAudienceInsightsAttributes

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

قائمة الأخطاء التي تظهر: AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

طلب HTTP

POST https://googleads.googleapis.com/v14/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.