Method: customers.enterprise.securityInsights.queryUrlVisitsBreakdowns

Gibt Zusammenfassungen der URL-Besuche für einen bestimmten Messwert und eine bestimmte Dimension zur Aufschlüsselung zurück.

HTTP-Anfrage

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

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

Beim Paginieren müssen alle anderen für securityInsights.queryUrlVisitsBreakdowns 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 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 für die Filterung: - user - event_domain - event_time

Für die Filterung nach user oder event_domain muss die Dimension breakdown auf den entsprechenden Wert festgelegt werden. Sie müssen beispielsweise breakdown = USER festlegen, um nach user zu filtern.

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

Unterstützte Verknüpfungen: - AND

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

enum (UrlVisitsMetric)

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

enum (UrlVisitsBreakdownDimension)

Optional. Die Dimension, nach der die URL-Besuche aufgeschlüsselt werden sollen. 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. Feste Zeiträume werden verwendet, um die Vorberechnung zu ermöglichen und die Antwortzeiten zu optimieren.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für securityInsights.queryUrlVisitsBreakdowns.

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

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

object (UrlVisitsBreakdown)

Die Aufschlüsselungen der URL-Besuche 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

UrlVisitsBreakdownDimension

Die Dimension, nach der die URL-Besuche aufgeschlüsselt werden sollen.

Enums
URL_VISITS_BREAKDOWN_DIMENSION_UNSPECIFIED Nicht angegebene Dimension zur Aufschlüsselung. Die Standardeinstellung ist USER.
USER Aufschlüsselung nach Nutzer.
EVENT_DOMAIN Aufschlüsselung nach Ereignisdomain.

UrlVisitsBreakdown

Eine Zusammenfassung der URL-Besuche für eine bestimmte Dimension zur Aufschlüsselung.

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

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

object (UrlVisitsSummary)

Die Zusammenfassung der URL-Besuche für die Dimension zur Aufschlüsselung.
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 URL besucht hat.
eventDomain

string

Die Ereignisdomain der URL-Besuche.