Spécifier un point de terminaison régional

Cloud Translation – Advanced propose un point de terminaison d'API régional régional. Si vous utilisez le point de terminaison régional, vos données en transit et au repos restent dans les limites continentales de l'UE. Il est important de spécifier un point de terminaison si l'emplacement de vos données doit être contrôlé pour répondre aux exigences réglementaires locales. Le point de terminaison de l'API régionale Cloud Translation – Advanced de l'UE est translate-eu.googleapis.com.

L'utilisation du point de terminaison de l'API régionale régionale diffère de celle du point de terminaison global (translate.googleapis.com):

  • Les textes de texte utilisant des modèles AutoML personnalisés ne sont pas acceptés. Vous ne pouvez utiliser que le modèle NMT pré-entraîné.
  • Les traductions par lot ne sont pas acceptées.
  • Les fonctionnalités qui ne sont pas en disponibilité générale (toujours en Aperçu) ne sont pas compatibles, telles que la traduction de documents.
  • Les appels via le point de terminaison global ne peuvent pas accéder aux ressources créées à l'aide du point de terminaison UE, dont l'emplacement est europe-west1. De même, les appels via le point de terminaison UE ne peuvent pas accéder aux ressources créées à l'aide du point de terminaison global.

Limiter les emplacements de ressources

Les administrateurs des règles d'administration peuvent restreindre les régions disponibles pour 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 de 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 choisir une région située à l'intérieur de 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 européenne comme 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"
    }
  ]
}