Todos os produtos
Search

Este produto

    ApsaraVideo VOD:GetDigitalWatermarkExtractResult

    Central de documentação

    ApsaraVideo VOD:GetDigitalWatermarkExtractResult

    Última atualização: Jul 21, 2026

    Consulta os resultados de um trabalho de extração de marca d'água digital (marca d'água de direitos autorais ou marca d'água de rastreamento), incluindo o status do trabalho e o texto da marca d'água extraído com sucesso.

    Descrição da operação

    • Atualmente, esta operação está disponível apenas nas regiões China (Xangai) e China (Pequim).

    • Após chamar a operação SubmitDigitalWatermarkExtractJob para extrair a marca d'água de direitos autorais ou a marca d'água de rastreamento de um vídeo, chame esta operação para consultar o texto da marca d'água extraído.

    • Apenas trabalhos de extração de marca d'água dos últimos 2 anos podem ser consultados.

    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:GetDigitalWatermarkExtractResult

    get

    *全部资源

    *

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    MediaId

    string

    Sim

    O ID do vídeo a ser consultado. Apenas um único ID de vídeo é suportado. Você pode obter o ID do vídeo usando os seguintes métodos:

    • Faça login no console do ApsaraVideo VOD e escolha Arquivos de mídia > Áudio/Vídeo para visualizar o ID do vídeo.

    • Chame a operação SearchMedia. O ID do vídeo (VideoId) é retornado na resposta.

    93ab850b4f6f54b6e91d24d81d4****
    ExtractType

    string

    Sim

    O tipo de extração de marca d'água. Valores válidos:

    • TraceMark: marca d'água de rastreamento.

    • CopyrightMark: marca d'água de direitos autorais.

    TraceMark.
    JobId

    string

    Não

    O ID do trabalho de extração de marca d'água.

    • O ID do trabalho é retornado após você chamar a operação SubmitDigitalWatermarkExtractJob.

    • Se você especificar este parâmetro, o resultado do trabalho de extração de marca d'água especificado será retornado. Se você não especificar este parâmetro, os resultados de todos os trabalhos históricos de extração de marca d'água para o vídeo serão retornados.

    2bf4390af9e5491c09cc720ad****

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    Os parâmetros de resposta.

    RequestId

    string

    O ID da solicitação.

    42E0554B-80F4-4921-****-ACFB22CAAAD0
    AiExtractResultList

    array<object>

    Os detalhes dos trabalhos de extração de marca d'água.

    object

    JobId

    string

    O ID do trabalho de extração de marca d'água.

    3af004763bcf459698860f4ede20****
    CreateTime

    string

    A hora em que o trabalho de extração de marca d'água foi criado.

    2023-09-16T02:49:04Z
    ModifyTime

    string

    A hora em que o trabalho de extração de marca d'água foi atualizado pela última vez.

    2023-09-17T06:20:45Z
    Status

    string

    O status do trabalho de extração de marca d'água. Valores válidos:

    • Success: O trabalho foi bem-sucedido.

    • Failed: O trabalho falhou.

    • Processing: O trabalho está sendo processado.

    Failed.
    ErrorMessage

    string

    A mensagem de erro. Este parâmetro é retornado apenas quando o trabalho de extração de marca d'água falha (o valor de Status é Failed).

    query copyright info err.
    WaterMarkText

    string

    O texto da marca d'água extraído.

    test mark.

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "RequestId": "42E0554B-80F4-4921-****-ACFB22CAAAD0",
  "AiExtractResultList": [
    {
      "JobId": "3af004763bcf459698860f4ede20****",
      "CreateTime": "2023-09-16T02:49:04Z",
      "ModifyTime": "2023-09-17T06:20:45Z",
      "Status": "Failed",
      "ErrorMessage": "query copyright info err",
      "WaterMarkText": "test mark"
    }
  ]
}

    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.