Todos os produtos
Search

Este produto

    Intelligent Media Management:CreateOfficeConversionTask

    Central de documentação

    Intelligent Media Management:CreateOfficeConversionTask

    Última atualização: Jun 29, 2026

    Cria uma tarefa de conversão de documentos que converte documentos, como arquivos Word, PowerPoint, Excel e PDF, armazenados no Object Storage Service (OSS) em imagens, arquivos de texto ou arquivos PDF.

    Descrição da operação

    • Antes de usar esta operação, certifique-se de que você compreende os métodos de cobrança e os preços do Intelligent Media Management (IMM).

      Importante O tempo de execução de tarefas assíncronas não é garantido.

    • Formatos de arquivo de entrada suportados:

      • Documentos de processamento de texto (Word): doc, docx, wps, wpss, docm, dotm, dot e dotx.

      • Documentos de apresentação (PowerPoint): pptx, ppt, pot, potx, pps, ppsx, dps, dpt, pptm, potm, ppsm e dpss.

      • Documentos de planilha (Excel): xls, xlt, et, ett, xlsx, xltx, csv, xlsb, xlsm, xltm e ets.

      • Documentos PDF: pdf.

    • Formatos de arquivo de saída suportados:

      • Imagens: png e jpg.

      • Texto: txt.

      • PDF: pdf.

    • O tamanho máximo de um único arquivo é 200 MB. Este limite não pode ser alterado.

    • Se um arquivo for grande ou seu conteúdo for complexo, a conversão pode expirar por tempo limite.

    • O número de solicitações por segundo é limitado a 50 para um único usuário.

    • As informações da tarefa são armazenadas por apenas 7 dias após o início da tarefa. Após esse período, as informações não podem ser recuperadas. Você pode obter prontamente as informações da tarefa usando um dos seguintes métodos:

    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

    imm:CreateOfficeConversionTask

    create

    *Project

    acs:imm:{#regionId}:{#accountId}:project/{#ProjectName}

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    ProjectName

    string

    Sim

    O nome do projeto. Para mais informações sobre como obter o nome do projeto, consulte Criar um projeto.

    test-project
    SourceURI

    string

    Não

    O endereço de armazenamento dos dados de origem.

    O endereço OSS deve estar no formato oss://${Bucket}/${Object}. `${Bucket}` é o nome do bucket OSS que está na mesma região do projeto atual. `${Object}` é o caminho completo do arquivo, incluindo a extensão do nome do arquivo.

    oss://test-bucket/test-object
    Sources

    array<object>

    Não

    Uma lista de imagens de entrada. As imagens são convertidas na ordem de seus URIs na lista. (Este parâmetro ainda não foi publicado. Não o utilize.)

    oss://imm-test/test.pptx

    object

    Não

    As informações sobre uma imagem de entrada.

    URI

    string

    Não

    O endereço OSS da imagem de origem.

    O endereço OSS deve estar no formato oss://${Bucket}/${Object}. ${Bucket} é o nome do bucket OSS que está na mesma região do projeto atual. ${Object} é o caminho completo do arquivo, incluindo a extensão do nome do arquivo.

    Formatos de imagem suportados: jpg, jp2, png, tiff, webp, bmp e svg.

    oss://examplebucket/sampleobject.jpg
    Rotate

    integer

    Não

    O ângulo de rotação da imagem. Valores válidos:

    • 0 (padrão)

    • 90

    • 180

    • 270

    90
    TargetURI

    string

    Não

    O modelo para o endereço de saída do documento convertido.

    O endereço deve estar no formato oss://{bucket}/{tags.custom}/{dirname}/{barename}.{autoext}. Para mais informações, consulte Modelos de TargetURI.

    Nota

    Especifique este parâmetro ou `TargetURIPrefix`.

    oss://examplebucket/outputDocument.pdf
    TargetURIPrefix

    string

    Não

    O prefixo do endereço de armazenamento do arquivo de saída após a conversão do documento.

    O prefixo deve estar no formato oss://${Bucket}/${Prefix}/. `${Bucket}` é o nome do bucket OSS que está na mesma região do projeto atual. `${Prefix}` é o prefixo do endereço de armazenamento do arquivo de saída.

    Nota

    Especifique este parâmetro ou `TargetURI`.

    oss://examplebucket/outputprefix/
    SourceType

    string

    Não

    O tipo de extensão dos dados de origem. Por padrão, o tipo dos dados de origem é determinado pela extensão do objeto OSS. Se o objeto OSS não tiver uma extensão, você pode definir este parâmetro. Valores válidos:

    • Documentos de processamento de texto (Word): doc, docx, wps, wpss, docm, dotm, dot e dotx

    • Documentos de apresentação (PowerPoint): pptx, ppt, pot, potx, pps, ppsx, dps, dpt, pptm, potm, ppsm e dpss

    • Documentos de planilha (Excel): xls, xlt, et, ett, xlsx, xltx, csv, xlsb, xlsm, xltm e ets

    • Documentos PDF: pdf

    doc
    TargetType

    string

    Sim

    O tipo do arquivo de saída. Valores válidos:

    • png: Converte o documento em imagens PNG.

    • jpg: Converte o documento em imagens JPG.

    • pdf: Converte o documento em um arquivo PDF.

    • txt: Converte o documento em um arquivo somente texto. Isso é usado principalmente para extrair conteúdo de texto do arquivo. Esta opção é suportada apenas para documentos de apresentação, documentos de processamento de texto e documentos de planilha. Ao converter um documento de planilha, um único arquivo txt é gerado, e as configurações de variáveis relacionadas a planilhas não entram em vigor.

    png
    UserData

    string

    Não

    As informações personalizadas. Essas informações são retornadas na mensagem de notificação assíncrona para ajudá-lo a associar a notificação aos seus serviços. O valor pode ter até 2.048 bytes de comprimento.

    { "id": "test-id", "name": "test-name" }
    Tags

    object

    Não

    As tags personalizadas. O valor é um dicionário. Você pode usar tags para pesquisar tarefas.

    { "key": "value" }
    StartPage

    integer

    Não

    A página inicial para a conversão do documento. O valor padrão é 1.

    Nota

    • Se o arquivo de origem for uma planilha, você deve especificar o número da planilha.

    • Este parâmetro entra em vigor apenas quando você converte o documento em imagens. Ele não entra em vigor quando você converte o documento em um arquivo PDF ou um arquivo de texto.

    1
    EndPage

    integer

    Não

    A página final para a conversão do documento. O valor padrão é -1, o que indica que todas as páginas da página inicial até a última página são convertidas.

    Nota

    • Se o arquivo de origem for uma planilha, você deve especificar o número da planilha (`SheetIndex`).

    • Se o documento tiver muitas páginas, recomendamos que você as converta em lotes. Caso contrário, a conversão pode expirar por tempo limite.

    • Este parâmetro entra em vigor apenas quando você converte o documento em imagens. Ele não entra em vigor quando você converte o documento em um arquivo PDF ou um arquivo de texto.

    -1
    Password

    string

    Não

    A senha para abrir o documento. Defina este parâmetro se você deseja converter um documento protegido por senha.

    123456
    ScalePercentage

    integer

    Não

    A proporção de escala do documento. Valores válidos: 20 a 199. O valor padrão é 100, o que indica que o documento não é redimensionado.

    Nota

    Um valor menor que 100 indica que o documento é reduzido. Um valor maior que 100 indica que o documento é ampliado.

    100
    Quality

    integer

    Não

    A qualidade do arquivo convertido. Valores válidos: 0 a 100. Um valor de 0 indica a menor qualidade e o melhor desempenho. Um valor de 100 indica a maior qualidade e o pior desempenho. Por padrão, o sistema define um valor apropriado com base no conteúdo do documento para equilibrar qualidade e desempenho.

    60
    Pages

    string

    Não

    Os números das páginas a converter. Este parâmetro tem prioridade mais alta do que os parâmetros `StartPage` e `EndPage`. O formato é o seguinte:

    • Separe vários números de página com vírgulas (,), por exemplo, 1,2.

    • Especifique um intervalo de páginas consecutivas com um hífen (-), por exemplo, 1,2-4,7.

    1,2-4,7
    MaxSheetRow

    integer

    Não

    O número máximo de linhas a converter ao converter um documento de planilha em imagens. Por padrão, todas as linhas são convertidas.

    Nota

    Este parâmetro entra em vigor apenas quando você define LongPicture como true.

    10
    MaxSheetColumn

    integer

    Não

    O número máximo de colunas a converter ao converter um documento de planilha em imagens. Por padrão, todas as colunas são convertidas.

    Nota

    Este parâmetro entra em vigor apenas quando você define LongPicture como true.

    10
    SheetCount

    integer

    Não

    O número de planilhas a converter em imagens no documento de planilha. Por padrão, todas as planilhas são convertidas.

    1
    SheetIndex

    integer

    Não

    O número da planilha a converter em imagens no documento de planilha. Valores válidos: 1 até o número da última planilha. O valor padrão é 1.

    1
    FitToWidth

    boolean

    Não

    Ao converter um documento de planilha em imagens ou um arquivo PDF, especifica se todas as colunas devem ser renderizadas em uma única imagem ou página PDF. Valores válidos:

    • false (padrão): Não. O conteúdo é renderizado em várias imagens ou páginas PDF.

    • true: Sim. O conteúdo é renderizado em uma única imagem ou página PDF.

    false
    FitToHeight

    boolean

    Não

    Ao converter um documento de planilha em imagens ou um arquivo PDF, especifica se todas as linhas devem ser renderizadas em uma única imagem ou página PDF. Valores válidos:

    • false (padrão): Não. O conteúdo é renderizado em várias imagens ou páginas PDF.

    • true: Sim. O conteúdo é renderizado em uma única imagem ou página PDF.

    false
    FirstPage

    boolean

    Não

    Ao converter um documento de planilha em imagens, especifica se deve retornar apenas a primeira imagem do resultado da conversão. O número de linhas e colunas na imagem é o resultado da divisão automática. Valores válidos:

    • false (padrão): Não. Todas as imagens são retornadas.

    • true: Sim. Apenas a primeira imagem é retornada. Isso é usado para extrair uma miniatura.

    Nota

    Este parâmetro entra em vigor apenas se você definir o parâmetro LongPicture como true.

    false
    PaperSize

    string

    Não

    O tamanho do papel para converter um documento de planilha em imagens. A imagem de saída é semelhante a uma página impressa. Valores válidos:

    • A0

    • A2

    • A4 (padrão)

    Nota

    Este parâmetro entra em vigor apenas quando você o utiliza com os parâmetros FitToHeight e FitToWidth.

    A4
    PaperHorizontal

    boolean

    Não

    Ao converter um documento de planilha em imagens, especifica se o papel deve ser colocado horizontalmente. A imagem de saída é semelhante a uma página impressa. Valores válidos:

    • false (padrão): Não. O papel é colocado verticalmente.

    • true: Sim. O papel é colocado horizontalmente.

    false
    TrimPolicy TrimPolicy

    Não

    A política de recorte para conversão de planilhas. Por exemplo, se uma planilha contiver muitas linhas e colunas vazias, uma grande quantidade de espaço em branco pode ser gerada se nenhuma política de recorte for especificada.

    ShowComments

    boolean

    Não

    Ao converter um documento de processamento de texto em imagens, especifica se os comentários devem ser exibidos. Valores válidos:

    • false (padrão): Não. Os comentários não são exibidos.

    • true: Sim. Os comentários são exibidos.

    false
    LongPicture

    boolean

    Não

    Ao converter um documento em imagens, especifica se deve ser convertido em uma imagem longa. Valores válidos:

    • false (padrão): Não. O documento é convertido em várias imagens.

    • true: Sim. O documento é convertido em uma imagem longa.

    Nota

    Você pode combinar no máximo 20 páginas em uma imagem longa. Se o número de páginas exceder esse limite, a tarefa de conversão pode falhar.

    false
    ImageDPI

    integer

    Não

    O DPI da imagem de saída. Valores válidos: 96 a 600. O valor padrão é 96.

    96
    LongText

    boolean

    Não

    Ao converter um documento em texto, especifica se deve ser convertido em um arquivo de texto longo. Valores válidos:

    • false (padrão): Não. Cada página do documento é convertida em um arquivo de texto separado.

    • true: Sim. Todo o conteúdo é colocado em um único arquivo de texto.

    false
    HoldLineFeed

    boolean

    Não

    Ao converter um documento em texto, especifica se as quebras de linha no documento devem ser mantidas. Valores válidos:

    • false (padrão): Não. As quebras de linha não são mantidas.

    • true: Sim. As quebras de linha são mantidas.

    false
    CredentialConfig CredentialConfig

    Não

    Se você não tiver requisitos especiais, deixe este parâmetro vazio.

    A configuração de autorização encadeada. Este parâmetro não é obrigatório. Para mais informações, consulte Usar autorização encadeada para acessar recursos de outras entidades.

    Notification Notification

    Não

    A configuração de notificação de mensagem. Para mais informações, clique em Notification. Para mais informações sobre o formato das mensagens de notificação assíncrona, consulte Formato de mensagem de notificação assíncrona.

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    A resposta para a tarefa assíncrona.

    RequestId

    string

    O ID da solicitação.

    FF3B7D81-66AE-47E0-BF69-157DCF18*****
    TaskId

    string

    O ID da tarefa.

    formatconvert-00bec802-073a-4b61-ba3b-39bc2fdd*****
    EventId

    string

    O ID do evento.

    2C2-1I0EG57VR37J4rQ8oKG6C9*****

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "RequestId": "FF3B7D81-66AE-47E0-BF69-157DCF18*****",
  "TaskId": "formatconvert-00bec802-073a-4b61-ba3b-39bc2fdd*****",
  "EventId": "2C2-1I0EG57VR37J4rQ8oKG6C9*****"
}

    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.