Questo argomento mostra i passaggi necessari ad autenticare e utilizzare un’API per i rendiconti finanziari per ottenere i rendiconti finanziari dell’ID dell’account RAMP/Acadia collegato al tuo account Slate. Se hai ancora domande dopo aver seguito questi passaggi, contatta il tuo responsabile fornitori o invia un ticket tramite l’assistenza Contattaci.
Prerequisito
È necessario un account Prime Video Slate per eseguire questi passaggi.
- Se non hai ancora un account Slate, vai su slate.amazon.com e crea un account. Quindi torna su questa pagina e inizia dal passaggio 1.
OPPURE - Se hai già effettuato l’onboarding ai canali esistenti e ai report TVOD precedenti tramite l’API, vai al passaggio 3.
Passaggio 1: Ottieni il tuo codice utente Slate
Per ottenere il codice utente Slate, consulta la guida per utenti e autorizzazioni di accesso.
Passaggio 2: Ottieni l’autorizzazione a chiamare l’API di report
Per integrare la tua applicazione con l’API Financial Statement, devi prima effettuare l’onboarding nella Analytics API Suite. Per istruzioni dettagliate sull’onboarding, visita la pagina API Onboarding.
Per maggiori dettagli sull’utilizzo delle API, consulta le API di Prime Video.
Passaggio 4: Crea l’URL dell’API corretto
L’URL generale dell’API di report è nel seguente formato. Il contenuto tra parentesi {} varia da partner a partner:https://videocentral.amazon.com/apis/v1/accounts/{account_id}/financialStatement/{report_identifier}/reportTypes/{report_type_id}/reports
Ogni parametro del percorso segnaposto è definito di seguito.
- account_id: L’ID dell’account RAMP/Acadia collegato al tuo account Slate. Chiedi questo ID al tuo partner manager. Se sei un utente esistente del report precedente, questo rimarrà invariato.
report_identifier: Questo viene impostato dal partner manager o dal responsabile fornitori. Per ottenere un elenco dei report disponibili per il tuo account, chiama l’URL dell’API https://videocentral.amazon.com/apis/v1/accounts/{account_id}/financialStatement
Questo ti mostrerà tutti gli identificatori del report a cui hai accesso.
report_type_id: Questo è un valore fisso. Utilizza una delle seguenti opzioni per recuperare i report
- Per i canali: amzn1.vcpa.arcs.insight.286fd5d9-aeb3-4eb0-99a1-959225160a01
- Per TVOD: amzn1.vcpa.arcs.insight.33ee837f-af47-40d6-8c2c-798eba24fac8
- Per la tariffa fissa SVOD: amzn1.vcpa.arcs.insight.10a37dcd-8912-4173-b428-600e237f7508
- Per AVOD, SVOD CPH e Linear: amzn1.vcpa.arcs.insight.f9efc58e-51dd-4e2c-a864-aae7e32a7f73
Risposta API finale
Una volta che sei in possesso dell’URL dell’API corretto e il tuo partner manager ha fornito i report giusti per te, questa è la risposta dell’API risultante. (La schermata seguente è tratta dall’URL dell’API di un account di prova).
L’URL dell’API utilizzato per ottenere i report deve essere:
https://videocentral.amazon.com/apis/v1/accounts/{partner’s acadia account ID}/financialStatement/{report_identifier}/reportTypes/{report_type_id}/reports
Il downloadUrl mostrato nella risposta API è un URL prefirmato che consente di scaricare il report. La modifiedDate mostrata nella risposta dell’API è l’ora a cui i dati sono stati aggiornati per un determinato report.
L’URL dell’API ti fornirà tutti i report disponibili per il tuo account Slate. Per esaminare mesi specifici, puoi utilizzare i parametri di richiesta dell’API reportDateBeginGte e reportDateBeginLt per specificare l’intervallo di tempo.
Ad esempio, per ottenere report specifici per ottobre 2024, imposta reportDateBeginGte su 2024-10-01 e reportDateBeginLt su 2024-11-01.
Per ulteriori informazioni su altre API di reporting, consulta le API di Prime Video.
