ListPublicMediaBasicInfos によるパブリックメディアアセットのクエリ - IMS

指定された条件を満たす公開メディアライブラリ内のメディアアセットのリストを照会します。最大 100 件のメディアアセットを返すことができます。

今すぐお試しください

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

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
MediaTagId	string	任意	メディアタグ。指定されたメディアタグを含むすべてのメディアアセットが返されます。有効な値：ステッカータグ： sticker-atmosphere sticker-bubble sticker-cute sticker-daily sticker-expression sticker-gif BGM タグ： bgm-romantic bgm-cuisine bgm-chinese-style bgm-upbeat bgm-dynamic bgm-relaxing bgm-quirky bgm-beauty BGI タグ： bgi-grad bgi-solid bgi-pic	sticker-atmosphere
NextToken	string	任意	次のリクエストで結果の新しいページを取得するために使用されるページネーショントークン。最初のリクエストでは、このパラメーターを指定する必要はありません。前のクエリから取得したトークンを NextToken の値として指定する必要があります。	pSa1SQ0wCe5pzVrQ6mWZEw==
MaxResults	integer	任意	返すエントリの最大数。最大値：100。デフォルト値：10。	5
PageNo	integer	任意	ページ番号。デフォルト値：1	1
PageSize	integer	任意	1 ページあたりのエントリ数。デフォルト値：10。最大値：100。	10
IncludeFileBasicInfo	boolean	任意	メディアアセットの基本情報を返すかどうかを指定します。	true
BusinessType	string	任意	メディアアセットのビジネスタイプ。有効な値： sticker bgm bgi	sticker

レスポンスフィールド

フィールド	型	説明	例
	object	レスポンスパラメーター。
RequestId	string	リクエスト ID。	****B7-7F87-4792-BFE9-63CD21****
TotalCount	integer	指定された条件を満たすメディアアセットの総数。	2
MediaInfos	array<object>	指定された条件を満たすメディアアセット。
	array<object>
MediaId	string	メディアアセットの ID。	**019b82e24b37a1c2958dec38**
MediaBasicInfo	object	メディアアセットの基本情報。
MediaId	string	メディアアセットの ID。	**019b82e24b37a1c2958dec38**
InputURL	string	別のサービスにあるメディアアセットの URL。	https://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4
MediaType	string	メディアアセットのタイプ。	video
BusinessType	string	メディアアセットのビジネスタイプ。	general
Source	string	メディアアセットのソース。	oss
Title	string	メディアアセットのタイトル。	title标题
Description	string	メディアアセットの説明。	description
Category	string	メディアアセットのカテゴリ。	video
MediaTags	string	メディアアセットのタグ。	sticker-daily
CoverURL	string	メディアアセットのサムネイル URL。	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=
UserData	string	ユーザーデータ。	userData
Snapshots	string	メディアアセットのスナップショット。	null
Status	string	メディアアセットのステータス。	Normal
TranscodeStatus	string	メディアアセットのトランスコードステータス。	Init
CreateTime	string	メディアアセットが作成された日時。	2021-01-08T16:52:04Z
ModifiedTime	string	メディアアセットが最後に変更された日時。	2021-01-08T16:52:04Z
DeletedTime	string	メディアアセットが削除された日時。	2021-01-08T16:52:04Z
FileInfoList	array<object>	メディアアセットのファイル情報。
	array<object>
FileBasicInfo	object	再生時間やサイズなどのファイルの基本情報。
FileName	string	ファイル名。	example.mp4
FileStatus	string	ファイルステータス。	Normal
FileType	string	ファイルタイプ。	source_file
FileSize	string	ファイルサイズ。単位：バイト。	338990717
FileUrl	string	ファイルの Object Storage Service (OSS) URL。	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=
Region	string	ファイルが存在するリージョン。	cn-shanghai
FormatName	string	コンテナ形式。	mov,mp4,m4a,3gp,3g2,mj2
Duration	string	再生時間。	10.040000
Bitrate	string	ビットレート。	270112.12
Width	string	幅。	1920
Height	string	高さ。	1080
NextToken	string	ページネーショントークン。次のリクエストで結果の新しいページを取得するために使用できます。NextToken が空の場合、次のページはありません。	8EqYpQbZ6Eh7+Zz8DxVYoQ==
MaxResults	integer	返されたエントリの最大数。	2

例

成功レスポンス

JSONJSON

{
  "RequestId": "******B7-7F87-4792-BFE9-63CD21******",
  "TotalCount": 2,
  "MediaInfos": [
    {
      "MediaId": "****019b82e24b37a1c2958dec38****",
      "MediaBasicInfo": {
        "MediaId": "****019b82e24b37a1c2958dec38****",
        "InputURL": "https://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4",
        "MediaType": "video",
        "BusinessType": "general",
        "Source": "oss",
        "Title": "title标题",
        "Description": "description",
        "Category": "video",
        "MediaTags": "sticker-daily",
        "CoverURL": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=",
        "UserData": "userData",
        "Snapshots": "null",
        "Status": "Normal",
        "TranscodeStatus": "Init",
        "CreateTime": "2021-01-08T16:52:04Z",
        "ModifiedTime": "2021-01-08T16:52:04Z",
        "DeletedTime": "2021-01-08T16:52:04Z"
      },
      "FileInfoList": [
        {
          "FileBasicInfo": {
            "FileName": "example.mp4",
            "FileStatus": "Normal",
            "FileType": "source_file",
            "FileSize": "338990717",
            "FileUrl": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=",
            "Region": "cn-shanghai",
            "FormatName": "mov,mp4,m4a,3gp,3g2,mj2",
            "Duration": "10.040000",
            "Bitrate": "270112.12",
            "Width": "1920",
            "Height": "1080"
          }
        }
      ]
    }
  ],
  "NextToken": "8EqYpQbZ6Eh7+Zz8DxVYoQ==",
  "MaxResults": 2
}

エラーコード

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

変更履歴

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