يسترد التقرير تقريرًا عبارة عن مجموعة من المواقع والإحصاءات لمجموعة من المستخدمين الذين لديهم الحساب. للمزيد من المعلومات، يمكنك الاطّلاع على دليل تقرير استخدام المستخدم. لمزيد من المعلومات عن مَعلمات تقرير المستخدِم، اطّلِع على الأدلة المرجعية لمَعلمات استخدام المستخدمين.
طلب HTTP
GET https://admin.googleapis.com/admin/reports/v1/usage/users/{userKey or all}/dates/{date}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
userKey or all |
تُمثِّل معرِّف الملف الشخصي أو البريد الإلكتروني للمستخدم الذي يجب فلترة البيانات له. يمكن أن تكون القيمة |
date |
يمثل تاريخ حدوث الاستخدام، استنادًا إلى UTC-8:00 (توقيت المحيط الهادئ الرسمي). يكون الطابع الزمني بتنسيق ISO 8601، |
معلمات طلب البحث
المَعلمات | |
---|---|
customerId |
المعرّف الفريد للعميل لاسترداد البيانات له. |
filters |
سلسلة طلب البحث تظهر الفلاتر على النحو التالي: في هذا المثال، يتم ترميز عامل التشغيل GET https://www.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03 ?parameters=accounts:last_login_time &filters=accounts:last_login_time%3C%3E2010-10-28T10:26:35.000Z تتضمن العوامل الارتباطية ما يلي:
|
maxResults |
لتحديد عدد سجلّات النشاط التي يتم عرضها في كل صفحة استجابة. على سبيل المثال، إذا كان الطلب يضبط |
orgUnitID |
رقم تعريف الوحدة التنظيمية المطلوب إعداد التقارير عنها. لن يتم عرض نشاط المستخدم إلا للمستخدمين الذين ينتمون إلى الوحدة التنظيمية المحدّدة. |
pageToken |
رمز مميز لتحديد الصفحة التالية يحتوي تقرير يحتوي على صفحات متعددة على السمة |
parameters |
سلسلة طلب البحث |
groupIdFilter |
أرقام تعريف المجموعات المفصولة بفواصل (غير واضحة) التي تتم فلترة أنشطة المستخدمين عليها، أي أنّ الإجابة ستحتوي فقط على أنشطة للمستخدمين الذين يشكلون جزءًا من رقم تعريف مجموعة واحد على الأقل مذكور هنا. التنسيق: "id:abc123,id:xyz456" |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال UsageReports
.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/admin.reports.usage.readonly
لمزيد من المعلومات، راجِع دليل التفويض.