REST Resource: customerUsageReports

Ressource: UsageReports

JSON-Darstellung
{
  "kind": string,
  "etag": string,
  "warnings": [
    {
      "code": string,
      "message": string,
      "data": [
        {
          "key": string,
          "value": string
        }
      ]
    }
  ],
  "usageReports": [
    {
      object (UsageReport)
    }
  ],
  "nextPageToken": string
}
Felder
kind

string

Der Typ der API-Ressource. Für einen Nutzungsbericht lautet der Wert admin#reports#usageReports.

etag

string

ETag der Ressource.

warnings[]

object

Gegebenenfalls Warnungen.

warnings[].code

string

Maschinenlesbarer Code oder Warntyp. Der Warncodewert ist 200.

warnings[].message

string

Die für Menschen lesbaren Nachrichten für eine Warnung sind:

  • Warnung zu Daten nicht verfügbar: Die Daten für das Datum jjjj-mm-tt für die Anwendung "application name" sind nicht verfügbar.
  • Warnung bei unvollständigen Daten – Daten für das Datum jjjj-mm-tt für die App application name sind derzeit nicht verfügbar. Bitte versuchen Sie es in einigen Stunden noch einmal.

warnings[].data[]

object

Schlüssel/Wert-Paare, um detaillierte Informationen zur Warnung bereitzustellen.

warnings[].data[].key

string

Schlüssel, der mit einem Schlüssel/Wert-Paar verknüpft ist, um detaillierte Informationen zur Warnung bereitzustellen.

warnings[].data[].value

string

Wert, der einem Schlüssel/Wert-Paar zugeordnet ist, um detaillierte Informationen zur Warnung bereitzustellen.

usageReports[]

object (UsageReport)

Verschiedene Datensätze mit Anwendungsparametern.

nextPageToken

string

Token zur Angabe der nächsten Seite. Ein Bericht mit mehreren Seiten enthält in der Antwort die Property nextPageToken. Wenn Ihre Folgeanfragen alle Berichtsseiten abrufen sollen, geben Sie den nextPageToken-Wert in den Abfragestring pageToken ein.

Nutzungsbericht

JSON-Vorlage für einen Nutzungsbericht.

JSON-Darstellung
{
  "kind": string,
  "date": string,
  "parameters": [
    {
      "intValue": string,
      "name": string,
      "stringValue": string,
      "datetimeValue": string,
      "boolValue": boolean,
      "msgValue": [
        {
          object
        }
      ]
    }
  ],
  "etag": string,
  "entity": {
    "customerId": string,
    "userEmail": string,
    "profileId": string,
    "entityId": string,
    "type": string
  }
}
Felder
kind

string

Der Typ der API-Ressource. Für einen Nutzungsbericht lautet der Wert admin#reports#usageReport.

date

string

Nur Ausgabe. Das Datum der Berichtsanfrage.

parameters[]

object

Nur Ausgabe. Parameterwerte für verschiedene Anwendungen. Parameter und Werte für den Bericht zur Entitätsnutzung finden Sie in der Referenz zu Parametern für die Entitätsnutzung.

parameters[].intValue

string (int64 format)

Nur Ausgabe. Ganzzahlwert des Parameters.

parameters[].name

string

Name des Parameters. Die Parameternamen der Nutzernutzungsberichte finden Sie in der Referenz zu Parametern für die Nutzernutzung.

parameters[].stringValue

string

Nur Ausgabe. Stringwert des Parameters.

parameters[].datetimeValue

string

Der RFC 3339-formatierte Wert des Parameters, z. B. 2010-10-28T10:26:35.000Z.

parameters[].boolValue

boolean

Nur Ausgabe. Boolescher Wert des Parameters.

parameters[].msgValue[]

object (Struct format)

Nur Ausgabe. Verschachtelter Nachrichtenwert des Parameters.

etag

string

ETag der Ressource.

entity

object

Nur Ausgabe. Informationen zum Elementtyp

entity.customerId

string

Nur Ausgabe. Die eindeutige Kennung des Kundenkontos.

entity.userEmail

string

Nur Ausgabe. Die E-Mail-Adresse des Nutzers. Nur relevant, wenn Entitätstyp = "USER"

entity.profileId

string

Nur Ausgabe. Die unveränderliche Google Workspace-Profil-ID des Nutzers.

entity.entityId

string

Nur Ausgabe. Objektschlüssel. Nur relevant, wenn entity.type = "Object" Hinweis: Der nach außen gerichtete Name des Berichts ist "Entities" statt "Objects".

entity.type

string

Nur Ausgabe. Der Elementtyp. Der Wert ist user.

Methoden

get

Ruft einen Bericht mit einer Reihe von Properties und Statistiken für das Konto eines bestimmten Kunden ab