GetVideoInfos - ApsaraVideo VOD: Central de Documentação do Alibaba Cloud

Obtém as informações de vários arquivos de áudio e vídeo por vez com base no ID do áudio ou vídeo, incluindo título, descrição, duração, URL da miniatura, status, hora de criação, tamanho, snapshots, categoria e tags.

Descrição da operação

Você pode obter informações de até 20 arquivos de áudio e vídeo por vez.
Após o upload de um arquivo de áudio ou vídeo, o ApsaraVideo VOD analisa o arquivo de origem enviado. Portanto, as informações do ativo de mídia são geradas de forma assíncrona. Você pode configurar a notificação de evento AudioVideoAnalysisComplete. Após receber a notificação de evento AudioVideoAnalysisComplete, chame esta operação para obter as informações do áudio e vídeo.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

vod:GetVideoInfos

list

*全部资源

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
VideoIds	string	Não	A lista de IDs de áudio ou vídeo. Separe vários IDs com vírgulas (,). Você pode especificar no máximo 20 IDs. Você pode obter o ID do áudio ou vídeo usando os seguintes métodos: Se o vídeo for enviado pelo console do ApsaraVideo VOD, faça login no console do ApsaraVideo VOD e escolha Arquivos de mídia > Áudio/Vídeo para visualizar o ID do áudio ou vídeo. Obtenha o ID do áudio ou vídeo a partir do valor do parâmetro de resposta VideoId ao chamar a operação CreateUploadVideo para obter a URL e a credencial de upload. Após o upload do arquivo de áudio ou vídeo, você pode chamar a operação SearchMedia para consultar o ID do áudio ou vídeo, que é o valor do parâmetro de resposta VideoId.	7753d144efd8e649c6c45fe0579**,7753d144efd74d6c45fe0570**
ReferenceIds	string	Não	A lista de IDs personalizados. Separe vários IDs com vírgulas (,). Você pode especificar no máximo 20 IDs.	123-123,1234-1234

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	25818875-5F78-4AF6-D7393642CA58****
NonExistVideoIds	array	A lista de IDs de áudio ou vídeo que não existem.
	string	A lista de IDs de áudio ou vídeo que não existem.	["7753d144efd8e649c6c45fe0579****"]
NonExistReferenceIds	array	A lista de IDs personalizados que não existem.
	string	A lista de IDs personalizados que não existem.	123-123
VideoList	array<object>	As informações sobre os arquivos de áudio e vídeo.
	object	Os detalhes do arquivo de áudio ou vídeo.
StorageLocation	string	O endereço de armazenamento do arquivo de áudio ou vídeo.	out-****.oss-cn-shanghai.aliyuncs.com.
CreationTime	string	A hora em que o arquivo de áudio ou vídeo foi criado. A hora segue o padrão ISO 8601 no formato aaaa-MM-ddTHH:mm:ssZ. A hora é exibida em UTC.	2017-06-26T05:38:48Z
Status	string	O status do vídeo. Valores válidos: Uploading: O vídeo está sendo enviado. UploadFail: Falha no envio do vídeo. UploadSucc: O vídeo foi enviado. Transcoding: O vídeo está sendo transcodificado. TranscodeFail: Falha na transcodificação do vídeo. Blocked: O vídeo está bloqueado. Normal: O vídeo está em estado normal.	Normal.
CateId	integer	O ID da categoria.	781111****
VideoId	string	O ID do áudio ou vídeo.	7753d144efd74d6c45fe0570****
DownloadSwitch	string	O status da opção de download offline. Se o recurso de download offline estiver ativado, os usuários móveis podem armazenar vídeos em cache em seus dispositivos locais para visualização offline usando o ApsaraVideo Player. Para mais informações, consulte Download offline. Valores válidos: on: ativado. O download offline é permitido. off: desativado. O download offline não é permitido.	on
Tags	string	As tags do arquivo de áudio ou vídeo. Várias tags são separadas por vírgulas (,).	tag1, tag2
ModificationTime	string	A última hora em que o arquivo de áudio ou vídeo foi atualizado. A hora segue o padrão ISO 8601 no formato aaaa-MM-ddTHH:mm:ssZ. A hora é exibida em UTC.	2017-06-26T06:38:48Z
CateName	string	O nome da categoria.	cate1
Description	string	A descrição do arquivo de áudio ou vídeo.	Descrição do vídeo Alibaba Cloud VOD.
AppId	string	O ID do aplicativo.	app-****
Size	integer	O tamanho do arquivo de origem de áudio ou vídeo. Unidade: bytes.	453
CoverURL	string	A URL da miniatura do arquivo de áudio ou vídeo.	https://example.aliyundoc.com/****.jpg.
TemplateGroupId	string	O ID do grupo de modelos de transcodificação.	b4039216985f4312a5382a4ed****
Duration	number	A duração do arquivo de áudio ou vídeo. Unidade: segundos.	120
Title	string	O título do arquivo de áudio ou vídeo.	Título do vídeo Alibaba Cloud VOD.
Snapshots	array	O array de URLs de snapshots de vídeo.
	string	O array de URLs de snapshots de vídeo. Nota Esta operação retorna apenas os dados de snapshot de miniatura do vídeo. Para consultar os dados de snapshots normais, snapshots sprite, imagens originais sprite e snapshots WebVTT capturados usando o recurso de snapshot de vídeo, chame a operação ListSnapshots.	["http://example.aliyundoc.com/snapshot/**.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333","http://example.aliyundoc.com/snapshot/.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27243**",...]
