Method: customers.reports.findSaasUsage

Znajdź raporty dotyczące wykorzystania SaaS przez klienta na podstawie podanych kryteriów wyszukiwania i sortowania.

Żądanie HTTP

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

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
pageSize

integer

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

string

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

Podczas paginacji wszystkie inne parametry przekazane do FindSaasUsageReports muszą być zgodne z wywołaniem, które dostarczyło token strony.
filter

string

Opcjonalnie. Wyrażenie filtra, które ogranicza liczbę zwracanych raportów SaaS. Obsługiwane operatory to: =, !=, <, <=, >, >=, :. Obsługiwane są operatory logiczne AND, OR i NOT.

Obsługiwane pola:

  • aplikacja
  • orgUnitId
  • firstNavigationTime
  • lastNavigationTime
  • kategoria
  • organizacja
  • foundedYear
  • siedziba główna
  • primaryDomain
  • domeny
  • encryptionProtocols
  • visitsCount
  • distinctUsersCount
  • distinctBrowsersCount
  • contentTransferCount

Przykład: (firstNavigationTime < "2026-01-31T00:00:00Z" AND lastNavigationTime > "2026-01-01T00:00:00Z") AND visitsCount > 100
orderBy

string

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

Obsługiwane pola:

  • aplikacja
  • kategoria
  • organizacja
  • foundedYear
  • siedziba główna
  • primaryDomain
  • visitsCount
  • distinctUsersCount
  • distinctBrowsersCount
  • contentTransferCount

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

Przykład: visitsCount desc

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na metodę reports.findSaasUsage.

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

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

object (SaasUsageReport)

Lista raportów dotyczących wykorzystania SaaS.
nextPageToken

string

Token, który można wysłać jako pageToken, aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.
totalSize

string (int64 format)

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

SaasUsageReport

Reprezentuje pojedynczy wpis raportu SaaS.

Zapis JSON 
{
  "app": string,
  "orgUnitId": string,
  "category": string,
  "organization": string,
  "foundedYear": integer,
  "headquarters": string,
  "primaryDomain": string,
  "domains": [
    string
  ],
  "encryptionProtocols": [
    string
  ],
  "visitsCount": string,
  "distinctUsersCount": string,
  "distinctBrowsersCount": string,
  "contentTransferDetails": {
    object (ContentTransferDetails)
  },
  "firstNavigationTime": string,
  "lastNavigationTime": string
}
Pola
app

string

Tylko dane wyjściowe. Nazwa aplikacji.
orgUnitId

string

Tylko dane wyjściowe. Identyfikator jednostki organizacyjnej.
category

string

Tylko dane wyjściowe. Kategoria aplikacji.
organization

string

Tylko dane wyjściowe. Organizacja, która opracowuje aplikację.
foundedYear

integer

Tylko dane wyjściowe. Rok założenia organizacji.
headquarters

string

Tylko dane wyjściowe. Siedziba główna organizacji.
primaryDomain

string

Tylko dane wyjściowe. Główna domena aplikacji.
domains[]

string

Tylko dane wyjściowe. Lista domen i subdomen powiązanych z aplikacją.
encryptionProtocols[]

string

Tylko dane wyjściowe. Lista protokołów szyfrowania używanych do uzyskiwania dostępu do aplikacji.
visitsCount

string (int64 format)

Tylko dane wyjściowe. Łączna liczba wizyt w aplikacji.
distinctUsersCount

string (int64 format)

Tylko dane wyjściowe. Liczba unikalnych użytkowników, którzy odwiedzili aplikację.
distinctBrowsersCount

string (int64 format)

Tylko dane wyjściowe. Liczba unikalnych przeglądarek, które odwiedziły aplikację.
contentTransferDetails

object (ContentTransferDetails)

Tylko dane wyjściowe. Zawiera informacje o zdarzeniach przesyłania treści, jeśli są dostępne.
firstNavigationTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa pierwszego przejścia do aplikacji.

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 ostatniego przejścia do aplikacji.

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".

ContentTransferDetails

Zawiera informacje o zdarzeniach przesyłania treści, jeśli są dostępne.

Zapis JSON 
{
  "contentTransferCount": string
}
Pola
contentTransferCount

string (int64 format)

Tylko dane wyjściowe. Łączna liczba transferów treści powiązanych z aplikacją.