Method: customers.reports.findSaasUsage

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

HTTP-Anfrage

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

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
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 FindSaasUsageReports-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für FindSaasUsageReports bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.
filter

string

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

Unterstützte Felder:

  • App
  • orgUnitId
  • firstNavigationTime
  • lastNavigationTime
  • Kategorie
  • Organisation
  • foundedYear
  • Hauptsitz
  • primaryDomain
  • Domains
  • encryptionProtocols
  • visitsCount
  • distinctUsersCount
  • distinctBrowsersCount
  • contentTransferCount

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

string

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

Unterstützte Felder:

  • App
  • Kategorie
  • Organisation
  • foundedYear
  • Hauptsitz
  • primaryDomain
  • visitsCount
  • distinctUsersCount
  • distinctBrowsersCount
  • contentTransferCount

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

Beispiel: visitsCount desc

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort auf die Methode reports.findSaasUsage.

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

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

object (SaasUsageReport)

Die Liste der SaaS-Nutzungsberichte.
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)

Gesamtzahl der SaaS-Nutzungsberichte, die der Anfrage entsprechen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

SaasUsageReport

Stellt einen einzelnen SaaS-Berichtseintrag dar.

JSON-Darstellung 
{
  "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
}
Felder
app

string

Nur Ausgabe. Der Name der Anwendung.
orgUnitId

string

Nur Ausgabe. Die ID der Organisationseinheit.
category

string

Nur Ausgabe. Die Kategorie der Anwendung.
organization

string

Nur Ausgabe. Die Organisation, die die Anwendung entwickelt.
foundedYear

integer

Nur Ausgabe. Das Gründungsjahr der Organisation.
headquarters

string

Nur Ausgabe. Der Hauptsitz der Organisation.
primaryDomain

string

Nur Ausgabe. Die primäre Domain der Anwendung.
domains[]

string

Nur Ausgabe. Eine Liste der Domains und Subdomains, die mit der Anwendung verknüpft sind.
encryptionProtocols[]

string

Nur Ausgabe. Eine Liste der Verschlüsselungsprotokolle, die für den Zugriff auf die Anwendung verwendet werden.
visitsCount

string (int64 format)

Nur Ausgabe. Gesamtzahl der Besuche der Anwendung.
distinctUsersCount

string (int64 format)

Nur Ausgabe. Anzahl der einzelnen Nutzer, die die Anwendung besucht haben.
distinctBrowsersCount

string (int64 format)

Nur Ausgabe. Anzahl der einzelnen Browser, die die Anwendung besucht haben.
contentTransferDetails

object (ContentTransferDetails)

Nur Ausgabe. Enthält Informationen zu Ereignissen der Inhaltsübertragung, falls verfügbar.
firstNavigationTime

string (Timestamp format)

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

ContentTransferDetails

Enthält Informationen zu Ereignissen der Inhaltsübertragung, falls verfügbar.

JSON-Darstellung 
{
  "contentTransferCount": string
}
Felder
contentTransferCount

string (int64 format)

Nur Ausgabe. Gesamtzahl der Inhaltsübertragungen, die mit der Anwendung verknüpft sind.