メインコンテンツまでスキップ

重複再生遮断管理

新機能案内
  • サポート範囲: 重複再生遮断管理機能は v3 に新規追加された機能であり、v1 および v2 ではサポートされません。
  • 共通パスパラメーター: すべてのエンドポイントは、URL パス（Path）に対象サービスアカウントの固有識別子である {service_account_key} を必須で要求します。
  • 共通認証: すべての API は、クエリ文字列パラメーター（?access_token=）を利用した共通認証方式を使用します。
重複再生遮断管理 API v3 リファレンスへ移動

重複再生遮断記録の照会​

  • v3: GET /service-accounts/{service_account_key}/duplicate-blocks/logs
リクエストパラメーターおよびレスポンス構造の詳細

リクエストクエリパラメータ​

パラメーターデータタイプ必須有無説明
client_user_idString任意顧客ユーザーID
player_idString任意プレイヤー（デバイス）ID
start_dateString任意照会範囲の開始日時
end_dateString任意照会範囲の終了日時
pageInteger任意照会対象のページ番号
per_pageInteger任意1ページあたりの出力データ件数

レスポンス構造仕様​

{
  "data": [
    {
      "id": 1,
      "media_content_title": "title_string",
      "upload_file_key": "upload_file_key_string",
      "player_id": "player_id_string",
      "key": "key_string",
      "client_user_id": "user_01",
      "hardware_id": "hw_id_string",
      "created_at": "2023-10-01T10:00:00Z"
    }
  ],
  "pagination": {
    "total_count": 1,
    "page": 1,
    "per_page": 10
  }
}

重複再生許可デバイスの照会​

  • v3: GET /service-accounts/{service_account_key}/duplicate-blocks/players
リクエストパラメーターおよびレスポンス構造の詳細

リクエストクエリパラメータ​

パラメーターデータタイプ必須有無説明
client_user_idString必須顧客ユーザーID

レスポンス構造仕様​

{
  "data": {
    "total_count": 2,
    "player_id": [
      "player_id_01",
      "player_id_02"
    ]
  }
}

重複再生許可デバイスの削除​

  • v3: DELETE /service-accounts/{service_account_key}/duplicate-blocks/players
リクエストパラメーターおよびレスポンス構造の詳細

リクエストクエリパラメータ​

パラメーターデータタイプ必須有無説明
client_user_idString必須顧客ユーザーID
player_idString必須プレイヤー（デバイス）ID

レスポンス構造仕様​

{
  "data": [],
  "status": "ok"
}

重複再生許可デバイスの全件初期化​

  • v3: POST /service-accounts/{service_account_key}/duplicate-blocks/players/reset
リクエストボディおよびレスポンス構造の詳細

リクエストボディ​

フィールドデータタイプ必須有無説明
client_user_idString必須顧客ユーザーID

レスポンス構造仕様​

{
  "data": [],
  "status": "ok"
}