En este tema se explican los pasos para autenticar y utilizar una API de informes para obtener los estados financieros del identificador de cuenta de RAMP/Acadia que se vincula a tu cuenta de Slate. Si aún tienes dudas después de seguir estos pasos, ponte en contacto con tu gestor de proveedores o envía un ticket a través de Ponte en contacto con soporte.
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 te habías incorporado a los informes antiguos de los canales y TVOD existentes a través de la API, continúa con el Paso 3.
Paso 1: Consigue tu código de usuario de Slate
- En Slate, haz clic en el menú desplegable Configuración de la cuenta en la esquina superior derecha y selecciona Mi configuración de usuario.
Copia el código de usuario que se muestra y envíalo a tu gestor de proveedores.
En este ejemplo, el código de usuario es J7NY8HFT64. Si tienes problemas con este paso, haz clic en el menú desplegable Soporte y selecciona Ponte en contacto con soporte.En este ejemplo, el código de usuario es J7NY8HFT64. Si tienes problemas con este paso, haz clic en el menú desplegable Soporte y selecciona Ponte en contacto con soporte.
Paso 2: Obtén la autorización para llamar a la API de informes
Para integrar tu aplicación con la API de estados financieros, debes hacer lo siguiente:
- Crea un perfil de seguridad de Inicio de sesión con Amazon.
- Genera un código de autorización para autorizar la aplicación.
- Solicita los tokens.
Para obtener más información sobre cómo trabajar con las API, consulta API de informes de Prime Video Slate.
Paso 4: Crea la URL de API correcta
La URL general de la API de informes 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.
- id_de cuenta: El identificador de la cuenta de RAMP/Acadia que está vinculado a tu cuenta de Slate. Puedes pedirle este identificador a tu gestor de socios. Si ya eres un usuario de informes antiguo, esto no cambiará.
identificador_informe: Esto lo configura tu gestor de socios o gestor de proveedores. Para obtener una lista de los informes disponibles en 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.
id_de tipo_informe: Se trata de un valor fijo. Usa una de las siguientes opciones para recuperar los informes
- Para los canales: amzn1.vcpa.arcs.insight.286fd5d9-aeb3-4eb0-99a1-959225160a01
- Para TVOD: amzn1.vcpa.arcs.insight.33ee837f-af47-40d6-8c2c-798eba24fac8
- Para la tarifa fija de SVOD: 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 usada 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 firmada previamente 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 la Documentación de las API de informes de Slate.
