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

Obtém as informações sobre um único arquivo de áudio ou vídeo por ID de á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

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 uma notificação de evento para AudioVideoAnalysisComplete. Após receber a notificação de evento AudioVideoAnalysisComplete, chame esta operação para obter as informações do áudio ou 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:GetVideoInfo

get

*全部资源

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
VideoId	string	Não	O ID do áudio ou vídeo. Apenas um ID de áudio ou vídeo é suportado. Você pode obter o ID usando um dos seguintes métodos: Para vídeos enviados pelo console, 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, chame a operação SearchMedia para consultar o ID do áudio ou vídeo, que corresponde ao valor do parâmetro de resposta VideoId.	9b73864d75f1d231e9001cd5f8****
ReferenceId	string	Não	O ID personalizado. Apenas letras minúsculas, letras maiúsculas, dígitos, hifens e sublinhados são suportados. O comprimento deve ser de 6 a 64 caracteres. O ID é único no nível do usuário.	123-123

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****
Video	object	As informações do áudio ou vídeo.
StorageLocation	string	O endereço de armazenamento do arquivo de áudio ou vídeo.	out-201703232251****.oss-cn-shanghai.aliyuncs.com.
CreationTime	string	A hora em que o arquivo de áudio ou vídeo foi criado. A hora está no formato aaaa-MM-ddTHH:mm:ssZ (UTC).	2017-11-14T09:15:50Z
Status	string	O status do arquivo de áudio ou vídeo. Para mais informações sobre as operações que podem ser realizadas em arquivos de áudio e vídeo em cada status e os limites, consulte Status: status de áudio e vídeo. Valores válidos: Uploading: O arquivo está sendo enviado. UploadFail: Falha no envio do arquivo. UploadSucc: O arquivo foi enviado. Transcoding: O arquivo está sendo transcodificado. TranscodeFail: Falha na transcodificação do arquivo. Blocked: O arquivo está bloqueado. Normal: O arquivo está em estado normal.	Normal.
CateId	integer	O ID da categoria.	781111****
VideoId	string	O ID do áudio ou vídeo.	9b73864d75f1d231e9001cd5f8****
DownloadSwitch	string	O status da chave de download offline. Após a ativação do recurso de download offline, 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. Múltiplas tags são separadas por vírgulas (,).	tag1, tag2
ModificationTime	string	A hora da última atualização do arquivo de áudio ou vídeo. A hora está no formato aaaa-MM-ddTHH:mm:ssZ (UTC).	2017-11-14T10:15:50Z
RegionId	string	A região onde o arquivo de áudio ou vídeo está armazenado.	cn-shanghai.
CustomMediaInfo	string	As informações personalizadas do ativo de mídia. Nota Este parâmetro foi descontinuado. A API não retorna mais este parâmetro.	{"aaa":"test"}
CateName	string	O nome da categoria.	cate1
Description	string	A descrição do arquivo de áudio ou vídeo.	Descrição do vídeo do 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.	10897890
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.	9ae2af636ca64835b0c10412f448****
Duration	number	A duração do arquivo de áudio ou vídeo. Unidade: segundos.	135.6
Title	string	O título do arquivo de áudio ou vídeo.	Título do Vídeo do Alibaba Cloud VOD.
AuditStatus	string	O resultado final da revisão do arquivo de áudio ou vídeo. Valores válidos: Normal: Aprovado. Blocked: Bloqueado.	Normal.
Snapshots	object
Snapshot	array	Uma matriz de URLs de snapshots de vídeo.
	string	Uma matriz de URLs de snapshots de vídeo. Nota Esta operação retorna apenas os dados de miniatura do vídeo. Para consultar os dados de snapshots normais, sprites, imagens de sprite originais e snapshots WebVTT capturados usando o recurso de snapshot, 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 (ativo de mídia). Archive: Arquivo (ativo de mídia). ColdArchive: Arquivo Frio (ativo de mídia). SourceIA: Acesso Pouco Frequente (arquivo de origem). SourceArchive: Arquivo (arquivo de origem). SourceColdArchive: Arquivo Frio (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. Apenas letras minúsculas, letras maiúsculas, dígitos, hifens e sublinhados são suportados. O comprimento deve ser de 6 a 64 caracteres. O ID é único no nível do usuário.	123-123

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "25818875-5F78-4AF6-D7393642CA58****",
  "Video": {
    "StorageLocation": "out-201703232251****.oss-cn-shanghai.aliyuncs.com",
    "CreationTime": "2017-11-14T09:15:50Z",
    "Status": "Normal",
    "CateId": 0,
    "VideoId": "9b73864d75f1d231e9001cd5f8****",
    "DownloadSwitch": "on",
    "Tags": "tag1, tag2",
    "ModificationTime": "2017-11-14T10:15:50Z",
    "RegionId": "cn-shanghai",
    "CustomMediaInfo": "{\"aaa\":\"test\"}",
    "CateName": "cate1",
    "Description": "Alibaba Cloud VOD video description",
    "AppId": "app-****",
    "Size": 10897890,
    "CoverURL": "https://example.aliyundoc.com/****.jpg",
    "TemplateGroupId": "9ae2af636ca64835b0c10412f448****",
    "Duration": 135.6,
    "Title": "Alibaba Cloud VOD Video Title",
    "AuditStatus": "Normal",
    "Snapshots": {
      "Snapshot": [
        "[\"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.