Especificar um endpoint regional

A edição Advanced do Cloud Translation oferece um endpoint regional da API na UE. Se você usar o endpoint regional, seus dados em trânsito e em repouso ficarão dentro dos limites continentais da UE. É importante especificar um endpoint se a localização dos dados precisa ser controlada para obedecer aos requisitos regulamentares locais. O endpoint da API regional da edição Advanced do Cloud Translation para a União Europeia é translate-eu.googleapis.com

Há algumas diferenças ao usar o endpoint da API regional da UE em comparação com o uso do endpoint global (translate.googleapis.com):

  • As traduções de texto que usam modelos personalizados do AutoML não são compatíveis. É possível usar apenas o modelo NMT pré-treinado.
  • Traduções em lote não são aceitas.
  • Recursos que não estão em disponibilidade geral (ainda na visualização) não são compatíveis, como a Document Translation.
  • As chamadas feitas com o endpoint global não podem acessar recursos criados usando o endpoint da UE, que tem um local europe-west1. Da mesma forma, as chamadas feitas pelo endpoint da UE não podem acessar os recursos que foram criados usando o endpoint global.

Como restringir locais dos recursos

Os administradores de políticas da organização podem restringir as regiões disponíveis para os recursos da edição Advanced do Cloud Translation criando uma restrição de locais de recursos.

Exemplo de uso

O exemplo a seguir mostra uma tradução de texto que usa um endpoint regional. Se você usar as bibliotecas de cliente, defina o endpoint da API como parte das opções do cliente. Para alguns exemplos, consulte Como configurar o local usando bibliotecas de cliente no guia da API Cloud Natural Language.

REST e LINHA DE CMD

Antes de usar os dados da solicitação abaixo, faça estas substituições:

  • PROJECT_NUMBER_OR_ID: pelo número ou ID do seu projeto do Google Cloud
  • ENDPOINT: endpoint regional, que determina onde seus dados residem. Por exemplo, translate-eu.googleapis.com.
  • LOCATION: região em que você quer executar a operação. Escolha uma região dentro do limite continental do endpoint regional. Por exemplo, se você usar o endpoint translate-eu.googleapis.com, especifique uma região na Europa, como europe-west1.

Método HTTP e URL:

POST https://ENDPOINT/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:translateText

Corpo JSON da solicitação:

{
  "model": "projects/PROJECT_NUMBER_OR_ID/locations/LOCATION/models/general/base",
  "sourceLanguageCode": "en",
  "targetLanguageCode": "de",
  "contents": ["Come here!"]
}

Para enviar a solicitação, escolha uma destas opções:

curl

Salve o corpo da solicitação em um arquivo chamado request.json e execute o comando a seguir:

curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://ENDPOINT/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:translateText "

PowerShell

Salve o corpo da solicitação em um arquivo chamado request.json e execute o comando a seguir:

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://ENDPOINT/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:translateText " | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "translations": [
    {
      "translatedText": "Komm her!",
      "model": "projects/PROJECT_NUMBER_OR_ID/locations/LOCATION/models/general/base"
    }
  ]
}