Especificar um endpoint regional

O Cloud Translation - Advanced oferece um endpoint da API regional da UE. Se você usar o endpoint regional, os dados em trânsito e em repouso permanecerão nos limites continental da UE. É importante especificar um endpoint se o local dos seus dados precisar ser controlado para obedecer aos requisitos regulamentares locais. O endpoint da API regional da API Cloud Translation - Advanced é translate-eu.googleapis.com.

Há algumas diferenças quando se usa 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 aceitas. Só é possível usar o modelo NMT pré-treinado.
  • As traduções em lote não são compatíveis.
  • Recursos que não são do GA (ainda na Visualização) não são compatíveis, como a tradução de documentos.
  • As chamadas por meio do endpoint global não podem acessar recursos criados com o endpoint da UE, que tem um local de europe-west1. Da mesma forma, as chamadas por meio do endpoint da UE não podem acessar recursos criados com 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 do Cloud Translation - Advanced 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, configure o endpoint da API como parte das opções do cliente. Para alguns exemplos, consulte Como definir 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 as substituições a seguir:

  • PROJECT_NUMBER_OR_ID: o número ou ID do projeto do Google Cloud
  • ENDPOINT: endpoint regional, que determina onde seus dados estão. Por exemplo, translate-eu.googleapis.com.
  • LOCATION: região em que você quer executar essa operação. É preciso escolher 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"
    }
  ]
}