使用GetEditingProjectMaterials获取云剪辑工程素材列表-视频点播-阿里云-视频点播(VOD)-阿里云帮助中心

调用本接口获取云剪辑工程的待剪辑素材列表。

接口说明

在剪辑过程中，素材可添加到时间线上，但不一定完全被使用。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

vod:GetEditingProjectMaterials

list

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
ProjectId	string	是	云剪辑工程 ID。可通过以下方式获取：登录点播控制台，选择制作中心 > 视频剪辑，查看 ID。通过创建云剪辑工程接口创建工程时，为返回参数 ProjectId 的值。	1982361011093374****
Type	string	否	素材类型。取值： video：视频 audio：纯音频	video
MaterialType	string	否	素材类型。取值： video：视频 audio：纯音频 image：图片	video

返回参数

名称	类型	描述	示例值
	object	返回结果。
RequestId	string	请求 ID。	746FFA07-8BBB-46B1-3E94E3B2915E****
MaterialList	object
Material	array<object>	素材列表。
	array<object>	素材详情。
Status	string	素材状态。取值： Normal：草稿。 Producing：合成中。 Produced ：合成成功。 ProduceFailed：合成失败。	Normal
CreationTime	string	素材创建时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。	2017-10-19 10:48:17
CateId	integer	素材分类 ID。	100005****
MaterialType	string	素材类型。取值： video：视频 audio：纯音频 image：图片	video
Tags	string	素材标签。多个使用半角逗号（,）分隔。	Editing test
SpriteConfig	string	雪碧图配置。	xxx
Source	string	雪碧图来源。	xxx
CateName	string	素材分类名称。	Test
ModifiedTime	string	素材更新时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。	2017-10-19 10:48:17
Description	string	素材描述。	Test
MaterialId	string	素材 ID。	85befc4118b84c6723e53b80b1****
Size	integer	素材源文件大小，单位：字节。	1682694
CoverURL	string	素材封面 URL。	http://example.aliyundoc.com/aivideocover/46fa444aa34065cb9250f6c****/image_01.jpg
Duration	number	素材时长，精确到小数点后 4 位，单位：秒。	15.16
Title	string	素材标题。	test
Sprites	object
Sprite	array	素材雪碧图 URL 数组。
	string	素材雪碧图 URL。	"http://example.aliyundoc.com/material_big_snapshot/0f325c157386f2a7e91b2ff0****.jpg?auth_key="
Snapshots	object
Snapshot	array	素材截图 URL 数组。
	string	素材截图 URL。	"http://example.aliyundoc.com/material_small_snapshot/0f325c157386f2a7e91b2ff0**.jpg?auth_key=","http://example.aliyundoc.com/material_small_snapshot/0f325c157386f2a7e91b2ff0**.jpg?auth_key="

示例

正常返回示例

JSON格式

{
  "RequestId": "746FFA07-8BBB-46B1-3E94E3B2915E****",
  "MaterialList": {
    "Material": [
      {
        "Status": "Normal",
        "CreationTime": "2017-10-19 10:48:17",
        "CateId": 0,
        "MaterialType": "video",
        "Tags": "Editing test",
        "SpriteConfig": "xxx",
        "Source": "xxx",
        "CateName": "Test",
        "ModifiedTime": "2017-10-19 10:48:17",
        "Description": "Test",
        "MaterialId": "85befc4118b84c6723e53b80b1****",
        "Size": 1682694,
        "CoverURL": "http://example.aliyundoc.com/aivideocover/46fa444aa34065cb9250f6c****/image_01.jpg",
        "Duration": 15.16,
        "Title": "test",
        "Sprites": {
          "Sprite": [
            "\"http://example.aliyundoc.com/material_big_snapshot/0f325c157386f2a7e91b2ff0****.jpg?auth_key=\""
          ]
        },
        "Snapshots": {
          "Snapshot": [
            "\"http://example.aliyundoc.com/material_small_snapshot/0f325c157386f2a7e91b2ff0****.jpg?auth_key=\",\"http://example.aliyundoc.com/material_small_snapshot/0f325c157386f2a7e91b2ff0****.jpg?auth_key=\""
          ]
        }
      }
    ]
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。