Guia de início rápido

Nesta página, mostramos como fazer uma solicitação à Cloud Translation API com curl.

Antes de começar

  1. Faça login na sua Conta do Google.

    Se você ainda não tiver uma, inscreva-se.

  2. Configurar um projeto do Console do GCP.

    Configurar um projeto

    Clique para:

    • criar ou selecionar um projeto;
    • ativar a(s) Cloud Translation API necessária(s) para o projeto.
    • criar uma conta de serviço;
    • fazer o download de uma chave privada como JSON.

    É possível ver e gerenciar esses recursos a qualquer momento no Console do GCP.

  3. Defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS para o caminho do arquivo JSON que contém a chave da sua conta de serviço. Essa variável só se aplica à sessão de shell atual. Dessa maneira, se você abrir uma nova sessão, defina a variável novamente.

  4. Instale e inicialize o SDK do Cloud..

Fazer uma solicitação à API Translation

Faça uma solicitação à Translation API usando uma chamada de método REST para o método de tradução v2.

  1. Use curl para fazer uma solicitação para o ponto de extremidade https://translation.googleapis.com/language/translate/v2.

    O comando curl inclui JSON com o texto a ser traduzido (q), o idioma de origem (source) e o idioma de chegada (target).

    Os idiomas de origem e de chegada são identificados com os códigos iso-639-1. No exemplo, o idioma de origem é o inglês (en) e o idioma de chegada é o espanhol (es). O formato da consulta é referido como “text” para texto simples.

    No exemplo de comando curl, usamos o comando gcloud auth application-default print-access-token para receber um token de autenticação.

    curl -s -X POST -H "Content-Type: application/json" \
        -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
        --data "{
      'q': 'The Great Pyramid of Giza (also known as the Pyramid of Khufu or the
            Pyramid of Cheops) is the oldest and largest of the three pyramids in
            the Giza pyramid complex.',
      'source': 'en',
      'target': 'es',
      'format': 'text'
    }" "https://translation.googleapis.com/language/translate/v2"
      

    Uma resposta semelhante a esta será exibida:

    {
      "data": {
        "translations": [
          {
            "translatedText": "La Gran Pirámide de Giza (también conocida como la
             Pirámide de Khufu o la Pirámide de Keops) es la más antigua y más
             grande de las tres pirámides en el complejo de la pirámide de Giza."
          }
        ]
      }
    }
    
      

Parabéns! Você enviou sua primeira solicitação para a Cloud Translation API!

Limpar

Para evitar cobranças desnecessárias do Google Cloud Platform, use o Console do GCP para excluir seu projeto se ele não for necessário.

A seguir