[Google Cloud Speech-to-Text API(V2)] Javaでコンフィグレーションを更新する

Cloud Speech-to-Text API V2(Java)を使用して、
Speech-to-Textのコンフィグレーションを更新する方法についてご紹介します。

APIを利用する環境の準備から始める場合や、コードを実行する際は、
⧉[Google Cloud Speech-to-Text API(V2)] JavaでSpeech-to-Text APIを使ってみる
を参照ください。

No		目次
1		コンフィグを更新
	1	スコープ
	2	実行
	3	レスポンスの内容

1. コンフィグを更新

Speech-to-Textのコンフィグレーションを更新します。

1.1. スコープ

OAuth2.0でこのAPIを実行するには、以下のスコープを指定してください。
サービスアカウントで実行する場合はスコープの指定は不要です。

https://www.googleapis.com/auth/cloud-platform

1.2. 実行

public static void main(String[] args) throws Exception{
    try(SpeechClient client = getSpeechClient()){
        Config.Builder config = Config.newBuilder();
        config.setName(String.format(
                    "projects/%s/locations/%s/config", 
                    "プロジェクトID","ロケーションID"));
        
        UpdateConfigRequest.Builder builder = UpdateConfigRequest.newBuilder();
        builder.setConfig(config.build());
        
        Config response = client.updateConfig(builder.build());
        System.out.println(response);
    }
}

1.2.1. HTTPリクエスト

PATCH:　https://speech.googleapis.com/v2/projects/{プロジェクトID}/locations/{ロケーションID}/config
が実行されます。

1.2.2. クエリパラメータ

UpdateConfigRequest.Builderのsetメソッドにより、クエリパラメータを追加できます。
build()メソッドでUpdateConfigRequestインスタンスを取得し、
updateConfig()に渡します。

メソッド	引数	説明
setConfig	Config	コンフィグ
setUpdateMask	FieldMask	更新するフィールド

Config(Set)

メソッド	引数	説明
setName	String	【必須】リソースの名前 形式："projects/{プロジェクトID}/locations/{ロケーションID}/config"
setKmsKeyName	String	オプションのKMSキー名 形式："projects/{プロジェクトID}/locations/{ロケーションID}/keyRings/{key_ring}/cryptoKeys/{crypto_key}

1.3. レスポンスの内容

Config

メソッド	戻り値	説明
getName	String	構成リソースの名前 形式："projects/{プロジェクトID}/locations/{ロケーションID}/config"
getKmsKeyName	String	オプションのKMSキー名 形式："projects/{プロジェクトID}/locations/{ロケーションID}/keyRings/{key_ring}/cryptoKeys/{crypto_key}
getUpdateTime	Timestamp	このリソースが最後に変更された時刻

おしまい。。