Method: customerUsageReports.get

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

طلب HTTP

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

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

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

المعلمات
date

string

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

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

المعلمات
customerId

string

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

string

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

string

سلسلة طلب البحث parameters هي قائمة مفصولة بفواصل لمَعلمات الأحداث التي تعمل على تحسين نتائج التقرير. تكون المَعلمة مرتبطة بتطبيق معيّن. تشمل قيم التطبيقات لتقرير "استخدام العملاء" accounts وapp_maker وapps_scripts وcalendar وchat و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

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.