Quota basé sur les ressources

Ce document décrit le système de quotas basés sur les ressources de la version 4 de l'API Reporting de Google Analytics, disponible uniquement pour les clients Analytics 360. Consultez la page Limites et quotas d'API pour connaître l'ensemble des limites appliquées aux API.

La fonctionnalité de quotas en fonction des ressources est actuellement disponible pour tous les clients Analytics 360.

Présentation

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 des quotas. Lorsque vous interrogez des ensembles de données volumineux, l'API Analytics Reporting peut utiliser l'échantillonnage, ce qui peut affecter les résultats de vos données.

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

Quota basé sur les ressources

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

Une quantité définie de jetons de ressources de requête sera allouée à chaque propriété. Le client API peut ajouter un champ facultatif à la requête API pour obtenir un seuil d'échantillonnage plus élevé en échange des jetons de ressource de requête relatifs. Une requête plus coûteuse en calcul nécessitera 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, en fonction du nombre de sessions pour la période demandée (au niveau de la propriété):

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

Activer le quota basé sur les ressources

Pour 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 des ressources de la requête

Pour chaque appel de la méthode batchGet, la réponse contiendra 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 de la requête batchGet. Exemple :

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

Allocation de quotas

Quota des propriétés Analytics 360

• 100 000 unités de coût de requête 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, une erreur RESOURCE_EXHAUSTED s'affiche. Pour en savoir plus, consultez la section 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 segment et de filtre.
• État du traitement des informations demandées (demander les données du jour est plus coûteux que celles de la veille).
• La présence de dimensions et de métriques Importation au moment de la requête.

Remarque :Lorsqu'une requête expire et qu'elle génère une réponse 5XX, le coût du quota de ressources est toujours facturé. Consultez la page Réponse d'erreur pour savoir comment implémenter un intervalle exponentiel entre les tentatives afin d'éviter une utilisation excessive des quotas.

Limites et utilisation des API

En plus du système de quotas basé sur les ressources, les API sont également régies par les limites et les quotas de l'API Analytics v4.

Notes

• 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 et l'utilisation de l'API est sans frais.
• Les rapports intrajournaliers et certaines données historiques (datant d'au moins un an) peuvent toujours faire l'objet d'un échantillonnage, quel que soit le paramètre useResourceQuotas.
• Si un seuil d'échantillonnage plus élevé n'a pas pu être satisfait pour une requête, les jetons de quota de ressources ne sont pas déduits (les réponses échantillonnées ont toujours un coût de quota de ressources égal à zéro).
• Un rapport contient des échantillons de donné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 APIs, 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.