GSP049
Visão geral
A API Cloud Translation usa a tecnologia de tradução automática neural do Google para traduzir textos de forma instantânea para mais de cem idiomas.
Neste laboratório, você vai usar a API para traduzir textos e detectar o idioma usado.
O que você vai aprender
Neste laboratório, você vai usar a API Cloud Translation para fazer o seguinte:
- Criar uma solicitação da API Cloud Translation e chamar a API com
curl
- Traduzir texto
- Usar a edição Premium
- Detectar o idioma
Configuração e requisitos
Antes de clicar no botão Começar o Laboratório
Leia estas instruções. Os laboratórios são cronometrados e não podem ser pausados. O timer é ativado quando você clica em Iniciar laboratório e mostra por quanto tempo os recursos do Google Cloud vão ficar disponíveis.
Este laboratório prático permite que você realize as atividades em um ambiente real de nuvem, e não em uma simulação ou demonstração. Você vai receber novas credenciais temporárias para fazer login e acessar o Google Cloud durante o laboratório.
Confira os requisitos para concluir o laboratório:
- Acesso a um navegador de Internet padrão (recomendamos o Chrome).
Observação: para executar este laboratório, use o modo de navegação anônima (recomendado) ou uma janela anônima do navegador. Isso evita conflitos entre sua conta pessoal e de estudante, o que poderia causar cobranças extras na sua conta pessoal.
- Tempo para concluir o laboratório: não se esqueça que, depois de começar, não será possível pausar o laboratório.
Observação: use apenas a conta de estudante neste laboratório. Se usar outra conta do Google Cloud, você poderá receber cobranças nela.
Como iniciar seu laboratório e fazer login no console do Google Cloud
-
Clique no botão Começar laboratório. Se for preciso pagar por ele, uma caixa de diálogo vai aparecer para você selecionar a forma de pagamento.
À direita, você encontra o painel Configuração e acesso ao laboratório com as seguintes informações:
- O botão Abrir console do Google Cloud
- As credenciais temporárias (nome de usuário e senha) que você vai usar no laboratório
- Outros dados, se necessários
O timer do laboratório fica na parte de cima da página e mostra o tempo restante.
-
Se você estiver usando o navegador Chrome, clique em Abrir console do Google Cloud ou clique com o botão direito do mouse e selecione Abrir link em uma janela anônima.
O laboratório ativa os recursos e depois abre a página "Login" em outra guia.
Dica: coloque as guias em janelas separadas lado a lado.
Observação: se aparecer a caixa de diálogo Escolher uma conta, clique em Usar outra conta.
-
Se necessário, copie o Nome de usuário abaixo e cole na caixa de diálogo Login.
{{{user_0.username | "Username"}}}
Você também encontra o nome de usuário no painel Configuração e acesso ao laboratório.
-
Clique em Avançar.
-
Copie a Senha abaixo e cole na caixa de diálogo Olá!.
{{{user_0.password | "Password"}}}
Você também encontra a senha no painel Configuração e acesso ao laboratório.
-
Clique em Avançar.
Importante: você precisa usar as credenciais fornecidas no laboratório, e não as da sua conta do Google Cloud.
Observação: se você usar sua própria conta do Google Cloud neste laboratório, talvez receba cobranças adicionais.
-
Acesse as próximas páginas:
- Aceite os Termos e Condições.
- Não adicione opções de recuperação nem autenticação de dois fatores (porque essa é uma conta temporária).
- Não se inscreva em testes sem custo financeiro.
Depois de alguns instantes, o console do Google Cloud será aberto nesta guia.
Observação: para acessar os produtos e serviços do Google Cloud, clique no Menu de navegação ou digite o nome do serviço ou produto no campo Pesquisar.
Ativar o Cloud Shell
O Cloud Shell é uma máquina virtual com várias ferramentas de desenvolvimento. Ele tem um diretório principal permanente de 5 GB e é executado no Google Cloud. O Cloud Shell oferece acesso de linha de comando aos recursos do Google Cloud.
-
Clique em Ativar o Cloud Shell
na parte de cima do console do Google Cloud.
-
Clique nas seguintes janelas:
- Continue na janela de informações do Cloud Shell.
- Autorize o Cloud Shell a usar suas credenciais para fazer chamadas de APIs do Google Cloud.
Depois de se conectar, você verá que sua conta já está autenticada e que o projeto está configurado com seu Project_ID, . A saída contém uma linha que declara o projeto PROJECT_ID para esta sessão:
Your Cloud Platform project in this session is set to {{{project_0.project_id | "PROJECT_ID"}}}
A gcloud é a ferramenta de linha de comando do Google Cloud. Ela vem pré-instalada no Cloud Shell e aceita preenchimento com tabulação.
- (Opcional) É possível listar o nome da conta ativa usando este comando:
gcloud auth list
- Clique em Autorizar.
Saída:
ACTIVE: *
ACCOUNT: {{{user_0.username | "ACCOUNT"}}}
To set the active account, run:
$ gcloud config set account `ACCOUNT`
- (Opcional) É possível listar o ID do projeto usando este comando:
gcloud config list project
Saída:
[core]
project = {{{project_0.project_id | "PROJECT_ID"}}}
Observação: consulte a documentação completa da gcloud no Google Cloud no guia de visão geral da gcloud CLI.
Definir a região do projeto
Execute o seguinte comando para definir a região do seu projeto:
export REGION={{{project_0.default_region | REGION}}}
gcloud config set compute/region $REGION
Tarefa 1: criar uma chave de API
Já que você vai usar o curl para enviar uma solicitação à API Translation mais tarde neste laboratório, é preciso gerar uma chave de API para incluir o URL da solicitação.
-
Para criar uma chave de API, acesse o Menu de navegação (
) e selecione APIs e serviços > Credenciais.
-
Clique em +Criar credenciais e selecione Chave de API.
-
No painel lateral Criar chave de API que aparece, em APIs que podem ser acessadas usando esta chave, clique no menu suspenso Selecionar restrições da API.
-
Pesquise ou role a tela para encontrar a API Cloud Translation e marque a caixa.
-
Clique em OK.
-
Clique em Criar.
-
Copie a chave de API gerada e clique em Fechar.
Em seguida, salve a chave em uma variável de ambiente para não precisar inserir o valor dela em cada solicitação.
- Execute o comando abaixo no Cloud Shell. Substitua
[YOUR_API_KEY] pela chave que você acabou de copiar:
export API_KEY=[YOUR_API_KEY]
Clique em Verificar meu progresso para conferir o objetivo.
Criar uma chave de API
Tarefa 2: traduzir texto
Neste exemplo, você vai traduzir a string "My name is Steve" para espanhol.
- Transmita o texto a ser traduzido, junto com a variável de ambiente da chave de API, para a API Translation com o seguinte comando
curl:
TEXT="My%20name%20is%20Steve"
curl "https://translation.googleapis.com/language/translate/v2?target=es&key=${API_KEY}&q=${TEXT}"
Sua resposta será semelhante a esta:
{
"data": {
"translations": [
{
"translatedText": "Mi nombre es Steve",
"detectedSourceLanguage": "en"
}
]
}
}
Na resposta, é possível ver o texto traduzido e o idioma de origem que a API detectou.
Observação: modo Premium
A API Cloud Translation usa um modelo de edição padrão para a maioria das tarefas de tradução. O Google aprimorou o serviço de tradução para usar um sistema de tradução automática neural (link em inglês) mais robusto. Para saber como usar esse modelo premium, consulte a documentação do Cloud Translation.
Tarefa 3: detectar o idioma
Além da tradução, a API Translation também pode detectar o idioma do texto. Neste exemplo, você vai detectar o idioma de duas strings.
- Transmita o texto a ser analisado, junto com a variável de ambiente da chave de API, para a API Translation com o seguinte comando curl:
TEXT_ONE="Meu%20nome%20é%20Steven"
TEXT_TWO="日本のグーグルのオフィスは、東京の六本木ヒルズにあります"
curl -X POST "https://translation.googleapis.com/language/translate/v2/detect?key=${API_KEY}" -d "q=${TEXT_ONE}" -d "q=${TEXT_TWO}"
Sua resposta será semelhante a esta:
{
"data": {
"detections": [
[
{
"isReliable": false,
"language": "pt",
"confidence": 1
}
],
[
{
"language": "ja",
"isReliable": false,
"confidence": 1
}
]
]
}
}
Os idiomas retornados por esta amostra são "pt" e "ja". Estes são os identificadores ISO-639-1 (link em inglês) para português e japonês. Esta lista de idiomas aceitos pela API Translation mostra todos os códigos de idiomas que podem ser retornados.
Parabéns!
Você aprendeu a traduzir textos com a API Cloud Translation.
Comece o próximo laboratório
Próximas etapas / Saiba mais
Treinamento e certificação do Google Cloud
Esses treinamentos ajudam você a aproveitar as tecnologias do Google Cloud ao máximo. Nossas aulas incluem habilidades técnicas e práticas recomendadas para ajudar você a alcançar rapidamente o nível esperado e continuar sua jornada de aprendizado. Oferecemos treinamentos que vão do nível básico ao avançado, com opções de aulas virtuais, sob demanda e por meio de transmissões ao vivo para que você possa encaixá-las na correria do seu dia a dia. As certificações validam sua experiência e comprovam suas habilidades com as tecnologias do Google Cloud.
Manual atualizado em 8 de abril de 2026
Laboratório testado em 8 de abril de 2026
Copyright 2026 Google LLC. Todos os direitos reservados. Google e o logotipo do Google são marcas registradas da Google LLC. Todos os outros nomes de produtos e empresas podem ser marcas registradas das respectivas empresas a que estão associados.