Lot

Il est parfois impossible d'obtenir toutes les informations dont vous avez besoin dans un même rapport. C'est le cas, par exemple, lorsque vous avez des dimensions et des métriques incompatibles, ou si vous souhaitez regrouper des données de différentes manières.

Dans ce cas, vous devez générer plusieurs rapports.

De plus, le traitement par lot est un moyen efficace d'améliorer les performances de votre application en réduisant le nombre de requêtes.

Problème lié à l'envoi de plusieurs demandes indépendantes

Bien que cette solution soit simple à mettre en œuvre, l'envoi de plusieurs requêtes API en peu de temps peut entraîner des limites de quota.

Le quota est généralement limité à 1 requête par utilisateur et par seconde. Vous pouvez configurer cette valeur dans la console Google APIs, mais la meilleure solution consiste à éviter les requêtes parallèles et à créer plutôt des requêtes par lot.

Traitement des rapports par lot

Dans l'exemple d'une application pilotée par l'utilisateur, la première approche consisterait à combiner autant de requêtes indépendantes que possible en une seule requête par lot.

Rapport 1:10 principaux pays en août
Rapport 2:valeurs pour les mêmes 10 pays en juillet, à des fins de comparaison
Rapport 3:10 principaux canaux en août
Rapport 4:valeurs des 10 mêmes canaux en juillet, à titre de comparaison

Dans l'exemple ci-dessus, les rapports 1 et 3 sont indépendants, mais ils ne peuvent pas être combinés en un seul rapport, car ils présentent des répartitions différentes des données. Toutefois, ils peuvent être regroupés.

Les rapports 2 et 4 ne peuvent être générés qu'après avoir obtenu les résultats du premier lot, car nous devons définir un filtre approprié dans la requête. Celles-ci peuvent être exécutées en tant que deuxième lot, une fois que les résultats du premier sont arrivés.

Une autre option, qui permettrait de combiner toutes les requêtes en un seul lot, consisterait à renvoyer simplement toutes les valeurs pour juillet (au lieu de seulement les 10 premières), voire pour le mois d'août. Cette option peut s'avérer raisonnable selon la taille du compte AdSense concerné et la quantité de mémoire disponible pour votre application.

Comment procéder ?

Le traitement par lot est géré différemment dans chaque bibliothèque cliente. Vous devez donc consulter la documentation pour en savoir plus. Voici quelques liens vers la documentation correspondante disponible dans plusieurs bibliothèques clientes:

Étapes suivantes