Specifica di un endpoint a livello di regione

Text-to-Speech offre endpoint API regionali per Stati Uniti ed Europa. Se utilizzi un endpoint regionale, i dati non attivi e in uso rimarranno all'interno dei confini continentali dell'Europa o degli Stati Uniti. La specifica di un endpoint è importante se la posizione dei dati deve essere controllata per rispettare i requisiti normativi locali. Non sono state apportate modifiche funzionali al comportamento dell'API.

Utilizzare endpoint regionali

Quando utilizzi un endpoint regionale, assicurati di includere la località us o eu corrispondente nella stringa parent. Per saperne di più sulla configurazione del corpo della richiesta di sintesi, consulta la documentazione Synthesize.

Protocollo

Per eseguire la sintesi vocale utilizzando un endpoint regionale, esegui il comando applicabile nella tabella seguente per configurare l'endpoint corretto:

Più regioni Override dell'endpoint
UE $ export CLOUD_TTS_ENDPOINT=https://eu-texttospeech.googleapis.com
US $ export CLOUD_TTS_ENDPOINT=https://us-texttospeech.googleapis.com

Solo le voci Neural2 sono disponibili da questi endpoint:

Area geografica singola Override dell'endpoint
US Central1 $ export CLOUD_TTS_ENDPOINT=https://us-central1-texttospeech.googleapis.com

Il seguente esempio di codice mostra come inviare una synthesis request che mantiene tutti i dati confinati in una regione specificata. Puoi sostituire l'endpoint regionale EU o US con la variabile CLOUD_TTS_ENDPOINT. Sostituisci PROJECT_ID con l'ID progetto.

$ 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

Questo esempio utilizza Google Cloud CLI per creare un token di accesso per il tuo Account Google. Per istruzioni sull'installazione di gcloud CLI, vedi Autenticarsi in Text-to-Speech.

Limita l'utilizzo degli endpoint API globali

Per contribuire a imporre l'utilizzo di endpoint regionali, utilizza il vincolo delle policy dell'organizzazione constraints/gcp.restrictEndpointUsage per bloccare le richieste all'endpoint API globale. Per saperne di più, consulta la pagina Limitare l'utilizzo degli endpoint.