- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- BasicInsightsAudience
- AudienceInsightsTopic
- جرِّبه الآن
يُنشئ تقريرًا محفوظًا يمكن عرضه في أداة Insights Finder.
قائمة الأخطاء التي تظهر: AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError
طلب HTTP
POST https://googleads.googleapis.com/v15/customers/{customerId}:generateInsightsFinderReport
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
customerId |
مطلوبة. رقم تعريف العميل. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "baselineAudience": { object ( |
الحقول | |
---|---|
baselineAudience |
مطلوبة. جمهور أساسي لهذا التقرير، وعادةً ما يكون جميع الأشخاص في منطقة ما. |
specificAudience |
مطلوبة. الجمهور المحدّد محل الاهتمام في هذا التقرير. وستعتمد الإحصاءات الواردة في التقرير على السمات الأكثر شيوعًا في هذا الجمهور مقارنةً بالجمهور الأساسي للتقرير. |
customerInsightsGroup |
اسم العميل الذي يتم التخطيط له. وهذه قيمة من تحديد المستخدم. |
نص الاستجابة
رسالة الرد الخاصة بـ AudienceInsightsService.GenerateInsightsFinderReport
، والتي تحتوي على عنوان URL القابل للمشاركة والخاص بالتقرير.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "savedReportUrl": string } |
الحقول | |
---|---|
savedReportUrl |
عنوان URL يستخدم HTTPS يوفّر رابطًا لصفحة في التطبيق في واجهة مستخدم Insights Finder مع ملء إدخالات التقارير وفقًا للطلب. |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/adwords
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
BasicInsightsAudience
وصف للجمهور يُستخدَم لطلب الإحصاءات
تمثيل JSON |
---|
{ "countryLocation": [ { object ( |
الحقول | |
---|---|
countryLocation[] |
مطلوبة. البلدان التي ينتمي إليها هذا الجمهور |
subCountryLocations[] |
سمات الموقع الجغرافي لمناطق فرعية من البلد وفي حال توفّر كل منها، يجب أن تكون مدرَجة في أحد البلدان المُدرَجة في هذا الجمهور. |
gender |
الجنس للجمهور. في حالة عدم وجوده، لا يقيد الجمهور حسب الجنس. |
ageRanges[] |
الفئات العمرية للجمهور. في حال عدم توفّر هذه السمة، يمثّل الجمهور جميع الأشخاص الذين تزيد أعمارهم عن 18 عامًا والذين يتطابقون مع السمات الأخرى. |
userInterests[] |
اهتمامات المستخدِم التي تحدّد هذا الجمهور ويتم دعم شرائح الجمهور ذي الاهتمامات المشتركة وشرائح الجمهور في السوق. |
topics[] |
المواضيع التي تمثلها كيانات "الرسم البياني المعرفي" و/أو فئات المنتجات والخدمات التي يهتم بها هذا الجمهور. |
AudienceInsightsTopic
يشير ذلك المصطلح إلى كيان أو فئة تمثّل موضوعًا تحدِّد الجمهور.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد topic سمة فئة أو كيان. يمكن أن تكون السمة "topic " واحدة فقط مما يلي: |
|
entity |
كيان "الرسم البياني المعرفي" |
category |
فئة المنتجات والخدمات |