Este tema te guía a través de los pasos para autenticarte y usar la API de Financial Statement para obtener los estados financieros del ID de cuenta de RAMP/Acadia vinculado a tu cuenta de Slate. Si todavía tienes preguntas después de seguir estos pasos, por favor contacta a tu gerente de proveedores o envía un ticket a través del soporte de Contáctanos.
Requisito previo
Necesitas una cuenta de Prime Video Slate para llevar a cabo estos pasos.
- Si aún no tienes una cuenta de Slate, ve a slate.amazon.com y crea una cuenta. A continuación, vuelve a esta página y empieza desde el Paso 1.
O - Si ya estás incorporado a los reportes heredados de Channels y TVOD a través de la API, salta al Paso 3.
Paso 1: Obtén tu código de usuario de Slate
Para obtener tu código de usuario de Slate, consulta la guía de permisos de acceso y usuario.
Paso 2: Obtén la autorización para llamar a la API de Reporting
Para integrar tu aplicación con la API de Financial Statement, primero debes incorporarte a la suite de la API de Analytics. Para obtener instrucciones detalladas sobre la incorporación, visita la página de Incorporación a la API.
Para más detalles sobre cómo trabajar con las APIs, consulta Prime Video APIs.
Paso 4: Construye la URL correcta de la API
La URL general de la API de Reporting tiene el siguiente formato, donde el contenido entre llaves {} varía de un socio a otro:https://videocentral.amazon.com/apis/v1/accounts/{account_id}/financialStatement/{report_identifier}/reportTypes/{report_type_id}/reports
A continuación se explica cada parámetro de la ruta de marcadores de posición.
- account_id: El ID de cuenta de RAMP/Acadia que está vinculado a tu cuenta de Slate. Pide este ID a tu gestor de socios. Si ya eres usuario de los reportes heredados, este ID no cambiará.
report_identifier: Esto lo configura tu gestor de socios o gestor de proveedores. Para obtener una lista de los informes que están disponibles para tu cuenta, llama a la URL de la API: https://videocentral.amazon.com/apis/v1/accounts/{account_id}/financialStatement
Así podrás ver todos los identificadores de informes a los que tienes acceso.
report_type_id: Se trata de un valor fijo. Usa una de las siguientes opciones para recuperar los informes
- Para Channels: amzn1.vcpa.arcs.insight.286fd5d9-aeb3-4eb0-99a1-959225160a01
- Para TVOD: amzn1.vcpa.arcs.insight.33ee837f-af47-40d6-8c2c-798eba24fac8
- Para SVOD de tarifa fija: amzn1.vcpa.arcs.insight.10a37dcd-8912-4173-b428-600e237f7508
- Para AVOD, SVOD CPH y Lineal: amzn1.vcpa.arcs.insight.f9efc58e-51dd-4e2c-a864-aae7e32a7f73
Respuesta final de la API
Cuando tengas la URL de la API correcta y tu gestor de socios te haya dado acceso a los informes correctos para ti, esta será la respuesta de la API resultante. (La siguiente captura de pantalla es de la URL de la API de una cuenta de prueba).
La URL de la API utilizada para obtener los informes debe ser:
https://videocentral.amazon.com/apis/v1/accounts/{partner’s acadia account ID}/financialStatement/{report_identifier}/reportTypes/{report_type_id}/reports
La URL de descarga downloadUrl que aparece en la respuesta de la API es una URL prefirmada que te permite descargar el informe. La fecha de modificación modifiedDate que se muestra en la respuesta de la API es la hora en que se actualizaron los datos de un informe en concreto.
La URL de la API te mostrará todos los informes disponibles en tu cuenta de Slate. Para ver meses específicos, puedes utilizar los parámetros de solicitud de la API reportDateBeginGte y reportDateBeginLt para especificar el intervalo temporal.
Por ejemplo, para obtener informes específicos de octubre de 2024, define reportDateBeginGte en 2024-10-01 y reportDateBeginLt en 2024-11-01.
Para obtener más información sobre otras API de informes, consulta las API de Prime Video.
