Method: customers.reports.findSaasUsageProfiles

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

Żądanie HTTP

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

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 raportów do zwrócenia. Usługa może zwrócić mniej niż tę wartość. Jeśli nie zostanie określona, zostanie zwróconych maksymalnie 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 reports.findSaasUsageProfiles. Podaj go, aby pobrać następną stronę.
filter

string

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

Obsługiwane pola:

  • e-mail
  • orgUnitId
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime
orderBy

string

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

Obsługiwane pola:

  • e-mail
  • 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.findSaasUsageProfiles.

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

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

object (SaasUsageProfileReport)

Lista raportów o wykorzystaniu SaaS przez profil.
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 o wykorzystaniu SaaS przez profil, które pasują do żądania.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

SaasUsageProfileReport

Reprezentuje pojedynczy wpis raportu SaaS pogrupowany według profilu.

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

string

Tylko dane wyjściowe. Adres e-mail użytkownika.
profilePermanentId

string

Tylko dane wyjściowe. Stały identyfikator profilu.
firstNavigationTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa, kiedy ten profil po raz pierwszy przeszedł 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, kiedy ten profil ostatni raz przeszedł 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".
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.