Spécifier un point de terminaison régional

Cloud Translation Advanced propose un point de terminaison d'API régional pour l'UE. Si vous utilisez le point de terminaison régional, vos données au repos restent dans les limites géographique de l'UE. La spécification d'un point de terminaison est importante si l'emplacement de vos données doit être contrôlé afin de respecter les exigences réglementaires locales. Le point de terminaison d'API régional pour l'UE de Cloud Translation Advanced est translate-eu.googleapis.com

Le point de terminaison d'API régional pour l'UE présente certaines différences par rapport au point de terminaison mondial (translate.googleapis.com) :

  • Les traductions de texte utilisant des modèles AutoML personnalisés ne sont pas acceptées. Vous ne pouvez utiliser que le modèle NMT pré-entraîné.
  • Les traductions par lots ne sont pas compatibles.
  • Les fonctionnalités qui ne sont pas en phase de disponibilité générale (qui sont toujours en version Bêta), comme la traduction de documents, ne sont pas compatibles.
  • Les appels effectués via le point de terminaison mondial ne peuvent pas accéder aux ressources qui ont été créées à l'aide du point de terminaison pour l'UE, dont l'emplacement est europe-west1. De même, les appels effectués via le point de terminaison pour l'UE ne peuvent pas accéder aux ressources qui ont été créées à l'aide du point de terminaison mondial.

Limiter les emplacements de ressources

Les administrateurs de règles d'administration peuvent restreindre les régions disponibles pour les ressources Cloud Translation Advanced en créant une contrainte d'emplacement des ressources.

Exemple d'utilisation

L'exemple suivant montre une traduction de texte utilisant un point de terminaison régional. Si vous utilisez les bibliothèques clientes, définissez le point de terminaison de l'API dans les options du client. Pour obtenir des exemples, consultez la section Définir l'emplacement à l'aide de bibliothèques clientes dans le guide de l'API Cloud Natural Language.

API REST et ligne de commande

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • PROJECT_NUMBER_OR_ID : numéro ou ID de votre projet Google Cloud.
  • ENDPOINT : point de terminaison régional, qui détermine l'emplacement de vos données. Exemple :translate-eu.googleapis.com
  • LOCATION : région dans laquelle vous souhaitez exécuter cette opération. Vous devez sélectionner une région dans la limite continentale du point de terminaison régional. Par exemple, si vous utilisez le point de terminaison translate-eu.googleapis.com, spécifiez une région en Europe, telle que europe-west1.

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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