Method: customers.generateInsightsFinderReport

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

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

طلب HTTP

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

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