Pré-requisitos

• Acesso ao console do Google Cloud.
• Ambiente SoftExpert Suite hospedado em nuvem.
• Acesso ao menu Configuração > Central de integrações (COP010).
• Permissão ''Funcionalidades de IA'' habilitada em Configuração > Grupo de acesso (CM011) > Outras permissões > Funcionalidades de IA.

Apresentação

A API Google v2 é utilizada para tradução automática de texto, enquanto a v3 é utilizada para tradução automática de texto e de arquivos.

Para configurar a API de integração Google v2 ou v3, é necessário gerar previamente as credenciais no console do Google Cloud.

O console do Google Cloud não requer instalação ou configuração prévia e pode ser acessado diretamente por meio de um navegador.

Este artigo apresenta o passo a passo para gerar as credenciais necessárias, tanto para a versão Google v2 quanto para a Google v3.

Gerar credencial para API Google v2 (tradução de textos)

1. Acesse o console do Google Cloud por meio do navegador.

2. Na tela inicial, clique em Menu de navegação > APIs e Serviços > Credenciais.

3. Clique em Criar credenciais e selecione a opção Chave de API.

4. Informe os dados necessários para a criação da chave:

• Nome: use um nome exclusivo para identificar sua chave de API.
• Autenticar chamadas de API por uma conta de serviço: selecione esta opção caso deseje autenticar as chamadas de API pela conta de serviço e vincule uma conta.
• Restrições do aplicativo/API: selecione um tipo de aplicativo e/ou APIs específicos para restringir o acesso.

5. Clique em Criar.

6. A chave será gerada; copie-a e armazene-a com segurança, pois será utilizada posteriormente.

7. Acesse o componente Configuração > Central de integrações (COP010) > API de integração.

8. Clique no botão para incluir uma nova API do tipo Google v2.

9. Informe o título e, no campo API Key, informe a chave gerada no console do Google Cloud.

10. Clique no botão .

11. Ainda no menu Central de integrações (COP010), aba Tradução, seção Texto, selecione a API Google v2 cadastrada anteriormente.

12. Clique no botão .

Gerar credencial para API Google v3 (tradução de textos e arquivos)

1. Acesse o console do Google Cloud por meio do navegador.

2. Na tela inicial, clique em Menu de navegação > APIs e Serviços > Credenciais.

3. Clique em Criar credenciais e selecione a opção Conta de serviço.

4. Na etapa 1, Criar conta de serviço, informe o nome e o ID da conta de serviço.

5. Clique em Criar e continuar.

6. Na etapa 2, Permissões, selecione a opção Usuário da API Cloud Translation no campo Selecionar papel.

7. Clique em Continuar.

8. Na etapa 3, Principais com acesso, informe os usuários que irão ter o papel de usuário ou de administrador da conta de serviço.

9. Clique em Concluído.

10. De volta à tela inicial do console, em Contas de serviço, selecione a conta criada e clique em Editar conta de serviço.

11. Na tela que será exibida, acesse a aba Chaves, clique em Adicionar chaves e, em seguida, em Criar nova chave.

12. Em Tipo de chave, selecione a opção JSON.

13. Clique em Criar. O arquivo JSON será baixado automaticamente.

14. Acesse o componente Configuração > Central de integrações (COP010) > API de integração.

15. Clique no botão para incluir uma nova API do tipo Google v3 e preencha os campos com base nas informações contidas no arquivo JSON baixado:

• E-mail: cliente_email.
• Identificador do projeto: project_id.
• Chave privada: private_key.

16. Clique no botão .

17. Ainda no menu Central de integrações (COP010), acesse a aba Tradução.

18. Na seção Texto, selecione a API Google v3 cadastrada anteriormente. Em Arquivos, também selecione a mesma API Google v3.

19. Clique no botão .

Conclusão

Com as credenciais geradas, é possível prosseguir com a configuração da API de integração para as opções Google v2 e Google v3.