Como migrar do Advanced para o Advanced

Os usuários atuais do Cloud Translation - Basic (v2) que querem usar os recursos mais recentes do Translation, como glossários e modelos de AutoML, precisam migrar os aplicativos para o Cloud Translation - Advanced (v3). Para uma comparação, consulte Comparar as opções Basic e Advanced.

A migração para a edição Advanced inclui o uso do gerenciamento de identidade e acesso (IAM, na sigla em inglês) e das bibliotecas de cliente da edição Advanced. As seções a seguir descrevem as tarefas de migração e as principais diferenças entre as duas edições.

Como migrar para a Advanced

As etapas a seguir descrevem as ações necessárias para atualizar seus aplicativos existentes do uso da Cloud Translation Basic Basic para o Cloud Translation - Advanced.

  1. Faça um inventário dos seus projetos, aplicativos e usuários do Google Cloud que acessam a API Cloud Translation - Basic. Você precisará fornecer contas de serviço e atualizá-las para usar as bibliotecas de cliente do Cloud Translation - Advanced.
  2. Configure contas de serviço e autenticação para seu aplicativo.
  3. Use os papéis do IAM para definir permissões nas contas de serviço.
  4. Ative o Cloud Translation - Advanced para seu projeto. Se você usa modelos AutoML com a versão Advanced, também precisa ativar o AutoML. Para mais informações, consulte o guia Configuração.
  5. Use as bibliotecas e métodos de cliente avançados do Cloud Translation - Cloud. Para solicitações do Cloud Translation - Advanced, inclua o número ou ID do projeto e o local dele, como global ou us-central1.
  6. Verifique se o tamanho das suas solicitações de tradução para o Cloud Translation - Advanced não excede o limite.
  7. Planeje seu monitoramento de cota de solicitação de tradução. As duas versões da API compartilham as mesmas cotas diárias e mensais.
  8. Analise as possíveis alterações no faturamento.

Principais diferenças entre o Advanced e o Basic

Para entender melhor as tarefas de migração, as seções a seguir descrevem as principais diferenças entre as edições Advanced e Basic.

Contas de serviço

Para o Cloud Translation - Basic, é possível enviar solicitações autenticadas usando chaves de API ou contas de serviço.

O Cloud Translation - Advanced tem funcionalidades que exigem recursos gerenciados pelo cliente, como o gerenciamento de permissões e papéis do IAM. Por essa razão, não é possível usar chaves de API para autenticar para o serviço. Em vez disso, é preciso usar contas de serviço ao autenticar para o Cloud Translation - Advanced.

Para mais informações, consulte o guia de configuração.

Papéis IAM

Quando você usa contas de serviço para o Cloud Translation - Basic, as contas de serviço são usadas apenas para autenticação. É possível fazer qualquer chamada para o Cloud Translation - Basic, independentemente das permissões associadas à conta de serviço. No entanto, para o Cloud Translation - Advanced, as permissões se aplicam.

Para conceder permissões de contas de serviço ao chamar o Cloud Translation - Advanced, atribua papéis do IAM a elas. Com o Cloud Translation - Advanced, você tem acesso a vários papéis do IAM que podem ser atribuídos à sua conta de serviço para acessar recursos específicos no seu projeto. Por exemplo, se você quiser usar sua conta de serviço para traduzir texto, atribua o papel roles/cloudtranslate.user a ela. Para mais informações, consulte os papéis do IAM em Cloud Translation - Advanced details.

Se você planeja usar modelos do AutoML ou qualquer recurso que dependa do Cloud Storage, inclua também os papéis apropriados para esses serviços. Para acessar uma lista de todos os papéis do IAM, consulte a documentação sobre papéis do IAM.

Modelos de tradução

Ao solicitar uma tradução do Cloud Translation - Basic, é possível usar um dos dois modelos gerais: tradução automática neural (NMT) ou de tradução baseada em frases (PBMT, na sigla em inglês). Para o Cloud Translation - Advanced, é possível usar os modelos gerais ou um modelo personalizado em AutoML Translation.

As contas de serviço usadas para solicitações de tradução precisam ter as permissões para acessar o AutoML e os modelos gerais, que podem estar localizados em projetos diferentes. Por exemplo, você pode ter um projeto central que contém seus modelos de tradução para simplificar a manutenção e o faturamento. As contas de serviço nesse projeto ou em outros projetos podem usar esses modelos, mas exigem permissões para isso.

Para mais informações sobre modelos de tradução, consulte Como traduzir textos (avançado).

Bibliotecas de cliente

As bibliotecas de cliente e os métodos do Cloud Translation - Advanced são diferentes dos processos do Cloud Translation - Basic. Por exemplo, chamadas para o Cloud Translation - Advanced exigem nomes de recursos. Para mais informações, consulte a visão geral das bibliotecas de cliente do Cloud Translation - Advanced ou acesse o guia de início rápido do texto de tradução (edição avançada).

Recursos, projetos e locais

As solicitações para o Cloud Translation - Advanced exigem o nome do recurso que você quer usar. Um recurso é geralmente um nome qualificado que inclui o nome do projeto e o local dele, que especifica onde a solicitação é executada. Por exemplo, o nome de um modelo AutoML é um nome de recurso.

Se seu projeto do Google Cloud tiver o nome my-project e o local do recurso for us-central1, o nome completo de seus recursos será semelhante ao seguinte:

projects/MY_PROJECT/locations/us-central1/...

O URL para o qual você envia uma solicitação getSupportedLanguages pode ser semelhante ao seguinte:

https://translation.googleapis.com/v3/projects/my-project/locations/us-central1/supportedLanguages

Limite de conteúdo por solicitação

A API Cloud Translation é otimizada para tradução de solicitações menores. O tamanho máximo recomendado para cada solicitação é de 5.000 caracteres (pontos de código). No entanto, quanto mais você incluir, maior será a latência de resposta. Para a Cloud Translation - Advanced, o número máximo de pontos de código para uma única solicitação é de 30.000. O tamanho máximo para solicitações da Cloud Translation - Basic é de 100.000 bytes.

A API Cloud Translation rejeitará solicitações maiores que o limite e enviará um erro 400 INVALID_ARGUMENT, independentemente da cota disponível.

Para mais informações sobre cotas e limites, consulte esta página.

A seguir

Use o Cloud Translation - Advanced para traduzir texto, criar glossários ou fazer solicitações em lote.