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 في المنطقة الزمنية للتوقيت العالمي المتفق عليه في حال تضمينه، يتم إرجاع جميع الأجهزة التي انتهت صلاحيتها والأجهزة التي تاريخ انتهاء صلاحيتها تلقائيًا يساوي أو بعد التاريخ الأدنى.
maxAueDate

string

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

نص الطلب

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

نص الاستجابة

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

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

تمثيل 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)

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

string (int64 format)

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

boolean

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

الشهر

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

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