Consulta uma lista de ativos de mídia na biblioteca de mídia pública que atendem às condições especificadas. Podem ser retornados no máximo 100 ativos de mídia.
Experimente agora
Testar
Autorização RAM
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| MediaTagId |
string |
Não |
A tag de mídia. Todos os ativos de mídia que contêm a tag de mídia especificada são retornados. Valores válidos:
|
sticker-atmosphere |
| NextToken |
string |
Não |
O token de paginação que é usado na próxima solicitação para recuperar uma nova página de resultados. Você não precisa especificar este parâmetro na primeira solicitação. Você deve especificar o token obtido da consulta anterior como o valor de NextToken. |
pSa1SQ0wCe5pzVrQ6mWZEw== |
| MaxResults |
integer |
Não |
O número máximo de entradas a serem retornadas. Valor máximo: 100. Valor padrão: 10. |
5 |
| PageNo |
integer |
Não |
O número da página. Valor padrão: 1. |
1 |
| PageSize |
integer |
Não |
O número de entradas por página. Valor padrão: 10. Valor máximo: 100. |
10 |
| IncludeFileBasicInfo |
boolean |
Não |
Especifica se as informações básicas do ativo de mídia devem ser retornadas. |
true |
| BusinessType |
string |
Não |
O tipo de negócio do ativo de mídia. Valores válidos:
|
sticker |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
Os parâmetros de resposta. |
||
| RequestId |
string |
O ID da solicitação. |
******B7-7F87-4792-BFE9-63CD21****** |
| TotalCount |
integer |
O número total de ativos de mídia que atendem às condições especificadas. |
2 |
| MediaInfos |
array<object> |
Os ativos de mídia que atendem às condições especificadas. |
|
|
array<object> |
|||
| MediaId |
string |
O ID do ativo de mídia. |
****019b82e24b37a1c2958dec38**** |
| MediaBasicInfo |
object |
As informações básicas do ativo de mídia. |
|
| MediaId |
string |
The ID of the media asset. |
****019b82e24b37a1c2958dec38**** |
| InputURL |
string |
The URL of the media asset in another service. |
https://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4 |
| MediaType |
string |
The type of the media asset. |
video |
| BusinessType |
string |
The business type of the media asset. |
general |
| Source |
string |
The source of the media asset. |
oss |
| Title |
string |
The title of the media asset. |
My video title |
| Description |
string |
The description of the media asset. |
description |
| Category |
string |
The category of the media asset. |
video |
| MediaTags |
string |
The tags of the media asset. |
sticker-daily |
| CoverURL |
string |
The thumbnail URL of the media asset. |
http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires= |
| UserData |
string |
The user data. |
userData |
| Snapshots |
string |
The snapshots of the media asset. |
null |
| Status |
string |
The status of the media asset. |
Normal |
| TranscodeStatus |
string |
The transcoding status of the media asset. |
Init |
| CreateTime |
string |
The time when the media asset was created. |
2021-01-08T16:52:04Z |
| ModifiedTime |
string |
The time when the media asset was last modified. |
2021-01-08T16:52:04Z |
| DeletedTime |
string |
The time when the media asset was deleted. |
2021-01-08T16:52:04Z |
| FileInfoList |
array<object> |
As informações de arquivo do ativo de mídia. |
|
|
array<object> |
|||
| FileBasicInfo |
object |
The basic information of the file, such as the duration and size. |
|
| FileName |
string |
The file name. |
example.mp4 |
| FileStatus |
string |
The file status. |
Normal |
| FileType |
string |
The file type. |
source_file |
| FileSize |
string |
The file size. Unit: bytes. |
338990717 |
| FileUrl |
string |
The Object Storage Service (OSS) URL of the file. |
http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4?Expires= |
| Region |
string |
The region in which the file resides. |
cn-shanghai |
| FormatName |
string |
The container format. |
mov,mp4,m4a,3gp,3g2,mj2 |
| Duration |
string |
The duration. |
10.040000 |
| Bitrate |
string |
The bitrate. |
270112.12 |
| Width |
string |
The width. |
1920 |
| Height |
string |
The height. |
1080 |
| NextToken |
string |
Um token de paginação. Ele pode ser usado na próxima solicitação para recuperar uma nova página de resultados. Se NextToken estiver vazio, não há próxima página. |
8EqYpQbZ6Eh7+Zz8DxVYoQ== |
| MaxResults |
integer |
O número máximo de entradas retornadas. |
2 |
Exemplos
Resposta de sucesso
JSON formato
{
"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": "My video 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
}
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.