Spécifier un point de terminaison régional

Text-to-Speech propose des points de terminaison d'API régionaux aux États-Unis et dans l'UE. Si vous utilisez un point de terminaison régional, vos données au repos et en cours d'utilisation resteront dans les limites géographiques de l'Europe ou des États-Unis. 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. Il n'y a aucune modification fonctionnelle du comportement de l'API.

Utiliser des points de terminaison régionaux

Lorsque vous utilisez un point de terminaison régional, assurez-vous d'inclure l'emplacement us ou eu correspondant dans la chaîne parent. Pour en savoir plus sur la configuration du corps de la requête synthesize, consultez la documentation sur Synthesize.

Protocole

Pour effectuer une synthèse vocale à l'aide d'un point de terminaison régional, exécutez la commande applicable dans le tableau ci-dessous afin de configurer le point de terminaison approprié :

Multirégional Remplacement de point de terminaison
UE $ export CLOUD_TTS_ENDPOINT=https://eu-texttospeech.googleapis.com
États-Unis $ export CLOUD_TTS_ENDPOINT=https://us-texttospeech.googleapis.com

Seules les voix Neural2 sont disponibles à partir de ces points de terminaison :

Région unique Remplacement de point de terminaison
US Central1 $ export CLOUD_TTS_ENDPOINT=https://us-central1-texttospeech.googleapis.com

L'exemple de code suivant montre comment envoyer une requête synthesis request qui conserve toutes les données confinées dans une région spécifiée. Vous pouvez remplacer le point de terminaison régional EU ou US par la variable CLOUD_TTS_ENDPOINT. Remplacez PROJECT_ID par l'ID du projet.

$ curl   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         -H "x-goog-user-project: PROJECT_ID" \
         -H "Content-Type: application/json; charset=utf-8" \
         --data "{
          'input':{
            'text':'Android is a mobile operating system developed by Google,
             based on the Linux kernel and designed primarily for
             touchscreen mobile devices such as smartphones and tablets.'
           },
          'voice':{
            'languageCode':'en-gb',
            'name':'en-GB-Neural2-A',
            'ssmlGender':'FEMALE'
          },
        'audioConfig':{
          'audioEncoding':'MP3'
        }
      }" $CLOUD_TTS_ENDPOINT/v1/text:synthesize > synthesize-text.txt

Cet exemple crée un jeton d'accès pour votre compte Google à l'aide de Google Cloud CLI. Pour obtenir des instructions sur l'installation de la gcloud CLI, consultez S'authentifier auprès de Text-to-Speech.

Restreindre l'utilisation des points de terminaison d'API mondiaux

Pour appliquer l'utilisation de points de terminaison régionaux, utilisez la contrainte de règle d'administration constraints/gcp.restrictEndpointUsage afin de bloquer les requêtes envoyées au point de terminaison d'API mondial. Pour en savoir plus, consultez Restreindre l'utilisation des points de terminaison.