Method: customers.reports.findSaasUsageProfiles

SaaS-Nutzungsberichte eines Kunden nach Profilen gruppiert anhand der angegebenen Such- und Sortierkriterien suchen.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customer

string

Erforderlich. Verschleierte Kundennummer mit dem Präfix „customers/C“ oder „customers/my_customer“.

Suchparameter

Parameter
app

string

Erforderlich. Der Name der SaaS-Anwendung (z.B. ChatGPT, Gemini).
pageSize

integer

Optional. Die maximale Anzahl der zurückzugebenden Berichte. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 100 Berichte zurückgegeben. Der Maximalwert ist 200. Werte über 200 werden auf 200 festgelegt.
pageToken

string

Optional. Ein Seitentoken, das von einem vorherigen reports.findSaasUsageProfiles-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.
filter

string

Optional. Der Filterausdruck, um die zurückzugebenden SaaS-Profilberichte einzugrenzen. Unterstützte Operatoren sind: =, !=, <, <=, >, >=, :. Die logischen Operatoren AND, OR und NOT werden unterstützt.

Unterstützte Felder:

  • E-Mail
  • orgUnitId
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime
orderBy

string

Optional. Der Ausdruck für die Sortierung der SaaS-Profilberichte.

Unterstützte Felder:

  • E-Mail
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime

Die Standardreihenfolge ist aufsteigend. Wenn Sie absteigend sortieren möchten, nutzen Sie das Suffix „desc“.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort auf die Methode reports.findSaasUsageProfiles.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "profileReports": [
    {
      object (SaasUsageProfileReport)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
Felder
profileReports[]

object (SaasUsageProfileReport)

Die Liste der SaaS-Nutzungsprofilberichte.
nextPageToken

string

Ein Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.
totalSize

string (int64 format)

Die Gesamtzahl der SaaS-Nutzungsprofilberichte, die der Anfrage entsprechen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

SaasUsageProfileReport

Stellt einen einzelnen SaaS-Berichteintrag dar, der nach Profil gruppiert ist.

JSON-Darstellung 
{
  "email": string,
  "profilePermanentId": string,
  "firstNavigationTime": string,
  "lastNavigationTime": string,
  "orgUnitId": string,
  "osPlatform": enum (DeviceSystem),
  "osVersion": string
}
Felder
email

string

Nur Ausgabe. Die E-Mail-Adresse des Nutzers.
profilePermanentId

string

Nur Ausgabe. Die permanente ID des Profils.
firstNavigationTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel, wann die Anwendung zum ersten Mal von diesem Profil aufgerufen wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
lastNavigationTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel, wann die Anwendung zuletzt von diesem Profil aufgerufen wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
orgUnitId

string

Nur Ausgabe. Die ID der Organisationseinheit.
osPlatform

enum (DeviceSystem)

Nur Ausgabe. Die Betriebssystemplattform.
osVersion

string

Nur Ausgabe. Version des Betriebssystems.