Method: customers.generateInsightsFinderReport

يُنشئ تقريرًا محفوظًا يمكن عرضه في أداة Insights Finder.

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

طلب HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}:generateInsightsFinderReport

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

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

المَعلمات
customerId

string

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

نص الطلب

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

تمثيل JSON 
{
  "baselineAudience": {
    object (BasicInsightsAudience)
  },
  "specificAudience": {
    object (BasicInsightsAudience)
  },
  "customerInsightsGroup": string
}
الحقول
baselineAudience

object (BasicInsightsAudience)

مطلوبة. جمهور أساسي لهذا التقرير، وعادةً ما يكون جميع الأشخاص في منطقة ما.
specificAudience

object (BasicInsightsAudience)

مطلوبة. الجمهور المحدّد محل الاهتمام في هذا التقرير. وستعتمد الإحصاءات الواردة في التقرير على السمات الأكثر شيوعًا في هذا الجمهور مقارنةً بالجمهور الأساسي للتقرير.
customerInsightsGroup

string

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

نص الاستجابة

رسالة الرد الخاصة بـ AudienceInsightsService.GenerateInsightsFinderReport، والتي تحتوي على عنوان URL القابل للمشاركة والخاص بالتقرير.

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

تمثيل JSON 
{
  "savedReportUrl": string
}
الحقول
savedReportUrl

string

عنوان URL يستخدم HTTPS يوفّر رابطًا لصفحة في التطبيق في واجهة مستخدم Insights Finder مع ملء إدخالات التقارير وفقًا للطلب.

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

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

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

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

BasicInsightsAudience

وصف للجمهور يُستخدَم لطلب الإحصاءات

تمثيل JSON 
{
  "countryLocation": [
    {
      object (LocationInfo)
    }
  ],
  "subCountryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "userInterests": [
    {
      object (UserInterestInfo)
    }
  ],
  "topics": [
    {
      object (AudienceInsightsTopic)
    }
  ]
}
الحقول
countryLocation[]

object (LocationInfo)

مطلوبة. البلدان التي ينتمي إليها هذا الجمهور
subCountryLocations[]

object (LocationInfo)

سمات الموقع الجغرافي لمناطق فرعية من البلد وفي حال توفّر كل منها، يجب أن تكون مدرَجة في أحد البلدان المُدرَجة في هذا الجمهور.
gender

object (GenderInfo)

الجنس للجمهور. في حالة عدم وجوده، لا يقيد الجمهور حسب الجنس.
ageRanges[]

object (AgeRangeInfo)

الفئات العمرية للجمهور. في حال عدم توفّر هذه السمة، يمثّل الجمهور جميع الأشخاص الذين تزيد أعمارهم عن 18 عامًا والذين يتطابقون مع السمات الأخرى.
userInterests[]

object (UserInterestInfo)

اهتمامات المستخدِم التي تحدّد هذا الجمهور ويتم دعم شرائح الجمهور ذي الاهتمامات المشتركة وشرائح الجمهور في السوق.
topics[]

object (AudienceInsightsTopic)

المواضيع التي تمثلها كيانات "الرسم البياني المعرفي" و/أو فئات المنتجات والخدمات التي يهتم بها هذا الجمهور.

AudienceInsightsTopic

يشير ذلك المصطلح إلى كيان أو فئة تمثّل موضوعًا تحدِّد الجمهور.

تمثيل JSON 
{

  // Union field topic can be only one of the following:
  "entity": {
    object (AudienceInsightsEntity)
  },
  "category": {
    object (AudienceInsightsCategory)
  }
  // End of list of possible types for union field topic.
}
الحقول
حقل الاتحاد topic سمة فئة أو كيان. يمكن أن تكون السمة "topic" واحدة فقط مما يلي:
entity

object (AudienceInsightsEntity)

كيان "الرسم البياني المعرفي"
category

object (AudienceInsightsCategory)

فئة المنتجات والخدمات