Todos os produtos
Search
Central de documentação

:GetEditingProjectMaterials

Última atualização: Jun 27, 2026

Consulta materiais de um projeto de edição online.

Observações de uso

Durante a edição, você pode adicionar materiais à linha do tempo, mas alguns deles podem não ser utilizados.

Limite de QPS

Você pode chamar esta operação até 30 vezes por segundo por conta. Se o número de chamadas por segundo exceder esse limite, o throttling será acionado e poderá afetar seus serviços. Recomendamos observar esse limite ao chamar esta operação. Para mais informações, consulte Limites de QPS para operações de API no ApsaraVideo VOD.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

ParâmetroTipoObrigatórioExemploDescrição
ActionStringSimGetEditingProjectMaterials

A operação a ser executada. Defina o valor como GetEditingProjectMaterials.

ProjectIdStringSim1982361011093374****

ID do projeto de edição online. Utilize um dos métodos a seguir para obter o ID do projeto:

  • Faça login no console do ApsaraVideo VOD. No painel de navegação à esquerda, escolha Production Center > Video Editing para obter o ID do projeto de edição online desejado.
  • Chame a operação AddEditingProject. O valor do parâmetro de resposta ProjectId corresponde ao ID do projeto de edição online especificado.
TypeStringSimvideo

Tipo do material. Valores válidos:

  • video
  • audio
MaterialTypeStringNãovideo

Tipo do material. Valores válidos:

  • video
  • audio
  • image

Parâmetros de resposta

ParâmetroTipoExemploDescrição
RequestIdString746FFA07-8BBB-46B1-3E94E3B2915E****

ID da solicitação.

MaterialListArray of Material

Lista de materiais.

Material
StatusStringNormal

Status do material. Valores válidos:

  • Normal: O material está em rascunho.
  • Producing: O material está sendo produzido.
  • Produced: A produção do material foi concluída.
  • ProduceFailed: Falha na produção do material.
CreationTimeString2017-10-19 10:48:17

Hora de criação do material. Segue o padrão ISO 8601 no formato aaaa-MM-ddTHH:mm:ssZ e é exibida em UTC.

CateIdInteger100005****

ID da categoria do material.

MaterialTypeStringvideo

Tipo do material. Valores válidos:

  • video
  • audio
  • image
TagsStringEditing test

Tag do material. Múltiplas tags são separadas por vírgulas (,).

SpriteConfigStringxxx

Configuração do sprite.

sourceStringxxx

Origem do sprite.

CateNameStringTest

Nome da categoria do material.

ModifiedTimeString2017-10-19 10:48:17

Hora da última atualização do material. Segue o padrão ISO 8601 no formato aaaa-MM-ddTHH:mm:ssZ e é exibida em UTC.

DescriptionStringTest

Descrição do material.

MaterialIdString85befc4118b84c6723e53b80b1****

ID do material.

SizeLong1682694

Tamanho do arquivo mezzanine. Unidade: byte.

CoverURLStringhttp://example.aliyundoc.com/aivideocover/46fa444aa34065cb9250f6c****/image_01.jpg

URL da miniatura do material.

DurationFloat15.16

Duração do material. O valor é arredondado para quatro casas decimais. Unidade: segundos.

TitleStringtest

Título do material.

SpritesArray of Stringnull

URLs dos sprites do material. O valor é um array.

SnapshotsArray of String["http://example.aliyundoc.com/material_small_snapshot/0f325c157386f2a7e91b2ff0****.jpg?auth_key=","http://example.aliyundoc.com/material_small_snapshot/0f325c157386f2a7e91b2ff0****.jpg?auth_key="]

URLs dos snapshots do material. O valor é um array.

Exemplos

Exemplos de solicitações

http(s)://vod.cn-shanghai.aliyuncs.com/?Action=GetEditingProjectMaterials
&ProjectId=1982361011093374****
&Type=video
&MaterialType=video
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

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

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "746FFA07-8BBB-46B1-3E94E3B2915E****",
  "MaterialList" : [ {
    "Status" : "Normal",
    "CreationTime" : "2017-10-19 10:48:17",
    "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" : [ "[\"http://example.aliyundoc.com/material_small_snapshot/0f325c157386f2a7e91b2ff0****.jpg?auth_key=\",\"http://example.aliyundoc.com/material_small_snapshot/0f325c157386f2a7e91b2ff0****.jpg?auth_key=\"]" ]
  } ]
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.

Código de exemplo de SDKs para várias linguagens

Recomendamos usar um SDK do lado do servidor para chamar esta operação. Para mais informações sobre os códigos de exemplo usados para chamar esta operação em diversas linguagens, consulte os seguintes tópicos: