Translate: tarefa de documento

Com a tarefa Translate - Document, é possível traduzir um único arquivo de documentos em tempo real (de maneira síncrona) usando o Cloud Translation. Você pode traduzir diretamente documentos formatados, como PDF e DOCX, preservando a formatação e o layout originais. Para informações sobre os formatos de arquivo compatíveis com a tradução de documentos, consulte Formatos de arquivo compatíveis.

O Cloud Translation é um serviço do Google Cloud que permite traduzir textos para mais de cem pares de idiomas com a capacidade de detecção automática. Para uma lista de idiomas compatíveis, consulte Idiomas compatíveis.

Antes de começar

Execute as seguintes tarefas no projeto do Google Cloud antes de configurar a tarefa Translate - Document:

  1. Ativar a API Cloud Translation (translate.googleapis.com).

    Ativar a API Cloud Translation

  2. Criar um perfil de autenticação. A integração da Apigee usa um perfil de autenticação para se conectar a um endpoint de autenticação para a tarefa Translate - Document.

    Para informações sobre como conceder papéis ou permissões adicionais a uma conta de serviço, consulte Como conceder, alterar e revogar acesso.

Configurar a tarefa Document - Translate

  1. Na IU da Apigee, selecione sua organização da Apigee.
  2. Clique em Desenvolver > Integrações.
  3. Selecione uma integração existente ou clique em Criar integração.

    Caso você esteja criando uma nova integração, siga estas etapas:

    1. Digite um nome e uma descrição na caixa de diálogo Criar integração.
    2. Selecione uma Região para a integração na lista de regiões compatíveis.
    3. Clique em Criar.

    Isso abre a integração na página do designer de integração.

  4. Na barra de navegação do designer de integração, clique em +Adicionar uma tarefa/gatilho> Tarefas para ver a lista de tarefas disponíveis.
  5. Clique e coloque o elemento Translate - Document no designer de integração.
  6. Clique no elemento Translate - Document no designer para ver o painel de configuração de tarefas Translate - Document.
  7. Acesse Autenticação e selecione o perfil de autenticação que você quer usar.

    Opcional. Se você não tiver criado um perfil de autenticação antes de configurar a tarefa, clique em + Novo perfil de autenticação e siga as etapas em Criar um novo perfil de autenticação.

  8. Acesse Entrada de tarefas e configure os campos de entrada exibidos com a tabela Parâmetros de entrada de tarefas.

    As mudanças nos campos de entrada são salvas automaticamente.

Parâmetros de entrada da tarefa

A tabela a seguir descreve os parâmetros de entrada da tarefa Translate - Document:

Propriedade Tipo de dados Descrição
Região String Região em que você quer executar a operação de tradução. Por exemplo, us-central1.
ProjectsId String É o ID do seu projeto no Google Cloud.
Solicitação JSON Consulte Estrutura de solicitação JSON. É preciso especificar o campo mimeType do JSON da solicitação para traduções de documentos inline.

Saída da tarefa

A tarefa Translate - Document retorna o documento traduzido, semelhante à seguinte saída de exemplo: 

{
    "documentTranslation": {
        "byteStreamOutputs": ["BYTE_STREAM"],
        "mimeType": "MIME_TYPE"
    },
    "model": "projects/[PROJECT_NUMBER]/locations/[LOCATION]/models/general/nmt"
}

Formatos de arquivo compatíveis

O Cloud Translation é compatível com os seguintes tipos de arquivo de entrada e com os tipos de arquivo de saída associados. Saiba mais sobre os Limites de tamanho de arquivo de documentos.

Entradas Tipo de documento MIME Saída
DOC application/msword DOC, DOCX
DOCX application/vnd.openxmlformats-officedocument.wordprocessingml.document DOCX
PDF application/pdf PDF e DOCX
PPT application/vnd.ms-powerpoint PPT, PPTX
PPTX application/vnd.openxmlformats-officedocument.presentationml.presentation PPTX
XLS application/vnd.ms-excel XLS, XLSX
XLSX application/vnd.openxmlformats-officedocument.spreadsheetml.sheet XLSX

Limites de tamanho do arquivo do documento

Tipo de arquivo Limites de tamanho
PDF Até 20 MB
PDF nativo

O campo isTranslateNativePdfOnly precisa ser definido como true

Até 20 MB com um limite de 300 páginas
PDF verificado Até 20 MB com um limite de 20 páginas
Outros tipos de arquivo Até 20 MB sem limite de páginas

Estratégia de solução de erros

A estratégia de solução de erros para uma tarefa especifica a ação a ser realizada se a tarefa falhar devido a um erro temporário. Para mais informações sobre como usar uma estratégia de tratamento de erros e conhecer os diferentes tipos de estratégias de tratamento de erros, consulte Estratégias de tratamento de erros.

A seguir

  1. Adicione bordas e condições de borda.
  2. Teste e publique sua integração.
  3. Configure um gatilho.
  4. Adicione uma tarefa de mapeamento de dados.
  5. Confira todas as tarefas para os serviços do Google Cloud.