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