Method: customers.reports.findSaasUsageBrowsers

Znajdź raporty dotyczące wykorzystania SaaS przez klienta pogrupowane według przeglądarek na podstawie podanych kryteriów wyszukiwania i sortowania.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customer

string

Wymagane. Zaciemniony identyfikator klienta z prefiksem „customers/C” lub „customers/my_customer”.

Parametry zapytania

Parametry
app

string

Wymagane. Nazwa aplikacji SaaS (np. ChatGPT, Gemini).
pageSize

integer

Opcjonalnie. Maksymalna liczba przeglądarek do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie zostanie określona, zostanie zwróconych maksymalnie 100 przeglądarek. Maksymalna wartość to 200. Wartości powyżej 200 zostaną zmienione na 200.
pageToken

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania reports.findSaasUsageBrowsers. Podaj go, aby pobrać następną stronę.
filter

string

Opcjonalnie. Wyrażenie filtru, które ogranicza zwracane raporty dotyczące przeglądarek SaaS. Obsługiwane operatory to: =, !=, <, <=, >, >=, :. Obsługiwane są operatory logiczne AND, OR i NOT.

Obsługiwane pola:

  • machine
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime
  • orgUnitId
orderBy

string

Opcjonalnie. Wyrażenie określające kolejność sortowania raportów dotyczących przeglądarek SaaS.

Obsługiwane pola:

  • machine
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime

Domyślna kolejność jest rosnąca. Aby określić kolejność malejącą dla pola, dodaj „desc”.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na metodę reports.findSaasUsageBrowsers.

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

Zapis JSON 
{
  "saasUsageBrowsers": [
    {
      object (SaasUsageBrowser)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
Pola
saasUsageBrowsers[]

object (SaasUsageBrowser)

Lista raportów dotyczących wykorzystania SaaS przez przeglądarki.
nextPageToken

string

Token, który można wysłać jako pageToken, aby pobrać następną stronę.
totalSize

string (int64 format)

Łączna liczba raportów dotyczących wykorzystania SaaS przez przeglądarki, które pasują do żądania.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

SaasUsageBrowser

Szczegóły dotyczące wykorzystania SaaS przez przeglądarkę.

Zapis JSON 
{
  "machine": string,
  "devicePermanentId": string,
  "firstNavigationTime": string,
  "lastNavigationTime": string,
  "orgUnitId": string,
  "osPlatform": enum (DeviceSystem),
  "osVersion": string
}
Pola
machine

string

Tylko dane wyjściowe. Nazwa komputera.
devicePermanentId

string

Tylko dane wyjściowe. Stały identyfikator urządzenia.
firstNavigationTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa, kiedy ta przeglądarka po raz pierwszy otworzyła aplikację.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
lastNavigationTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa, kiedy ta przeglądarka po raz ostatni otworzyła aplikację.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
orgUnitId

string

Tylko dane wyjściowe. Identyfikator jednostki organizacyjnej.
osPlatform

enum (DeviceSystem)

Tylko dane wyjściowe. Platforma systemu operacyjnego.
osVersion

string

Tylko dane wyjściowe. Wersja systemu operacyjnego.