Method: customerUsageReports.get

يسترد التقرير تقريرًا عبارة عن مجموعة من المواقع والإحصاءات لحساب عميل معيّن. لمزيد من المعلومات، اطّلِع على دليل تقرير استخدام العملاء. لمزيد من المعلومات عن معلَمات تقرير العملاء، يمكنك الاطّلاع على الأدلة المرجعية لمَعلمات استخدام العملاء.

طلب HTTP

GET https://admin.googleapis.com/admin/reports/v1/usage/dates/{date}

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

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

المَعلمات
date

string

يمثل تاريخ حدوث الاستخدام، استنادًا إلى UTC-8:00 (توقيت المحيط الهادئ الرسمي). يكون الطابع الزمني بتنسيق ISO 8601، yyyy-mm-dd.

معلمات طلب البحث

المَعلمات
customerId

string

المعرّف الفريد للعميل لاسترداد البيانات له.

pageToken

string

رمز مميز لتحديد الصفحة التالية يحتوي تقرير يحتوي على صفحات متعددة على السمة nextPageToken في الاستجابة. بالنسبة إلى طلبات المتابعة التي تحصل على جميع صفحات التقرير، أدخِل القيمة nextPageToken في سلسلة طلب البحث pageToken.

parameters

string

سلسلة طلب البحث parameters هي قائمة مفصولة بفواصل تتضمّن مَعلمات الأحداث التي تعمل على تحسين نتائج التقرير. ترتبط المَعلمة بتطبيق محدّد. تتضمن قيم التطبيق لتقرير استخدام العملاء accounts وapp_maker وapps_scripts وcalendar وclassroom وcros وdocs وgmail وgplus وdevice_management وmeet وsites.
سلسلة طلب البحث parameters هي في شكل ملف CSV من app_name1:param_name1, app_name2:param_name2.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال UsageReports.

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

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

  • https://www.googleapis.com/auth/admin.reports.usage.readonly

لمزيد من المعلومات، راجِع دليل التفويض.