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)

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

string (int64 format)

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

boolean

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

חודש

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

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