Method: customers.reports.findSaasUsageBrowsers

SaaS-Nutzungsberichte eines Kunden nach Browsern gruppiert, basierend auf den angegebenen Such- und Sortierkriterien.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customer

string

Erforderlich. Verschleierte Kunden-ID 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 Browser. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 100 Browser zurückgegeben. Der Maximalwert ist 200. Werte über 200 werden auf 200 festgelegt.
pageToken

string

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

string

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

Unterstützte Felder:

  • machine
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime
  • orgUnitId
orderBy

string

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

Unterstützte Felder:

  • machine
  • 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.findSaasUsageBrowsers.

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

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

object (SaasUsageBrowser)

Die Liste der SaaS-Nutzungsberichte für Browser.
nextPageToken

string

Ein Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen.
totalSize

string (int64 format)

Gesamtzahl der SaaS-Nutzungsberichte für Browser, die der Anfrage entsprechen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

SaasUsageBrowser

Details zu einem SaaS-Nutzungsbrowser.

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

string

Nur Ausgabe. Der Name des Computers.
devicePermanentId

string

Nur Ausgabe. Die permanente Geräte-ID.
firstNavigationTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel, als die Anwendung zum ersten Mal von diesem Browser 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, als die Anwendung zuletzt von diesem Browser 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.