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

הדוח ל-CountChromeDevicePerAueDateResponse, מכיל את ספירת המכשירים בדגם ספציפי ואת טווח התפוגה של העדכון האוטומטי.

ייצוג 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

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

חודש

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

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