{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/google-cloud-speech-to-text/json-schema/google-cloud-speech-to-text-list-phrase-set-response-schema.json",
  "title": "ListPhraseSetResponse",
  "description": "Message returned to the client by the `ListPhraseSet` method.",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/google-cloud-speech-to-text-projects-api-openapi.yml#/components/schemas/ListPhraseSetResponse",
  "properties": {
    "phraseSets": {
      "description": "The phrase set.",
      "items": {
        "$ref": "#/$defs/PhraseSet"
      },
      "type": "array"
    },
    "nextPageToken": {
      "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.",
      "type": "string"
    }
  },
  "type": "object",
  "$defs": {
    "Phrase": {
      "type": "object",
      "properties": {
        "boost": {
          "description": "Hint Boost. Overrides the boost set at the phrase set level. Positive value will increase the probability that a specific phrase will be recognized over other similar sounding phrases. The higher the boost, the higher the chance of false positive recognition as well. Negative boost will simply be ignored. Though `boost` can accept a wide range of positive values, most use cases are best served with values between 0 and 20. We recommend using a binary search approach to finding the optimal value for your use case as well as adding phrases both with and without boost to your requests.",
          "type": "number",
          "format": "float"
        },
        "value": {
          "type": "string",
          "description": "The phrase itself."
        }
      },
      "description": "A phrases containing words and phrase \"hints\" so that the speech recognition is more likely to recognize them. This can be used to improve the accuracy for specific words and phrases, for example, if specific commands are typically spoken by the user. This can also be used to add additional words to the vocabulary of the recognizer. See [usage limits](https://cloud.google.com/speech-to-text/quotas#content). List items can also include pre-built or custom classes containing groups of words that represent common concepts that occur in natural language. For example, rather than providing a phrase hint for every month of the year (e.g. \"i was born in january\", \"i was born in febuary\", ...), use the pre-built `$MONTH` class improves the likelihood of correctly transcribing audio that includes months (e.g. \"i was born in $month\"). To refer to pre-built classes, use the class' symbol prepended with `$` e.g. `$MONTH`. To refer to custom classes that were defined inline in the request, set the class's `custom_class_id` to a string unique to all class resources and inline classes. Then use the class' id wrapped in $`{...}` e.g. \"${my-months}\". To refer to custom classes resources, use the class' id wrapped in `${}` (e.g. `${my-months}`). Speech-to-Text supports three locations: `global`, `us` (US North America), and `eu` (Europe). If you are calling the `speech.googleapis.com` endpoint, use the `global` location. To specify a region, use a [regional endpoint](https://cloud.google.com/speech-to-text/docs/endpoints) with matching `us` or `eu` location value."
    },
    "PhraseSet": {
      "description": "Provides \"hints\" to the speech recognizer to favor specific words and phrases in the results.",
      "properties": {
        "annotations": {
          "description": "Output only. Allows users to store small amounts of arbitrary data. Both the key and the value must be 63 characters or less each. At most 100 annotations. This field is not used.",
          "additionalProperties": {
            "type": "string"
          },
          "readOnly": true,
          "type": "object"
        },
        "kmsKeyVersionName": {
          "type": "string",
          "description": "Output only. The [KMS key version name](https://cloud.google.com/kms/docs/resource-hierarchy#key_versions) with which content of the PhraseSet is encrypted. The expected format is `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}`.",
          "readOnly": true
        },
        "expireTime": {
          "readOnly": true,
          "description": "Output only. The time at which this resource will be purged. This field is not used.",
          "format": "google-datetime",
          "type": "string"
        },
        "kmsKeyName": {
          "readOnly": true,
          "description": "Output only. The [KMS key name](https://cloud.google.com/kms/docs/resource-hierarchy#keys) with which the content of the PhraseSet is encrypted. The expected format is `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`.",
          "type": "string"
        },
        "displayName": {
          "type": "string",
          "readOnly": true,
          "description": "Output only. User-settable, human-readable name for the PhraseSet. Must be 63 characters or less. This field is not used."
        },
        "state": {
          "description": "Output only. The CustomClass lifecycle state. This field is not used.",
          "enum": [
            "STATE_UNSPECIFIED",
            "ACTIVE",
            "DELETED"
          ],
          "readOnly": true,
          "type": "string"
        },
        "name": {
          "description": "The resource name of the phrase set.",
          "type": "string"
        },
        "uid": {
          "type": "string",
          "readOnly": true,
          "description": "Output only. System-assigned unique identifier for the PhraseSet. This field is not used."
        },
        "boost": {
          "description": "Hint Boost. Positive value will increase the probability that a specific phrase will be recognized over other similar sounding phrases. The higher the boost, the higher the chance of false positive recognition as well. Negative boost values would correspond to anti-biasing. Anti-biasing is not enabled, so negative boost will simply be ignored. Though `boost` can accept a wide range of positive values, most use cases are best served with values between 0 (exclusive) and 20. We recommend using a binary search approach to finding the optimal value for your use case as well as adding phrases both with and without boost to your requests.",
          "format": "float",
          "type": "number"
        },
        "etag": {
          "type": "string",
          "description": "Output only. This checksum is computed by the server based on the value of other fields. This may be sent on update, undelete, and delete requests to ensure the client has an up-to-date value before proceeding. This field is not used.",
          "readOnly": true
        },
        "reconciling": {
          "description": "Output only. Whether or not this PhraseSet is in the process of being updated. This field is not used.",
          "readOnly": true,
          "type": "boolean"
        },
        "phrases": {
          "items": {
            "$ref": "#/$defs/Phrase"
          },
          "description": "A list of word and phrases.",
          "type": "array"
        },
        "deleteTime": {
          "format": "google-datetime",
          "type": "string",
          "description": "Output only. The time at which this resource was requested for deletion. This field is not used.",
          "readOnly": true
        }
      },
      "type": "object"
    }
  }
}