Les requêtes sur le chiffre d’affaires d’un compte nécessitent la permission
stats:read. Consultez
Permissions pour demander des permissions pour votre application.Découvrir les métriques
Listez les métriques de séries temporelles pour obtenir leurs clés, noms, unités, descriptions et propriétés filtrables :key d’une métrique, comme gross_revenue, dans la requête suivante. Son tableau properties liste les propriétés selon lesquelles vous pouvez filtrer ou ventiler.
Récupérer une série temporelle
Transmettez l’ID de votre compte et une plage de dates à Retrieve metric time series :data.points de la réponse contient un timestamp Unix en secondes et une value pour chaque période. Lisez la valeur dans l’unité du catalogue : count est un nombre, currency un montant décimal, et percent est déjà exprimé en points de pourcentage (1.6 signifie 1,6 %).
Certaines métriques renvoient aussi data.totals pour toute la plage. Utilisez ces totaux lorsqu’ils sont fournis : faire la moyenne de taux journaliers ou additionner des nombres journaliers de valeurs uniques ne donne pas le résultat sur toute la plage.
Filtrer et ventiler les résultats
Transmettez directement une propriété en paramètre de requête pour filtrer selon celle-ci. Utilisezbreakdown_by pour scinder chaque point selon une propriété. Cet exemple filtre le chiffre d’affaires brut sur les paiements par carte et le ventile selon la devise d’origine de la transaction :
breakdown d’entrées { name, value }. Filtrer ou ventiler les métriques de transaction par currency renvoie les montants dans leur devise d’origine, sans conversion.
N’utilisez que les propriétés listées pour la métrique. Une propriété non prise en charge renvoie 400. Une clé de métrique inconnue renvoie 404. Consultez les paramètres de requête et la référence des métriques pour les fuseaux horaires, les intervalles, les fenêtres d’instantané et les options propres à chaque métrique.
