- طلب HTTP
- مَعلمات المسار
- معامِلات طلب البحث
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- EntityType
- جرِّبه الآن
يسترد التقرير تقريرًا عبارة عن مجموعة من المواقع والإحصاءات للكيانات التي يستخدمها المستخدِمون داخل الحساب. للمزيد من المعلومات، يمكنك الاطّلاع على دليل تقرير استخدام الكيانات. لمزيد من المعلومات عن مَعلمات تقرير الكيانات، يمكنك الاطّلاع على الأدلة المرجعية لمَعلمات استخدام الكيانات.
طلب HTTP
GET https://admin.googleapis.com/admin/reports/v1/usage/{entityType}/{entityKey or all}/dates/{date}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
entityType |
تُمثِّل هذه السمة نوع الكيان للتقرير. |
entityKey or all |
تمثل مفتاح الكائن لفلترة البيانات باستخدامه. وهو سلسلة يمكنها استخدام القيمة |
date |
يمثل تاريخ حدوث الاستخدام، استنادًا إلى UTC-8:00 (توقيت المحيط الهادئ الرسمي). يكون الطابع الزمني بتنسيق ISO 8601، |
معلمات طلب البحث
المَعلمات | |
---|---|
customerId |
المعرّف الفريد للعميل لاسترداد البيانات له. |
filters |
سلسلة طلب البحث تظهر الفلاتر على النحو التالي: في هذا المثال، يتم ترميز عامل التشغيل GET https://www.googleapis.com/admin/reports/v1/usage/gplus_communities/all/dates/2017-12-01 ?parameters=gplus:community_name,gplus:num_total_members &filters=gplus:num_total_members%3C%3E0 تتضمن العوامل الارتباطية ما يلي:
|
maxResults |
لتحديد عدد سجلّات النشاط التي يتم عرضها في كل صفحة استجابة. على سبيل المثال، إذا كان الطلب يضبط |
pageToken |
رمز مميز لتحديد الصفحة التالية يحتوي تقرير يحتوي على صفحات متعددة على السمة |
parameters |
سلسلة طلب البحث |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال UsageReports
.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/admin.reports.usage.readonly
لمزيد من المعلومات، راجِع دليل التفويض.
EntityType
عمليات التعداد | |
---|---|
gplus_communities |
يعرض تقريرًا عن منتديات +Google. |