Todos os produtos
Search
Central de documentação

ApsaraVideo VOD:Gerenciar categorias de ativos de mídia

Última atualização: Jun 27, 2026

O ApsaraVideo VOD permite categorizar materiais de áudio, vídeo, imagem e vídeos curtos para facilitar a busca e o gerenciamento.

Limites

As categorias de áudio, vídeo e imagem aceitam até três níveis, enquanto as de material de vídeo curto aceitam até dois. Cada nível comporta no máximo 100 subcategorias.

Como usar

Etapa 1: Crie uma categoria

Console

  1. Faça login no console do ApsaraVideo VOD.

  2. No painel de navegação à esquerda, escolha Configuration Management > Media Management > Categories.

  3. Crie uma categoria.

    • Categoria de Áudio/Vídeo/Imagem

      Importante

      É possível criar até três níveis de categorias, com no máximo 100 subcategorias por nível.

      • Na aba Audio/Video/Image Category, clique em Add Level 1 Category, insira o nome da categoria e pressione Enter.

        Personalize a árvore de categorias dos seus ativos de áudio e vídeo.

      • Atalhos de teclado:

        • Enter: adiciona uma categoria no mesmo nível.

        • Alt+Enter: adiciona uma subcategoria.

        • Delete: exclua a categoria selecionada.

    • Categoria de Material de Vídeo Curto

      Importante

      É possível criar até dois níveis de categorias, com no máximo 100 subcategorias por nível.

      • Na aba Short Video Material Category, clique em Add category button na categoria de nível 1, insira o nome da categoria e pressione Enter para adicioná-la.

        As categorias padrão de nível 1 (MV, Face Sticker, Dynamic Sticker, Subtitle e Font) não podem ser modificadas, mas é possível personalizar suas subcategorias.

      • Atalhos de teclado:

        • Enter: adiciona uma categoria no mesmo nível.

        • Alt+Enter: adiciona uma subcategoria.

        • Delete: exclua a categoria selecionada.

API

Chame a operação AddCategory para crie uma categoria ou subcategoria.

Etapa 2: Atribuir uma categoria

Console

Nota

Este exemplo usa um vídeo. O processo é semelhante para materiais de áudio, imagem e vídeos curtos.

Atribuir uma categoria durante o upload

  1. Faça login no console do ApsaraVideo VOD.

  2. No painel de navegação à esquerda, escolha Media Files > Audio/Video.

  3. Clique em Upload Audio/Video.

  4. Clique em Add Audio/Video e configure o método de upload, o bucket e outros parâmetros.

  5. Após adicionar arquivos à lista de upload, expanda Unclassified para selecionar uma categoria. Na lista de arquivos, clique em no menu suspenso da coluna Category e selecione uma categoria, como Video-Category-123.

  6. Clique em Upload.

    A coluna Category exibirá a categoria atribuída, como Video-Category-123.

Categorizar um ativo existente

  1. Faça login no console do ApsaraVideo VOD.

  2. No painel de navegação à esquerda, escolha Media Files > Audio/Video.

  3. Localize o vídeo a ser categorizado e clique em Manage.

  4. Na aba Basics, clique em Editing Video Information.

  5. Expanda a lista suspensa Categories e selecione uma categoria, como Tutorials. Para crie ou gerencie categorias, clique em Manage Categories.

  6. Clique em Save.

    A categoria atualizada aparecerá na página Audio/Video.

API

Atribuir uma categoria durante o upload

Para categorizar ativos durante o upload, especifique o parâmetro CateId ou CateIds em uma das seguintes operações:

Categorizar um ativo existente

Para alterar a categoria de um ativo de mídia existente, inclua o parâmetro CateId ou CateIds em uma das seguintes operações:

Etapa 3: Pesquisar ativos de mídia por categoria

Console

Nota

Este exemplo usa um vídeo. O processo é semelhante para materiais de áudio, imagem e vídeos curtos.

  1. Faça login no console do ApsaraVideo VOD.

  2. No painel de navegação à esquerda, escolha Media Files > Audio/Video.

  3. Clique em no ícone de filtro Filter button na coluna Category, selecione o nome de uma categoria e clique em OK.

    A página Audio/Video exibirá apenas os arquivos da categoria selecionada.

API

Chame a operação SearchMedia e defina o parâmetro Match para filtrar por CateName (nome da categoria) ou CateId (ID da categoria).

Gerencie categorias

Consulte, modifique ou exclua categorias conforme necessário.

Nota

A exclusão de uma categoria também remove todas as suas subcategorias.

Console

  1. Faça login no console do ApsaraVideo VOD.

  2. No painel de navegação à esquerda, escolha Configuration Management > Media Management > Categories.

  3. Localize a categoria desejada. Use os botões na tela ou atalhos de teclado para modifique, adicionar ou exclua categorias.

API

Chame as operações abaixo para modifique, consultar ou exclua categorias: