مجموعات مقاييس طلب البحث

بعد إعداد كل شيء، يمكنك إرسال طلبات إلى Google Play Developer Reporting API لاسترداد البيانات الوصفية حول مجموعات المقاييس والاستعلام عن مقاييسها.

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

استرداد البيانات الوصفية لمجموعة المقاييس

يسترد المثال التالي البيانات الوصفية لمعدّل نسبة الأعطال الذي تم ضبطه لتطبيق com.example.app خيالي.

طلب بسيط:

يحدد طلب HTTP GET هذا معلمة اسم التطبيق ويعرض مورد المقياس الكامل المرتبط بتطبيقك.

GET https://playdeveloperreporting.googleapis.com/v1beta1/apps/com.example.app/crashRateMetricSet

الرد على معلومات المقياس:

يتضمن الرد الحقول التالية ذات الصلة بمجموعة المقاييس:

{
  "freshness_info": {
    "freshness": [
      "aggregation_period": "DAILY"
      "latest_end_time": { year: "2021" month: "7" day: "22" time_zone: "America/Los_Angeles" }
    ]
  }
}

استخدام ميزة طلب البحث

يستخدم طلب HTTP POSTالتالي لهذا المورد نفسه نقطة النهاية query لاسترداد بيانات محدّدة من داخل مجموعة المقاييس.

POST https://playdeveloperreporting.googleapis.com/v1beta1/apps/com.example.app/crashRateMetricSet:query

في نص الطلب، مرّر خيارات طلب البحث لاسترداد المقاييس استنادًا إلى معايير محددة.

{
  "timeline_spec": {
    "aggregation_period": "DAILY"
    "start_time": { year: "2021" month: "7" day: "1" time_zone: "America/Los_Angeles" }
    "end_time": { year: "2021" month: "7" day: "3" time_zone: "America/Los_Angeles" }
   }
  "dimensions": ["apiLevel"]
  "metrics": ["errorReportCount", "distinctUsers"]
  "page_size": "10"
}

في ما يلي بعض الأمثلة على مستوى المجموعة:

الحقول
timelineSpec	object (TimelineSpec) مواصفات معلمات تجميع المخطط الزمني. يُرجى الاطّلاع على وثائق كل مجموعة مقاييس للاطّلاع على قائمة بفترات التجميع المتاحة.
dimensions[]	string الأبعاد لتقسيم المقاييس حسب. يُرجى مراجعة مستندات كل مجموعة مقاييس للاطّلاع على قائمة بالأبعاد المتاحة.
metrics[]	string المقاييس المجمّعة.
pageSize	integer الحد الأقصى لحجم البيانات المعروضة. وإذا لم يتم تحديده، سيتم عرض 1, 000 صف كحدّ أقصى. الحد الأقصى للقيمة هو 100000، وسيتم فرض القيمة التي تزيد على 100000 على 100000.

التعامل مع الردود

بعد أن يعالج الخادم طلبًا صالحًا يتضمّن حقولاً صالحة، يعيد إرسال رمز حالة HTTP 200 OK بالإضافة إلى البيانات المطلوبة. إذا كانت معلَمة طلب البحث fields تتضمّن خطأً أو كانت غير صالحة، يعرض الخادم رمز حالة HTTP 400 Bad Request بالإضافة إلى رسالة خطأ لإعلام المستخدم بالخطأ في اختيار الحقول (على سبيل المثال، "Invalid field timeline_spec").

في ما يلي مثال للرد الموضح في القسم التمهيدي أعلاه.

POST https://playdeveloperreporting.googleapis.com/v1beta1/apps/com.example.app/crashRateMetricSet:query

ويبدو الرد كما يلي:

200 OK

{
  rows: [
    {
      aggregation_period: "DAILY"
      start_time: { year: "2021" month: "7" day: "1" time_zone: "America/Los_Angeles" }
      dimensions: [{dimension: "apiLevel" int64_value: "20"}]
      metrics: [
        {metric: "errorReportCount" decimal_value: "100"},
        {metric: "distinctUsers" decimal_value: "57"},
      ]
    }, {
      aggregation_period: "DAILY"
      start_time: { year: "2021" month: "7" day: "1" time_zone: "America/Los_Angeles" }
      dimensions: [{dimension: "apiLevel" int64_value: "21"}]
      metrics: [
        {metric: "errorReportCount" decimal_value: "123"},
        {metric: "distinctUsers" decimal_value: "65"},
      ]
    },
    ...
  ]
  next_page_token: "eW91IGhhdmUgdG9vIG11Y2ggZnJlZSB0aW1l"
}

ملاحظة: في واجهات برمجة التطبيقات التي تتيح مَعلمات طلب البحث للتقسيم على صفحات (maxResults وnextPageToken مثلاً)، استخدِم هذه المَعلمات لتقليل نتائج كل طلب بحث إلى حجم يمكن إدارته.