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 و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

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