Video Central

このトピックでは、SlateアカウントにリンクされているRAMP/AcadiaアカウントIDの財務諸表を取得するために、財務諸表APIを認証して使用する方法について、複数のステップを通して説明します。これらのステップに従ってもまだ不明な点がある場合は、ベンダーマネージャーに連絡するか、お問い合わせサポートからチケットを送信してください。

前提条件

これらのステップを実行するには、Prime Video Slateアカウントが必要です。

まだSlateアカウントをお持ちでない場合は、slate.amazon.comに移動してアカウントを作成してください。その後、このページに戻り、ステップ1から開始してください。
または
APIを通して既存のチャンネルとTVODのレガシーレポートにすでにオンボーディングされている場合は、ステップ3にスキップしてください。

ステップ1: Slateユーザーコードを取得する

Slateで、右上のアカウント設定ドロップダウンをクリックし、マイユーザー設定を選択してください。
表示されているユーザーコードをコピーして、パートナーマネージャーかベンダーマネージャーに提供してください。
この例では、ユーザーコードはJ7NY8HFT64です。このステップで問題が発生した場合は、サポートドロップダウンをクリックして「サポートへ問い合わせ」を選択してください。

この例では、ユーザーコードはJ7NY8HFT64です。このステップで問題が発生した場合は、サポートドロップダウンをクリックしてサポートへ問い合わせを選択してください。

ステップ2: レポーティングAPIを呼び出す権限を取得する

アプリケーションを財務諸表APIと統合するには、以下を行う必要があります:

APIの使い方について詳しくは、Prime Video SlateレポーティングAPIを参照してください。

ステップ3: 担当者にSlateユーザーアカウントのレポートを有効化してもらう

パートナーマネージャーかベンダーマネージャーに通常の方法で連絡し、正しいレポートを表示するよう依頼してください。

ステップ4: 正しいAPI URLを作成する

一般的なレポーティングAPI URLは以下の形式で、括弧{}内の内容はパートナーによって異なります:
https://videocentral.amazon.com/apis/v1/accounts/{account_id}/financialStatement/{report_identifier}/reportTypes/{report_type_id}/reports
各プレースホルダーのパスパラメータは以下のように定義されます。

account_id: SlateアカウントにリンクされているRAMP/AcadiaアカウントID。このIDについては、パートナーマネージャーにお問い合わせください。既存のレガシーレポートユーザーの場合、これは変更されないままとなります。

report_identifier: これはパートナーマネージャーかベンダーマネージャーによって設定されます。レポートがアカウントにおいて利用できるリストを取得するには、API URL https://videocentral.amazon.com/apis/v1/accounts/{account_id}/financialStatementを呼び出してください
これにより、アクセスできるすべてのレポート識別子が表示されます。

Sample API call, showing the report identifier for a report with the name "Example Report"

report_type_id: これは固定値です。レポートを取得するには、次のオプションのいずれかを使用してください
- チャンネル用: amzn1.vcpa.arcs.insight.286fd5d9-aeb3-4eb0-99a1-959225160a01
- TVOD用: amzn1.vcpa.arcs.insight.33ee837f-af47-40d6-8c2c-798eba24fac8
- SVOD固定料金用: amzn1.vcpa.arcs.insight.10a37dcd-8912-4173-b428-600e237f7508
- AVOD、SVOD CPH、リニア用: amzn1.vcpa.arcs.insight.f9efc58e-51dd-4e2c-a864-aae7e32a7f73

最終的なAPIレスポンス

正しいAPI URLを取得し、パートナーマネージャーが適切なレポートを表示すると、このようなAPIレスポンスが得られます。(次のスクリーンショットは、テストアカウントのAPI URLからのものです。)

Sample image of the final API response from a test account's API URL. The way to download specific financial statement reporting from this response is described in the next section.

レポートの取得に使用されるAPI URLは以下のものとなります:
https://videocentral.amazon.com/apis/v1/accounts/{partner’s acadia account ID}/financialStatement/{report_identifier}/reportTypes/{report_type_id}/reports

APIレスポンスに表示されるdownloadUrlは、レポートをダウンロードするための署名付きURLです。APIレスポンスに表示されるmodifiedDateは、特定のレポートにおいてデータがリフレッシュされた時間です。

API URLを使用すると、Slateアカウントで利用可能なすべてのレポートを取得できます。特定の月を確認する場合は、APIリクエストパラメーターのreportDateBeginGteとreportDateBeginLtを使用して時間範囲を指定できます。

例えば、2024年10月を指定してレポートを取得するには、reportDateBeginGteを2024-10-01に設定し、reportDateBeginLtを2024-11-01に設定してください。

他のレポーティングAPIの詳細については、SlateレポーティングAPIドキュメントを参照してください。