Method: customers.reports.countChromeDevicesReachingAutoExpirationDate

Wygeneruj raport o liczbie urządzeń, które tracą ważność każdego miesiąca w wybranym okresie. Urządzenia są pogrupowane według daty zakończenia automatycznych aktualizacji i modelu. Więcej informacji znajdziesz tutaj.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customer

string

Wymagane. Identyfikator klienta lub „my_customer” z prefiksem „customers/”.

Parametry zapytania

Parametry
orgUnitId

string

Opcjonalnie: Jeśli identyfikator jednostki organizacyjnej jest pominięty, zwracane są dane ze wszystkich jednostek organizacyjnych.

minAueDate

string

Opcjonalnie: Maksymalna data ważności w formacie rrrr-mm-dd w strefie czasowej UTC. Jeśli uwzględnione, zwraca wszystkie urządzenia, których ważność już wygasła, oraz urządzenia z automatyczną datą ważności równą lub późniejszą niż minimalna data.

maxAueDate

string

Opcjonalnie: Maksymalna data ważności w formacie rrrr-mm-dd w strefie czasowej UTC. Jeśli uwzględnione, zwraca wszystkie urządzenia, których ważność wygasła, oraz urządzenia z automatyczną datą wygaśnięcia równą lub wcześniejszą niż maksymalna data.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź zawierająca listę urządzeń, które tracą ważność każdego miesiąca w wybranym okresie. Liczby są grupowane według modelu i daty zakończenia automatycznych aktualizacji.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "deviceAueCountReports": [
    {
      object (DeviceAueCountReport)
    }
  ]
}
Pola
deviceAueCountReports[]

object (DeviceAueCountReport)

Lista raportów posortowana według daty zakończenia automatycznych aktualizacji w kolejności rosnącej.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/chrome.management.reports.readonly

DeviceAueCountReport

Raport CountChromeDevicesPerAueDateResponse zawiera liczbę urządzeń danego modelu i zakres daty zakończenia automatycznych aktualizacji.

Zapis JSON
{
  "model": string,
  "count": string,
  "aueMonth": enum (Month),
  "aueYear": string,
  "expired": boolean
}
Pola
model

string

Publiczna nazwa modelu urządzeń.

count

string (int64 format)

Liczba urządzeń tego modelu.

aueMonth

enum (Month)

Wartość enumeracji miesiąca odpowiadająca dacie zakończenia automatycznych aktualizacji w strefie czasowej UTC. Jeśli urządzenie utraciło już ważność, to pole jest puste.

aueYear

string (int64 format)

Wartość typu int odpowiadająca roku odpowiadającemu dacie zakończenia automatycznych aktualizacji w strefie czasowej UTC. Jeśli urządzenie utraciło ważność, to pole jest puste.

expired

boolean

Wartość logiczna wskazująca, czy urządzenie straciło już ważność.

Miesiąc

Reprezentuje miesiąc w kalendarzu gregoriańskim.

Wartości w polu enum
MONTH_UNSPECIFIED Nieokreślony miesiąc.
JANUARY Styczeń.
FEBRUARY Luty.
MARCH W marcu.
APRIL Kwiecień.
MAY W maju.
JUNE Czerwiec.
JULY Lipiec.
AUGUST Sierpień.
SEPTEMBER Wrzesień.
OCTOBER Październik.
NOVEMBER Listopad.
DECEMBER Grudzień.