VonageレポートAPIがビデオAPIをサポート

はじめに

Vonage Reports APIがサポートされました。 ビデオAPI-ただし Vonage API Dashboard (Unified)ユーザのみです。ただし OpenTok Dashboardユーザーの場合、この機能は利用できません。
これまで、Video API を扱う開発者は主に インサイト APIに頼っていました。今回のアップデートで、Reports API からも Video データにアクセスできるようになりました。 SMS, メッセージ, 音声そして 検証.

レポートAPIとは？

レポート レポートAPIは、Vonage製品全体の使用状況やレポートデータを取得するための中心的な方法であり、現在Videoで利用可能で、開発者や企業にアクティビティ、課金、コンプライアンスデータを追跡する一貫した方法を提供します。

レポートAPIを使用する理由

これは、複数のVonage APIからの使用量と請求データを1つの一貫性のあるフォーマットに持ってくることによって、レポートを簡素化します。Reports APIの詳細については、こちらのローンチ記事をご覧いただくか、Laravelを例とした実装のチュートリアルをご覧ください。

レポートAPIとインサイトAPIの比較

動画データの Reports API の使用方法について説明する前に、Insights および Advanced Insights API と簡単に比較してみましょう。以下の表は、主な違いを示しているため、どの製品があなたのユースケースに最も適しているかを確認することができます。

All features compared

動画 API データのレポート API の使用方法

レポートAPI for Videoは現在REST APIからのみご利用いただけます。Vonage Dashboardからはアクセスできませんので、RESTクライアントを使用してリクエストを行う必要があります。

前提条件

• ユニファイビデオアカウント

• APIキーとシークレット

• RESTクライアント（cURL、Postmanなど）

ステップ1.レポートの種類を選ぶ

• 同期レポート：小規模なデータセットでも迅速な結果が得られます。

• 非同期レポート：大きなデータセットや長い時間範囲に適しています。バックグラウンドで実行され、ダウンロードリンクが表示されます。
  詳細は 同期操作と非同期操作の違い.

ステップ2.レポートのリクエストと取得

2.1 同期レポートの例

リクエストを送信

curl -X GET "https://api.nexmo.com/v2/reports/records?product=VIDEO-API&account_id=$VONAGE_API_KEY&date_start=2025-09-27T00:00:00Z&date_end=2025-09-30T23:59:59Z" \
-u "$VONAGE_API_KEY:$VONAGE_API_SECRET"

回答例（わかりやすくするためにトリミング）

"records": [
        {
            "account_id": "xxxxx",
            "feature_name": "Subscriber minutes",
            "session_id": "xxxxx",
            "meeting_id": "",
            "subscriber_id": "xxxxx",
            "archive_id": "",
            "broadcast_id": "",
            "hls_id": "",
            "composer_id": "",
            "application_id": "xxxxx",
            "duration": "120.0",
            "date_start": "2025-09-29T11:29:12+00:00",
            "date_end": "2025-09-29T11:30:22+00:00",
            "total_price": "0",
            "currency": "EUR",
            "id": "xxxxx"
        },

を参照してください。 APIリファレンス同期レポートのAPIリファレンスを参照してください。

2.2 非同期レポートの例

リクエストを送信

curl -X POST "https://api.nexmo.com/v2/reports" \
  -u "$VONAGE_API_KEY:$VONAGE_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "product": "VIDEO-API",
    "account_id": "$VONAGE_API_KEY",
    "date_start": "2025-09-01T00:00:00Z",
    "date_end": "2025-09-30T23:59:59Z",
    "callback_url": "https://webhook.site/b7dd039b-afc7-464b-8fbd-1ef84820eaed"
  }'

結果例（CSV）（わかりやすくするためにトリミングしています。）

アカウントID,機能名,セッションID,アプリケーションID,期間,開始日,終了日,合計価格,通貨
xxxxx,Experience composer,xxxxx,xxxxx,7,2025-09-29T11:30:05+00:00,2025-09-29T11:30:12+00:00,0,EUR
xxxxx,Subscriber minutes,xxxxx,xxxxx,120,2025-09-29T11:29:12+00:00,2025-09-29T11:30:22+00:00,0,EUR
xxxxx,Interconnect,xxxxx,xxxxx,120,2025-09-29T11:29:12+00:00,2025-09-29T11:30:22+00:00,0.0094596,EUR

物事をシンプルに保つために、ここでは基本的なことだけを紹介しました。非同期レポートを作成するための完全なステップバイステップ・ガイドは 記事.

動画用レポートAPIを試す準備はできましたか？

Reports API を通して、Video API の使用状況と課金データにアクセスできるようになりました。動画向け Reports API に関する技術的なご質問は、以下のサポート ポータルから動画 API サポート チームにお問い合わせください。 サポート ポータル.OpenTok から Unified への移行をお考えですか？強化されたレポート機能を検討する絶好の機会です。移行の詳細については、アカウント・マネージャーにお問い合わせください。