StorageClass	string	A classe de armazenamento do ativo de mídia. Valores válidos: Standard: padrão. IA: Acesso pouco frequente de ativo de mídia. Archive: Arquivo de ativo de mídia. ColdArchive: Arquivo frio de ativo de mídia. SourceIA: Acesso pouco frequente de arquivo de origem. SourceArchive: Arquivo de arquivo de origem. SourceColdArchive: Arquivo frio de arquivo de origem. Changing: a classe de armazenamento do ativo de mídia está sendo alterada. SourceChanging: a classe de armazenamento do arquivo de origem está sendo alterada.	Standard.
RestoreStatus	string	O status de restauração do ativo de mídia. Valores válidos: Processing: O ativo de mídia está sendo restaurado. Success: O ativo de mídia foi restaurado. Failed: Falha na restauração do ativo de mídia.	Success.
RestoreExpiration	string	A hora de expiração da restauração do ativo de mídia.	2023-03-30T10:14:14Z
UserData	string	As configurações personalizadas. O valor é uma string JSON que suporta configurações como callbacks de mensagem e aceleração de upload. Para mais informações, consulte UserData.	{"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"*****","test":"www"}}
ReferenceId	string	O ID personalizado. O valor pode conter apenas letras minúsculas, letras maiúsculas, dígitos, hifens (-) e sublinhados (_), e deve ter entre 6 e 64 caracteres. O valor é único no nível do usuário.	123-123

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "25818875-5F78-4AF6-D7393642CA58****",
  "NonExistVideoIds": [
    "[\"7753d144efd8e649c6c45fe0579****\"]"
  ],
  "NonExistReferenceIds": [
    "123-123"
  ],
  "VideoList": [
    {
      "StorageLocation": "out-****.oss-cn-shanghai.aliyuncs.com",
      "CreationTime": "2017-06-26T05:38:48Z",
      "Status": "Normal",
      "CateId": 0,
      "VideoId": "7753d144efd74d6c45fe0570****",
      "DownloadSwitch": "on",
      "Tags": "tag1, tag2",
      "ModificationTime": "2017-06-26T06:38:48Z",
      "CateName": "cate1",
      "Description": "Alibaba Cloud VOD video description",
      "AppId": "app-****",
      "Size": 453,
      "CoverURL": "https://example.aliyundoc.com/****.jpg",
      "TemplateGroupId": "b4039216985f4312a5382a4ed****",
      "Duration": 120,
      "Title": "Alibaba Cloud VOD Video Title",
      "Snapshots": [
        "[\"http://example.aliyundoc.com/snapshot/****.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333****\",\"http://example.aliyundoc.com/snapshot/****.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27243****\",...]"
      ],
      "StorageClass": "Standard",
      "RestoreStatus": "Success",
      "RestoreExpiration": "2023-03-30T10:14:14Z",
      "UserData": "{\"MessageCallback\":{\"CallbackURL\":\"http://example.aliyundoc.com\"},\"Extend\":{\"localId\":\"*****\",\"test\":\"www\"}}",
      "ReferenceId": "123-123"
    }
  ]
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.