Method: customers.enterprise.securityInsights.queryContentTransfersBreakdowns

Renvoie des récapitulatifs des transferts de contenu pour une métrique et une dimension de répartition données.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customer

string

Obligatoire. ID client au format "customers/{customer_id}".

Paramètres de requête

Paramètres
pageSize

integer

Facultatif. Nombre maximal de répartitions à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, au maximum 50 répartitions sont renvoyées. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000.
pageToken

string

Facultatif. Jeton de page reçu d'un appel securityInsights.queryContentTransfersBreakdowns précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à securityInsights.queryContentTransfersBreakdowns doivent correspondre à l'appel ayant fourni le jeton de page.
filter

string

Facultatif. Filtre à appliquer à la requête. Pour la syntaxe, consultez la section AIP-160. Les données ne sont pas disponibles pour les événements datant de plus de 180 jours ou de moins de 48 heures. Si event_time n'est pas spécifié, les résultats s'arrêteront il y a 48 heures.

Champs compatibles pour le filtrage : - user - event_domain - content_category - event_time

Le filtrage par user ou event_domain nécessite que la dimension breakdown soit définie sur la valeur correspondante (par exemple, vous devez définir breakdown = USER pour filtrer par user).

Opérateurs compatibles : - = pour user, event_domain et content_category. - <= pour event_time.

Conjonctions compatibles : - AND

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

enum (ContentTransfersMetric)

Facultatif. Métrique pour laquelle renvoyer les répartitions. La valeur par défaut est CONTENT_TRANSFERS_METRIC_TOTAL_TRANSFERS.
breakdown

enum (ContentTransfersBreakdownDimension)

Facultatif. Dimension selon laquelle répartir les transferts de contenu. La valeur par défaut est USER.
fixedTimeRange

enum (FixedTimeRange)

Facultatif. Plage de dates fixe pour laquelle renvoyer les répartitions. La valeur par défaut est FIXED_TIME_RANGE_FOUR_WEEKS. Les plages de dates fixes sont utilisées pour permettre le précalcul et optimiser les délais de réponse.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Message de réponse pour securityInsights.queryContentTransfersBreakdowns.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "contentTransfersBreakdowns": [
    {
      object (ContentTransfersBreakdown)
    }
  ],
  "nextPageToken": string
}
Champs
contentTransfersBreakdowns[]

object (ContentTransfersBreakdown)

Répartitions des transferts de contenu à partir de l'insight spécifié.
nextPageToken

string

Jeton pouvant être envoyé en tant que pageToken pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

Niveaux d'accès des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

ContentTransfersBreakdownDimension

Dimension selon laquelle répartir les transferts de contenu.

Enums
CONTENT_TRANSFERS_BREAKDOWN_DIMENSION_UNSPECIFIED Dimension de répartition non spécifiée. La valeur par défaut est USER.
USER Répartition par utilisateur.
EVENT_DOMAIN Répartition par domaine d'événement.
CONTENT_CATEGORY Répartition par catégorie de contenu.

ContentTransfersBreakdown

Récapitulatif des transferts de contenu pour une dimension de répartition donnée.

Représentation JSON 
{
  "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.
}
Champs
summary

object (ContentTransfersSummary)

Récapitulatif des transferts de contenu pour la dimension de répartition.
Champ d'union dimension. Dimension de la répartition. dimension ne peut être qu'un des éléments suivants :
user

string

Utilisateur qui a transféré le contenu.
eventDomain

string

Domaine d'événement des transferts de contenu.
contentCategory

string

Catégorie de contenu des transferts de contenu.