Method: customers.reports.countChromeDevicesReachingAutoExpirationDate

إنشاء تقرير لعدد الأجهزة التي تنتهي صلاحيتها في كل شهر من الإطار الزمني المحدّد. يتم تجميع الأجهزة حسب تاريخ انتهاء صلاحية الحصول التلقائي على التحديثات وطرازها. يمكنك الاطّلاع هنا على مزيد من المعلومات.

طلب HTTP

GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countChromeDevicesReachingAutoExpirationDate

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

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

المعلمات
customer

string

مطلوب. الرقم التعريفي للعميل أو "my_customer" مسبوقة بـ "customers/".

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

المعلمات
orgUnitId

string

اختياريّ. إذا تم حذف رقم تعريف الوحدة التنظيمية، سيعرض البيانات لجميع الوحدات التنظيمية.
minAueDate

string

اختياريّ. الحد الأقصى لتاريخ انتهاء الصلاحية بالتنسيق yyyy-mm-dd في المنطقة الزمنية حسب التوقيت العالمي المنسَّق (UTC). وفي حال تضمين هذه القيمة، يتم إرجاع جميع الأجهزة التي انتهت صلاحيتها بالفعل والأجهزة التي يكون تاريخ انتهاء الصلاحية التلقائي لها يساوي أو بعد التاريخ الأدنى.
maxAueDate

string

اختياريّ. الحد الأقصى لتاريخ انتهاء الصلاحية بالتنسيق yyyy-mm-dd في المنطقة الزمنية حسب التوقيت العالمي المنسَّق (UTC). وفي حال تضمين هذه السياسة، سيتم إرجاع جميع الأجهزة التي انتهت صلاحيتها والأجهزة التي لها تاريخ انتهاء صلاحية تلقائي يساوي التاريخ الأقصى أو أقدمه.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

ردّ يتضمّن قائمة بالأجهزة التي تنتهي صلاحيتها في كل شهر خلال إطار زمني محدّد. يتم تجميع الأعداد حسب الطراز وتاريخ انتهاء صلاحية الحصول التلقائي على التحديثات.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "deviceAueCountReports": [
    {
      object (DeviceAueCountReport)
    }
  ]
}
الحقول
deviceAueCountReports[]

object (DeviceAueCountReport)

قائمة التقارير مرتّبة تصاعديًا حسب تاريخ انتهاء صلاحية الحصول التلقائي على التحديثات.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/chrome.management.reports.readonly

DeviceAueCountReport

يحتوي تقرير CountChromeDevicesPerAueDateResponse على عدد الأجهزة من طراز معيّن ونطاق انتهاء صلاحية الحصول التلقائي على التحديثات.

تمثيل JSON 
{
  "model": string,
  "count": string,
  "aueMonth": enum (Month),
  "aueYear": string,
  "expired": boolean
}
الحقول
model

string

الاسم العلني للطراز العام للأجهزة
count

string (int64 format)

عدد الأجهزة من هذا الطراز
aueMonth

enum (Month)

قيمة التعداد للشهر المقابلة لتاريخ انتهاء صلاحية الحصول التلقائي على التحديثات حسب المنطقة الزمنية للتوقيت العالمي المتفق عليه يكون هذا الحقل فارغًا إذا كانت صلاحية الجهاز قد انتهت.
aueYear

string (int64 format)

القيمة الصالحة للسنة التي تتوافق مع تاريخ انتهاء صلاحية الحصول التلقائي على التحديثات في المنطقة الزمنية للتوقيت العالمي المتفق عليه. يكون هذا الحقل فارغًا إذا كانت صلاحية الجهاز قد انتهت.
expired

boolean

قيمة منطقية لمعرفة ما إذا كانت صلاحية الجهاز قد انتهت من قبل أم لا.

الشهر

يمثل شهرًا في التقويم الميلادي.

عمليات التعداد
MONTH_UNSPECIFIED الشهر غير المحدّد.
JANUARY شهر يناير.
FEBRUARY شهر شباط (فبراير).
MARCH شهر مارس.
APRIL شهر نيسان (أبريل).
MAY شهر مايو.
JUNE شهر حزيران (يونيو).
JULY شهر تموز (يوليو).
AUGUST شهر آب (أغسطس).
SEPTEMBER شهر سبتمبر.
OCTOBER شهر تشرين الأول (أكتوبر).
NOVEMBER شهر تشرين الثاني (نوفمبر).
DECEMBER شهر ديسمبر.