- طلب HTTP
- مَعلمات المسار
- معامِلات طلب البحث
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- DeviceAueCountReport
- الشهر
- جرِّبه الآن
إنشاء تقرير لعدد الأجهزة التي تنتهي صلاحيتها في كل شهر من الإطار الزمني المحدّد. يتم تجميع الأجهزة حسب تاريخ انتهاء صلاحية الحصول التلقائي على التحديثات وطرازها. يمكنك الاطّلاع هنا على مزيد من المعلومات.
طلب HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countChromeDevicesReachingAutoExpirationDate
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
customer |
مطلوب. الرقم التعريفي للعميل أو "my_customer" مسبوقة بـ "customers/". |
معامِلات طلب البحث
المعلمات | |
---|---|
orgUnitId |
اختياريّ. إذا تم حذف رقم تعريف الوحدة التنظيمية، سيعرض البيانات لجميع الوحدات التنظيمية. |
minAueDate |
اختياريّ. الحد الأقصى لتاريخ انتهاء الصلاحية بالتنسيق yyyy-mm-dd في المنطقة الزمنية حسب التوقيت العالمي المنسَّق (UTC). وفي حال تضمين هذه القيمة، يتم إرجاع جميع الأجهزة التي انتهت صلاحيتها بالفعل والأجهزة التي يكون تاريخ انتهاء الصلاحية التلقائي لها يساوي أو بعد التاريخ الأدنى. |
maxAueDate |
اختياريّ. الحد الأقصى لتاريخ انتهاء الصلاحية بالتنسيق yyyy-mm-dd في المنطقة الزمنية حسب التوقيت العالمي المنسَّق (UTC). وفي حال تضمين هذه السياسة، سيتم إرجاع جميع الأجهزة التي انتهت صلاحيتها والأجهزة التي لها تاريخ انتهاء صلاحية تلقائي يساوي التاريخ الأقصى أو أقدمه. |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
ردّ يتضمّن قائمة بالأجهزة التي تنتهي صلاحيتها في كل شهر خلال إطار زمني محدّد. يتم تجميع الأعداد حسب الطراز وتاريخ انتهاء صلاحية الحصول التلقائي على التحديثات.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"deviceAueCountReports": [
{
object ( |
الحقول | |
---|---|
deviceAueCountReports[] |
قائمة التقارير مرتّبة تصاعديًا حسب تاريخ انتهاء صلاحية الحصول التلقائي على التحديثات. |
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/chrome.management.reports.readonly
DeviceAueCountReport
يحتوي تقرير CountChromeDevicesPerAueDateResponse على عدد الأجهزة من طراز معيّن ونطاق انتهاء صلاحية الحصول التلقائي على التحديثات.
تمثيل JSON |
---|
{
"model": string,
"count": string,
"aueMonth": enum ( |
الحقول | |
---|---|
model |
الاسم العلني للطراز العام للأجهزة |
count |
عدد الأجهزة من هذا الطراز |
aueMonth |
قيمة التعداد للشهر المقابلة لتاريخ انتهاء صلاحية الحصول التلقائي على التحديثات حسب المنطقة الزمنية للتوقيت العالمي المتفق عليه يكون هذا الحقل فارغًا إذا كانت صلاحية الجهاز قد انتهت. |
aueYear |
القيمة الصالحة للسنة التي تتوافق مع تاريخ انتهاء صلاحية الحصول التلقائي على التحديثات في المنطقة الزمنية للتوقيت العالمي المتفق عليه. يكون هذا الحقل فارغًا إذا كانت صلاحية الجهاز قد انتهت. |
expired |
قيمة منطقية لمعرفة ما إذا كانت صلاحية الجهاز قد انتهت من قبل أم لا. |
الشهر
يمثل شهرًا في التقويم الميلادي.
عمليات التعداد | |
---|---|
MONTH_UNSPECIFIED |
الشهر غير المحدّد. |
JANUARY |
شهر يناير. |
FEBRUARY |
شهر شباط (فبراير). |
MARCH |
شهر مارس. |
APRIL |
شهر نيسان (أبريل). |
MAY |
شهر مايو. |
JUNE |
شهر حزيران (يونيو). |
JULY |
شهر تموز (يوليو). |
AUGUST |
شهر آب (أغسطس). |
SEPTEMBER |
شهر سبتمبر. |
OCTOBER |
شهر تشرين الأول (أكتوبر). |
NOVEMBER |
شهر تشرين الثاني (نوفمبر). |
DECEMBER |
شهر ديسمبر. |