Ce sujet explique les étapes à suivre pour s’authentifier et utiliser une API pour les états financiers afin d’obtenir les états financiers pour l’ID de compte RAMP/Acadia associé à votre compte Slate. Si vous avez encore des questions après avoir suivi ces étapes, contactez votre responsable relation fournisseurs ou soumettre un ticket via le support Nous contacter.
Conditions préalables
Vous devez disposer d’un compte Prime Video Slate pour effectuer ces étapes.
- Si vous n’avez pas encore de compte Slate, rendez-vous sur slate.amazon.com et créez-en un. Revenez ensuite à cette page et recommencez à l’étape 1.
OU - Si vous êtes déjà connecté aux chaînes existantes et aux anciens rapports TVOD via l’API, passez à l’étape 3.
Étape 1 : Obtenez votre code utilisateur Slate.
Pour obtenir votre code utilisateur Slate, veuillez consulter le guide des utilisateurs et des autorisations d’accès.
Étape 2 : Obtenez l’autorisation d’appeler l’API de création de rapports.
Pour intégrer votre application à l’API des états financiers, vous devez d’abord intégrer la suite d’API Analytics : Pour obtenir des instructions d’intégration détaillées, consultez la page d’intégration de l’API.
Pour plus de détails sur l’utilisation des API, consultez la section API Prime Video.
Étape 4 : Créez l’URL d’API correcte.
L’URL générale de l’API de création de rapports est au format suivant, le contenu entre crochets {} variant d’un partenaire à l’autre :https://videocentral.amazon.com/apis/v1/accounts/{account_id}/financialStatement/{report_identifier}/reportTypes/{report_type_id}/reports
Chaque paramètre de chemin d’espace réservé est défini ci-dessous.
- account_id : L’ID de compte RAMP/Acadia lié à votre compte Slate. Demandez cet identifiant à votre responsable des partenaires. Si vous utilisez déjà un ancien rapport, il restera inchangé.
report_identifier : Il est configuré par votre responsable des partenaires ou le responsable relation fournisseurs. Pour obtenir la liste des rapports disponibles pour votre compte, appelez l’URL de l’API suivante : https://videocentral.amazon.com/apis/v1/accounts/{account_id}/financialStatement
Elle vous indiquera tous les identifiants de rapports auxquels vous avez accès.
report_type_id : Il s’agit d’une valeur fixe. Utilisez l’une des options suivantes pour récupérer les rapports.
- Pour les chaînes : amzn1.vcpa.arcs.insight.286fd5d9-aeb3-4eb0-99a1-959225160a01
- Pour la TVOD : amzn1.vcpa.arcs.insight.33ee837f-af47-40d6-8c2c-798eba24fac8
- Pour les frais fixes de SVOD : amzn1.vcpa.arcs.insight.10a37dcd-8912-4173-b428-600e237f7508
- Pour AVOD, SVOD CPH et linéaire :amzn1.vcpa.arcs.insight.f9efc58e-51dd-4e2c-a864-aae7e32a7f73
Réponse finale de l’API
Une fois que vous avez la bonne URL d’API et que votre responsable des partenaires a créé les rapports appropriés pour vous, voici la réponse de l’API qui en résulte. (La capture d’écran suivante provient de l’URL de l’API d’un compte de test.)
L’URL de l’API utilisée pour obtenir les rapports doit être comme suit :
https://videocentral.amazon.com/apis/v1/accounts/{partner’s acadia account ID}/financialStatement/{report_identifier}/reportTypes/{report_type_id}/reports
La downloadUrl affichée dans la réponse de l’API est une URL présignée qui vous permet de télécharger le rapport. La modifiedDate indiquée dans la réponse de l’API est la date d’actualisation des données pour un rapport particulier.
L’URL de l’API vous permettra d’accéder à tous les rapports disponibles pour votre compte Slate. Pour examiner des mois spécifiques, vous pouvez utiliser les paramètres de requête d’API reportDateBeginGte et reportDateBeginLt pour spécifier la période.
Par exemple, pour obtenir des rapports spécifiques pour octobre 2024, définissez reportDateBeginGte sur 2024-10-01 et reportDateBeginLt sur 2024-11-01.
Pour plus d’informations sur les autres API de création de rapports, consultez la section API Prime Video.
