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)

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

aueYear

string (int64 format)

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

expired

boolean

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

الشهر

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

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