Quota basé sur les ressources

Ce document décrit le système de quotas basés sur les ressources pour l'API Google Analytics Reporting v4, qui n'est disponible que pour les clients Analytics 360. Consultez les limites et quotas d'API pour connaître l'ensemble des limites appliquées aux API.

La fonctionnalité de quota basé sur les ressources est actuellement disponible pour tous les clients Analytics 360.

Introduction

Pour garantir la disponibilité et la fiabilité des ressources partagées, chaque projet qui accède à l'API Analytics Reporting est soumis à des limites et quotas. Lorsque vous interrogez des ensembles de données volumineux, l'API Reporting peut utiliser l'échantillonnage, ce qui peut affecter les résultats de vos données.

Le système de quotas basés sur les ressources est un nouveau système de quotas qui permet aux comptes Analytics 360 d'avoir des seuils d'échantillonnage plus élevés lorsqu'ils utilisent l'API Analytics Reporting. Ce système est facultatif et indépendant des limites imposées aux vues et aux projets existants, tels que ceux indiqués sur la page des quotas de la console Google APIs.

Quota basé sur les ressources

Toutes les requêtes ne se valent pas. Certaines sont plus coûteuses en calcul que d'autres. Le système de quotas basés sur les ressources est conçu pour accepter un seuil plus élevé d'échantillonnage tout en protégeant l'infrastructure des rapports Analytics.

Une quantité définie de jetons de ressource de requête est allouée à chaque propriété. Le client API peut ajouter un champ facultatif à la requête API afin d'obtenir un seuil plus élevé d'échantillonnage en échange des jetons de ressource de requête relatifs. Une requête plus coûteuse en calcul nécessite davantage de jetons.

Seuil d'échantillonnage

Les requêtes de données qui utilisent la version 4 de l'API Google Analytics sont soumises aux seuils d'échantillonnage généraux suivants, qui dépendent du nombre de sessions pour la plage de dates demandée (au niveau de la propriété):

• Analytics standard: 500 000 sessions
• Analytics 360: un million de sessions
• Analytics 360 utilise un quota basé sur les ressources: 100 millions de sessions

Activer le quota basé sur les ressources

Afin d'activer les quotas basés sur les ressources pour une requête donnée, l'appel d'API doit inclure le champ facultatif useResourceQuotas dans la méthode batchGet.

{
  "reportRequests": [{object(ReportRequest)}],
  "useResourceQuotas": boolean,
}

Exemple :

{
  "reportRequests":[
  {
    "viewId":"XXXX",
    "dateRanges":[
      {
        "startDate":"2017-06-15",
        "endDate":"2017-06-30"
      }],
    "metrics":[
      {
        "expression":"ga:sessions"
      }],
    "dimensions": [
      {
        "name":"ga:browser"
      }]
    }],
  "useResourceQuotas": true
}

Champ de réponse du coût de la ressource de requête

Pour chaque appel à la méthode batchGet, la réponse comportera un champ queryCost.

{
  "reports": [{ object(Report) }],
  "queryCost": number
}

Le champ queryCost est un entier représentant le coût total des ressources de tous les ReportRequests dans la requête batchGet. Exemple :

{
  "reports": [
    {
      "columnHeader": {...},
      "data": {
        "rows": [...]
      }
    }
  ],
  "queryCost": 1337
}

Allocation de quotas

Quota de propriété Analytics 360

• 100 000 unités de coût des requêtes par jour et par propriété
• 25 000 unités de coût de requête par heure et par propriété.

Si vous dépassez votre limite de quota, vous recevrez un message d'erreur RESOURCE_EXHAUSTED. Pour en savoir plus, consultez Réponses d'erreur.

Remarque : Ces valeurs sont préliminaires et peuvent changer pendant et/ou après la période bêta.

Important : Les quotas quotidiens sont actualisés à minuit PST.

Calcul des coûts

Le coût d'une requête est proportionnel à:

• Taille de la plage de dates.
• Nombre d'appels dans la vue.
• Cardinalité des dimensions demandées.
• Nombre de dimensions et de métriques demandées.
• Complexité des définitions de segments et de filtres
• État du traitement des informations demandées (les données du jour sont plus coûteuses que les données de la veille).
• Présence de dimensions et de métriques d'importation au moment de la requête

Remarque:Si une requête expire, ce qui entraîne une réponse 5XX, le coût du quota de ressources sera toujours facturé. Consultez la page Réponse d'erreur pour en savoir plus sur l'implémentation d'un intervalle exponentiel entre les tentatives, afin d'éviter une utilisation excessive des quotas.

Limites et utilisation des API

Outre le système de quotas basés sur les ressources, les API sont également soumises aux limites et quotas de l'API Analytics v4.

Remarques

• Le champ de réponse queryCost représente le coût de calcul d'une requête. Il ne s'agit pas d'un coût monétaire, et l'API est offerte.
• Quel que soit le paramètre useResourceQuotas, des données intrajournalières et certaines données de l'historique (plus de 1 an) peuvent toujours être échantillonnées.
• Si un seuil d'échantillonnage plus élevé ne peut pas être satisfait pour une requête, les jetons de quota de ressources ne sont pas déduits (le coût des quotas de ressources est toujours nul).
• Un rapport contient des données échantillonnées si les champs samplesReadCounts et samplingSpaceSizes sont présents dans la réponse.

Pour afficher ou modifier les limites d'utilisation de votre projet, ou pour demander une augmentation des quotas, procédez comme suit :

1. Si vous ne possédez pas encore de compte de facturation pour votre projet, créez-en un.
2. Accédez à la page "API activées" de la bibliothèque d'API dans la console API, puis sélectionnez une API dans la liste.
3. Sélectionnez Quotas pour afficher et modifier les paramètres associés aux quotas. Pour afficher les statistiques d'utilisation, sélectionnez Utilisation.