リージョン エンドポイントを指定する

Text-to-Speech には、米国と EU のリージョン API エンドポイントが用意されています。リージョン エンドポイントを使用する場合、保存データと使用中のデータは、ヨーロッパまたは米国の大陸境界内にとどまります。現地の規制要件に合わせてデータのロケーションを制御する必要がある場合は、エンドポイントの指定が重要となります。API の動作に対する機能面の変更はありません。

リージョン エンドポイントを使用する場合は、一致する us または eu のロケーションを parent 文字列に含める必要があります。合成リクエストの本文の構成については、Synthesize のドキュメントをご覧ください。

プロトコル

リージョン エンドポイントを使用してテキスト読み上げ合成を実行するには、次の表の該当するコマンドを実行して、適切なエンドポイントを構成します。

マルチリージョン	エンドポイントのオーバーライド
EU	$ export CLOUD_TTS_ENDPOINT=https://eu-texttospeech.googleapis.com
米国	$ export CLOUD_TTS_ENDPOINT=https://us-texttospeech.googleapis.com

Neural2 音声を使用できるのは、以下のエンドポイントに限られます。

シングル リージョン	エンドポイントのオーバーライド
US Central1	$ export CLOUD_TTS_ENDPOINT=https://us-central1-texttospeech.googleapis.com

次のコードサンプルは、すべてのデータを特定のリージョンに制限する synthesis request を送信する方法を示しています。CLOUD_TTS_ENDPOINT 変数は、EU または US リージョン エンドポイントで置き換えることができます。PROJECT_ID は、実際のプロジェクト ID に置き換えます。

$ 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

この例では、Google Cloud CLI を使用して、Google アカウントのアクセス トークンを作成します。gcloud CLI のインストール手順については、Text-to-Speech に対する認証を行うをご覧ください。