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, o processamento de dados em repouso e de machine learning permanecerão nos 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.
• Não é possível traduzir documentos formatados.
• Os recursos que não estão no GA (ainda na Visualização) não são compatíveis.
• 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

Observação: verifique se você definiu a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS como o caminho do arquivo da chave privada da conta de serviço.

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

Observação: verifique se você definiu a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS como o caminho do arquivo da chave privada da conta de serviço.

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"
    }
  ]
}