REST Resource: projects.locations.phraseSets

リソース: PhraseSet

結果の中の特定の語句を優先するように、音声認識機能に「ヒント」を提供します。

JSON 表現 
{
  "name": string,
  "phrases": [
    {
      object (Phrase)
    }
  ],
  "boost": number,
  "kmsKeyName": string,
  "kmsKeyVersionName": string,
  "uid": string,
  "displayName": string,
  "state": enum (State),
  "deleteTime": string,
  "expireTime": string,
  "annotations": {
    string: string,
    ...
  },
  "etag": string,
  "reconciling": boolean
}
フィールド
name

string

フレーズセットのリソース名。
phrases[]

object (Phrase)

単語と語句のリスト。
boost

number

ヒント ブースト。正の値を指定すると、特定のフレーズが他の類似した発音のフレーズよりも認識される可能性が高くなります。ブーストが高いほど、誤検出の可能性も高くなります。ブースト値が負の値の場合、バイアス除去に対応します。バイアス除去が有効になっていないため、負のブーストは無視されます。boost は広範囲の正の値を許容できますが、ほとんどのユースケースでは 0（除く）～ 20 の値が最適です。ユースケースに最適な値を見つけるには、バイナリ検索アプローチを使用し、ブーストありとなしの両方のフレーズをリクエストに追加することをおすすめします。
kmsKeyName

string

出力専用。PhraseSet のコンテンツが暗号化される KMS 鍵の名前。projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key} という形式で指定してください。
kmsKeyVersionName

string

出力専用。PhraseSet のコンテンツが暗号化される KMS 鍵バージョン名。projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version} という形式で指定してください。
uid

string

出力専用。システムによって割り当てられた PhraseSet の固有識別子。このフィールドは使用されません。
displayName

string

出力専用。ユーザーが設定できる、人が読める形式の PhraseSet の名前。63 文字以下にしてください。このフィールドは使用されません。
state

enum (State)

出力専用。CustomClass のライフサイクル ステータス。このフィールドは使用されません。
deleteTime

string (Timestamp format)

出力専用。このリソースの削除がリクエストされた時刻。このフィールドは使用されません。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
expireTime

string (Timestamp format)

出力専用。このリソースがパージされる時刻。このフィールドは使用されません。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
annotations

map (key: string, value: string)

出力専用。任意の少量のデータを保存できます。キーと値はそれぞれ 63 文字以下にする必要があります。アノテーションは最大 100 個まで。このフィールドは使用されません。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }
etag

string

出力専用。このチェックサムは、他のフィールドの値に基づいてサーバーによって計算されます。これは、更新リクエスト、削除リクエスト、削除リクエストで送信され、続行する前にクライアントが最新の値を持っていることを確認できます。このフィールドは使用されません。
reconciling

boolean

出力専用。この PhraseSet が更新中かどうか。このフィールドは使用されません。

フレーズ

音声認識で認識されやすくするための単語やフレーズの「ヒント」を含むフレーズ。これは、特定の語句の精度を向上させるために使用できます。たとえば、ユーザーによって特定のコマンドがよく話されている場合が挙げられます。また、認識機能の語彙に語句を追加するためにも使用できます。詳しくは、使用制限をご覧ください。

リスト項目には、自然言語で一般的な概念を表す単語のグループを含む、事前構築済みまたはカスタムのクラスを含めることもできます。たとえば、1 年の各月に対してフレーズのヒントを提供する（「i was born in january」、「i was born in febuary」など）のではなく、組み込みの $MONTH クラスを使用すると、月を含む音声（「i was born in $month」など）を正しく文字起こしできる可能性が高まります。ビルド済みクラスを参照するには、クラスの記号の前に $ を付けます（例: $MONTH）。リクエストでインラインで定義されたカスタムクラスを参照するには、クラスの customClassId をすべてのクラスリソースとインライン クラスに固有の文字列に設定します。次に、クラスの ID を ${...} で囲んで使用します（例: "${my-months}"）。カスタムクラス リソースを参照するには、${} で囲まれたクラスの ID（例: ${my-months}）を使用します。

Speech-to-Text は、global、us（米国北米）、eu（ヨーロッパ）の 3 つのロケーションをサポートしています。speech.googleapis.com エンドポイントを呼び出す場合は、global ロケーションを使用します。リージョンを指定するには、一致する us または eu のロケーション値を持つリージョン エンドポイントを使用します。

JSON 表現 
{
  "value": string,
  "boost": number
}
フィールド
value

string

フレーズ自体。
boost

number

ヒント ブースト。フレーズセット レベルで設定されたブーストをオーバーライドします。正の値を指定すると、特定のフレーズが他の類似した発音のフレーズよりも認識される可能性が高くなります。ブーストが高いほど、誤検出の可能性も高くなります。負のブーストは無視されます。boost では広範囲の正の値を指定できますが、ほとんどのユースケースでは 0 ～ 20 の値が最適です。ユースケースに最適な値を見つけるには、バイナリ検索アプローチを使用し、ブーストありとなしの両方のフレーズをリクエストに追加することをおすすめします。

状態

CustomClass のライフサイクルを定義する状態のセット。

列挙型
STATE_UNSPECIFIED 未指定の状態。これは、未設定の値を区別するためだけに使用され、役に立ちます。
ACTIVE 通常およびアクティブな状態。
DELETED この CustomClass は削除されました。

メソッド

create

 フレーズ ヒントのセットを作成します。

delete

 フレーズセットを削除します。

get

 フレーズセットを取得します。

list

 フレーズセットを一覧表示します。

patch

 フレーズ セットを更新します。