Method: customers.enterprise.securityInsights.queryContentTransfersBreakdowns

Gibt Zusammenfassungen von Inhaltsübertragungen für einen bestimmten Messwert und eine bestimmte Aufschlüsselungsdimension zurück.

HTTP-Anfrage

GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/enterprise/securityInsights:queryContentTransfersBreakdowns

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customer

string

Erforderlich. Die Kunden-ID im Format „customers/{customer_id}“.

Suchparameter

Parameter
pageSize

integer

Optional. Die maximale Anzahl der zurückzugebenden Aufschlüsselungen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 50 Aufschlüsselungen zurückgegeben. Der Höchstwert beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt.
pageToken

string

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

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

string

Optional. Der Filter, der auf die Anfrage angewendet werden soll. Informationen zur Syntax finden Sie unter AIP-160. Daten sind nicht für Ereignisse verfügbar, die älter als 180 Tage oder jünger als 48 Stunden sind. Wenn event_time nicht angegeben ist, enden die Ergebnisse vor 48 Stunden.

Unterstützte Felder zum Filtern: - user - event_domain - content_category - event_time

Wenn Sie nach user oder event_domain filtern, muss die Dimension breakdown auf den entsprechenden Wert festgelegt sein. Wenn Sie beispielsweise nach user filtern möchten, müssen Sie breakdown = USER festlegen.

Unterstützte Operatoren: - = für user, event_domain und content_category. – <= für event_time.

Unterstützte Konjunktionen: - AND

Beispiel: user = "testuser" AND event_time <= "2024-01-02T00:00:00Z"
metric

enum (ContentTransfersMetric)

Optional. Der Messwert, für den die Aufschlüsselungen zurückgegeben werden sollen. Die Standardeinstellung ist CONTENT_TRANSFERS_METRIC_TOTAL_TRANSFERS.
breakdown

enum (ContentTransfersBreakdownDimension)

Optional. Die Dimension, nach der die Inhaltsübertragungen aufgeschlüsselt werden. Die Standardeinstellung ist USER.
fixedTimeRange

enum (FixedTimeRange)

Optional. Der feste Zeitraum, für den die Aufschlüsselungen zurückgegeben werden sollen. Die Standardeinstellung ist FIXED_TIME_RANGE_FOUR_WEEKS. Es werden feste Zeiträume verwendet, um eine Vorberechnung zu ermöglichen und die Reaktionszeiten zu optimieren.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für securityInsights.queryContentTransfersBreakdowns.

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

JSON-Darstellung 
{
  "contentTransfersBreakdowns": [
    {
      object (ContentTransfersBreakdown)
    }
  ],
  "nextPageToken": string
}
Felder
contentTransfersBreakdowns[]

object (ContentTransfersBreakdown)

Die Aufschlüsselungen der Inhaltsübertragung aus dem angegebenen Insight.
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.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

ContentTransfersBreakdownDimension

Die Dimension, nach der die Inhaltsübertragungen aufgeschlüsselt werden.

Enums
CONTENT_TRANSFERS_BREAKDOWN_DIMENSION_UNSPECIFIED Nicht angegebene Aufschlüsselungsdimension. Die Standardeinstellung ist USER.
USER Nach Nutzer aufschlüsseln.
EVENT_DOMAIN Aufschlüsselung nach Ereignisdomain.
CONTENT_CATEGORY Aufschlüsselung nach Inhaltskategorie.

ContentTransfersBreakdown

Eine Zusammenfassung der Inhaltsübertragungen für eine bestimmte Aufschlüsselungsdimension.

JSON-Darstellung 
{
  "summary": {
    object (ContentTransfersSummary)
  },

  // Union field dimension can be only one of the following:
  "user": string,
  "eventDomain": string,
  "contentCategory": string
  // End of list of possible types for union field dimension.
}
Felder
summary

object (ContentTransfersSummary)

Die Zusammenfassung der Inhaltsübertragungen für die Aufschlüsselungsdimension.
Union-Feld dimension. Die Dimension für die Aufschlüsselung. Für dimension ist nur einer der folgenden Werte zulässig:
user

string

Der Nutzer, der die Inhalte übertragen hat.
eventDomain

string

Die Ereignisdomain der Inhaltsübertragungen.
contentCategory

string

Die Inhaltskategorie der Inhaltsübertragungen.