すべてのプロダクト
Search

このプロダクト

    :DescribePlayTopVideos

    ドキュメントセンター

    :DescribePlayTopVideos

    最終更新日:Aug 06, 2025

    この操作を呼び出すと、上位動画の再生統計情報を日単位で取得できます。統計情報には、視聴回数、ユニークビジター数（UV）、合計再生時間が含まれます。

    操作説明

    • このエンドポイントは 中国（上海） リージョンでのみサポートされています。

    • 1 日あたり最大 1,000 件の上位動画の再生統計情報をクエリできます。 デフォルトでは、上位動画のリストは視聴回数で降順にソートされます。

    • ApsaraVideo Player SDK によって収集された再生データのみがサポートされています。

    • 前日の再生統計情報は、毎日 09:00 (UTC + 08:00) に生成されます。

    • 2018 年 1 月 1 日以降に生成されたデータをクエリできます。 最大クエリ時間範囲は 180 日です。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    vod:DescribePlayTopVideos

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    タイプ

    必須 / 任意

    説明

    例
    BizDate

    string

    必須

    クエリ対象の日付。日付は、UTC の yyyy-MM-ddTHH:mm:ssZ 形式である必要があります。

    2016-06-29T13:00:00Z
    PageNo

    integer

    任意

    返すページ番号。デフォルト値： 1。

    1
    PageSize

    integer

    任意

    各ページに返すエントリの数。デフォルト値： 100。最大値： 1000。

    100

    レスポンスパラメーター

    パラメーター

    タイプ

    説明

    例

    object

    PageNo

    integer

    返されたページ番号。

    1
    RequestId

    string

    リクエスト ID。

    4B0BCF9F-2FD5-4817-****-7BEBBE3AF90B"
    PageSize

    integer

    各ページに返されるエントリの数。

    100
    TotalNum

    integer

    上位動画の総数。

    2
    TopPlayVideos

    object

    TopPlayVideoStatis

    array<object>

    その日上位の動画再生データ。

    object

    Title

    string

    動画のタイトル。

    Four streams (two streams encrypted): LD-HLS-encrypted + SD-MP4 + HD-H
    VV

    string

    視聴回数。

    107
    PlayDuration

    string

    合計再生時間。単位：ミリ秒。

    4640369
    VideoId

    string

    動画 ID。

    2a8d4cb9ecbb487681473a15****8fda
    UV

    string

    ユニークビジター数。

    1

    例

    成功レスポンス

    JSONJSON

    {
  "PageNo": 1,
  "RequestId": "4B0BCF9F-2FD5-4817-****-7BEBBE3AF90B\"",
  "PageSize": 100,
  "TotalNum": 2,
  "TopPlayVideos": {
    "TopPlayVideoStatis": [
      {
        "Title": "Four streams (two streams encrypted): LD-HLS-encrypted + SD-MP4 + HD-H",
        "VV": "107",
        "PlayDuration": "4640369",
        "VideoId": "2a8d4cb9ecbb487681473a15****8fda",
        "UV": "1"
      }
    ]
  }
}

    エラーレスポンス

    JSONJSON

    {
    "RequestId":"1FAFB884-D5A7-47D1-82B5-8928AA9C8720",
    "HostId":"vod.cn-shanghai.aliyuncs.com",
    "Code":"InvalidStartTime.Malformed",
    "Message":"Specified StartTime is malformed."
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 InvalidBizDate.Malformed Specified BizDate is malformed.
    400 InvalidBizDate.BeyondCurrent BizDate beyond current time.
    400 InvalidParamter %s

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。