Method: customers.reports.countChromeDevicesReachingAutoExpirationDate

יצירת דוח של מספר המכשירים שהתוקף שלהם פג בכל חודש במסגרת הזמן שנבחרה. המכשירים מקובצים לפי תאריך ודגם של העדכון האוטומטי. מידע נוסף זמין כאן.

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של 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)

ערך Enum של חודש שתואם לתאריך התפוגה של העדכון האוטומטי לפי אזור הזמן UTC. אם התוקף של המכשיר פג, השדה הזה יהיה ריק.
aueYear

string (int64 format)

ערך שלם של השנה שתואם לתאריך התפוגה של העדכון האוטומטי באזור הזמן UTC. אם התוקף של המכשיר כבר פג, השדה הזה יהיה ריק.
expired

boolean

ערך בוליאני שמציין אם התוקף של המכשיר כבר פג או לא.

חודש

מייצג חודש ביומן הגרגוריאני.

טיפוסים בני מנייה (enum)
MONTH_UNSPECIFIED החודש שלא צוין.
JANUARY החודש ינואר.
FEBRUARY החודש פברואר.
MARCH החודש מרץ.
APRIL חודש אפריל.
MAY החודש של מאי.
JUNE החודש יוני.
JULY החודש יולי.
AUGUST חודש אוגוסט.
SEPTEMBER החודש ספטמבר.
OCTOBER חודש אוקטובר.
NOVEMBER החודש נובמבר.
DECEMBER החודש של דצמבר.