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

To pole jest wymagane. Identyfikator klienta lub „my_customer” (z przedrostkiem „customers/”).

Parametry zapytania

Parametry
orgUnitId

string

Opcjonalnie. Pominięcie identyfikatora jednostki organizacyjnej spowoduje zwrócenie danych dotyczących wszystkich jednostek organizacyjnych.

minAueDate

string

Opcjonalnie. Maksymalna data ważności w formacie rrrr-mm-dd w strefie czasowej UTC. Jeśli jest uwzględniony, zwraca wszystkie urządzenia, które już wygasły, oraz urządzenia z automatyczną datą ważności równą dacie minimalnej lub późniejszą.

maxAueDate

string

Opcjonalnie. Maksymalna data ważności w formacie rrrr-mm-dd w strefie czasowej UTC. Jeśli jest uwzględniony, zwraca wszystkie urządzenia, które już wygasły, oraz urządzenia z datą automatyczną, która jest równa dacie maksymalnej lub wcześniejsza.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź zawierająca listę urządzeń, które wygasają w każdym miesiącu w wybranym przedziale czasu. Liczniki 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 dotyczący CountChromedevicesPerAueDateResponse zawiera liczbę urządzeń określonego modelu oraz zakres dat zakończenia automatycznych aktualizacji.

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

string

Publiczne nazwy modelu urządzeń.

count

string (int64 format)

Liczba urządzeń tego modelu.

aueMonth

enum (Month)

Wyliczenie miesiąca odpowiadającej 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ść całkowita rok odpowiadająca dacie zakończenia automatycznych aktualizacji w strefie czasowej UTC. Jeśli urządzenie utraciło już ważność, to pole jest puste.

expired

boolean

Wartość logiczna określająca, czy urządzenie utracił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 Marzec.
APRIL Kwiecień.
MAY Maj.
JUNE Czerwiec.
JULY Lipiec.
AUGUST Miesiąc sierpnia.
SEPTEMBER Wrzesień.
OCTOBER Październik.
NOVEMBER Listopad.
DECEMBER Grudzień.