---
title: Getting Started with Datadog
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > Infrastructure > Datadog Resource Catalog
---

# gcp_speech_recognizer{% #gcp_speech_recognizer %}

## `ancestors`{% #ancestors %}

**Type**: `UNORDERED_LIST_STRING`

## `annotations`{% #annotations %}

**Type**: `MAP_STRING_STRING`**Provider name**: `annotations`**Description**: 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.

## `create_time`{% #create_time %}

**Type**: `TIMESTAMP`**Provider name**: `createTime`**Description**: Output only. Creation time.

## `default_recognition_config`{% #default_recognition_config %}

**Type**: `STRUCT`**Provider name**: `defaultRecognitionConfig`**Description**: Default configuration to use for requests with this Recognizer. This can be overwritten by inline configuration in the RecognizeRequest.config field.

- `adaptation`**Type**: `STRUCT`**Provider name**: `adaptation`**Description**: Speech adaptation context that weights recognizer predictions for specific words and phrases.

  - `custom_classes`**Type**: `UNORDERED_LIST_STRUCT`**Provider name**: `customClasses`**Description**: A list of inline CustomClasses. Existing CustomClass resources can be referenced directly in a PhraseSet.
    - `annotations`**Type**: `MAP_STRING_STRING`**Provider name**: `annotations`**Description**: Optional. 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.
    - `create_time`**Type**: `TIMESTAMP`**Provider name**: `createTime`**Description**: Output only. Creation time.
    - `delete_time`**Type**: `TIMESTAMP`**Provider name**: `deleteTime`**Description**: Output only. The time at which this resource was requested for deletion.
    - `etag`**Type**: `STRING`**Provider name**: `etag`**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.
    - `expire_time`**Type**: `TIMESTAMP`**Provider name**: `expireTime`**Description**: Output only. The time at which this resource will be purged.
    - `gcp_display_name`**Type**: `STRING`**Provider name**: `displayName`**Description**: Optional. User-settable, human-readable name for the CustomClass. Must be 63 characters or less.
    - `items`**Type**: `UNORDERED_LIST_STRUCT`**Provider name**: `items`**Description**: A collection of class items.
      - `value`**Type**: `STRING`**Provider name**: `value`**Description**: The class item's value.
    - `kms_key_name`**Type**: `STRING`**Provider name**: `kmsKeyName`**Description**: Output only. The [KMS key name](https://cloud.google.com/kms/docs/resource-hierarchy#keys) with which the CustomClass is encrypted. The expected format is `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`.
    - `kms_key_version_name`**Type**: `STRING`**Provider name**: `kmsKeyVersionName`**Description**: Output only. The [KMS key version name](https://cloud.google.com/kms/docs/resource-hierarchy#key_versions) with which the CustomClass is encrypted. The expected format is `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}`.
    - `name`**Type**: `STRING`**Provider name**: `name`**Description**: Output only. Identifier. The resource name of the CustomClass. Format: `projects/{project}/locations/{location}/customClasses/{custom_class}`.
    - `reconciling`**Type**: `BOOLEAN`**Provider name**: `reconciling`**Description**: Output only. Whether or not this CustomClass is in the process of being updated.
    - `state`**Type**: `STRING`**Provider name**: `state`**Description**: Output only. The CustomClass lifecycle state.**Possible values**:
      - `STATE_UNSPECIFIED` - Unspecified state. This is only used/useful for distinguishing unset values.
      - `ACTIVE` - The normal and active state.
      - `DELETED` - This CustomClass has been deleted.
    - `uid`**Type**: `STRING`**Provider name**: `uid`**Description**: Output only. System-assigned unique identifier for the CustomClass.
    - `update_time`**Type**: `TIMESTAMP`**Provider name**: `updateTime`**Description**: Output only. The most recent time this resource was modified.
  - `phrase_sets`**Type**: `UNORDERED_LIST_STRUCT`**Provider name**: `phraseSets`**Description**: A list of inline or referenced PhraseSets.
    - `inline_phrase_set`**Type**: `STRUCT`**Provider name**: `inlinePhraseSet`**Description**: An inline defined PhraseSet.
      - `annotations`**Type**: `MAP_STRING_STRING`**Provider name**: `annotations`**Description**: 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.
      - `boost`**Type**: `FLOAT`**Provider name**: `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. Valid `boost` values are 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.
      - `create_time`**Type**: `TIMESTAMP`**Provider name**: `createTime`**Description**: Output only. Creation time.
      - `delete_time`**Type**: `TIMESTAMP`**Provider name**: `deleteTime`**Description**: Output only. The time at which this resource was requested for deletion.
      - `etag`**Type**: `STRING`**Provider name**: `etag`**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.
      - `expire_time`**Type**: `TIMESTAMP`**Provider name**: `expireTime`**Description**: Output only. The time at which this resource will be purged.
      - `gcp_display_name`**Type**: `STRING`**Provider name**: `displayName`**Description**: User-settable, human-readable name for the PhraseSet. Must be 63 characters or less.
      - `kms_key_name`**Type**: `STRING`**Provider name**: `kmsKeyName`**Description**: Output only. The [KMS key name](https://cloud.google.com/kms/docs/resource-hierarchy#keys) with which the PhraseSet is encrypted. The expected format is `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`.
      - `kms_key_version_name`**Type**: `STRING`**Provider name**: `kmsKeyVersionName`**Description**: Output only. The [KMS key version name](https://cloud.google.com/kms/docs/resource-hierarchy#key_versions) with which the PhraseSet is encrypted. The expected format is `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}`.
      - `name`**Type**: `STRING`**Provider name**: `name`**Description**: Output only. Identifier. The resource name of the PhraseSet. Format: `projects/{project}/locations/{location}/phraseSets/{phrase_set}`.
      - `phrases`**Type**: `UNORDERED_LIST_STRUCT`**Provider name**: `phrases`**Description**: A list of word and phrases.
        - `boost`**Type**: `FLOAT`**Provider name**: `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 values would correspond to anti-biasing. Anti-biasing is not enabled, so negative boost values will return an error. Boost values must be between 0 and 20. Any values outside that range will return an error. 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.
        - `value`**Type**: `STRING`**Provider name**: `value`**Description**: The phrase itself.
      - `reconciling`**Type**: `BOOLEAN`**Provider name**: `reconciling`**Description**: Output only. Whether or not this PhraseSet is in the process of being updated.
      - `state`**Type**: `STRING`**Provider name**: `state`**Description**: Output only. The PhraseSet lifecycle state.**Possible values**:
        - `STATE_UNSPECIFIED` - Unspecified state. This is only used/useful for distinguishing unset values.
        - `ACTIVE` - The normal and active state.
        - `DELETED` - This PhraseSet has been deleted.
      - `uid`**Type**: `STRING`**Provider name**: `uid`**Description**: Output only. System-assigned unique identifier for the PhraseSet.
      - `update_time`**Type**: `TIMESTAMP`**Provider name**: `updateTime`**Description**: Output only. The most recent time this resource was modified.
    - `phrase_set`**Type**: `STRING`**Provider name**: `phraseSet`**Description**: The name of an existing PhraseSet resource. The user must have read access to the resource and it must not be deleted.

- `auto_decoding_config`**Type**: `STRUCT`**Provider name**: `autoDecodingConfig`**Description**: Automatically detect decoding parameters. Preferred for supported formats.

- `denoiser_config`**Type**: `STRUCT`**Provider name**: `denoiserConfig`**Description**: Optional. Optional denoiser config. May not be supported for all models and may have no effect.

  - `denoise_audio`**Type**: `BOOLEAN`**Provider name**: `denoiseAudio`**Description**: Denoise audio before sending to the transcription model.
  - `snr_threshold`**Type**: `FLOAT`**Provider name**: `snrThreshold`**Description**: Signal-to-Noise Ratio (SNR) threshold for the denoiser. Here SNR means the loudness of the speech signal. Audio with an SNR below this threshold, meaning the speech is too quiet, will be prevented from being sent to the transcription model. If snr_threshold=0, no filtering will be applied.

- `explicit_decoding_config`**Type**: `STRUCT`**Provider name**: `explicitDecodingConfig`**Description**: Explicitly specified decoding parameters. Required if using headerless PCM audio (linear16, mulaw, alaw).

  - `audio_channel_count`**Type**: `INT32`**Provider name**: `audioChannelCount`**Description**: Optional. Number of channels present in the audio data sent for recognition. Note that this field is marked as OPTIONAL for backward compatibility reasons. It is (and has always been) effectively REQUIRED. The maximum allowed value is 8.
  - `encoding`**Type**: `STRING`**Provider name**: `encoding`**Description**: Required. Encoding of the audio data sent for recognition.**Possible values**:
    - `AUDIO_ENCODING_UNSPECIFIED` - Default value. This value is unused.
    - `LINEAR16` - Headerless 16-bit signed little-endian PCM samples.
    - `MULAW` - Headerless 8-bit companded mulaw samples.
    - `ALAW` - Headerless 8-bit companded alaw samples.
    - `AMR` - AMR frames with an rfc4867.5 header.
    - `AMR_WB` - AMR-WB frames with an rfc4867.5 header.
    - `FLAC` - FLAC frames in the 'native FLAC' container format.
    - `MP3` - MPEG audio frames with optional (ignored) ID3 metadata.
    - `OGG_OPUS` - Opus audio frames in an Ogg container.
    - `WEBM_OPUS` - Opus audio frames in a WebM container.
    - `MP4_AAC` - AAC audio frames in an MP4 container.
    - `M4A_AAC` - AAC audio frames in an M4A container.
    - `MOV_AAC` - AAC audio frames in an MOV container.
  - `sample_rate_hertz`**Type**: `INT32`**Provider name**: `sampleRateHertz`**Description**: Optional. Sample rate in Hertz of the audio data sent for recognition. Valid values are: 8000-48000, and 16000 is optimal. For best results, set the sampling rate of the audio source to 16000 Hz. If that's not possible, use the native sample rate of the audio source (instead of resampling). Note that this field is marked as OPTIONAL for backward compatibility reasons. It is (and has always been) effectively REQUIRED.

- `features`**Type**: `STRUCT`**Provider name**: `features`**Description**: Speech recognition features to enable.

  - `diarization_config`**Type**: `STRUCT`**Provider name**: `diarizationConfig`**Description**: Configuration to enable speaker diarization. To enable diarization, set this field to an empty SpeakerDiarizationConfig message.
    - `max_speaker_count`**Type**: `INT32`**Provider name**: `maxSpeakerCount`**Description**: Optional. The system automatically determines the number of speakers. This value is not currently used.
    - `min_speaker_count`**Type**: `INT32`**Provider name**: `minSpeakerCount`**Description**: Optional. The system automatically determines the number of speakers. This value is not currently used.
  - `enable_automatic_punctuation`**Type**: `BOOLEAN`**Provider name**: `enableAutomaticPunctuation`**Description**: If `true`, adds punctuation to recognition result hypotheses. This feature is only available in select languages. The default `false` value does not add punctuation to result hypotheses.
  - `enable_spoken_emojis`**Type**: `BOOLEAN`**Provider name**: `enableSpokenEmojis`**Description**: The spoken emoji behavior for the call. If `true`, adds spoken emoji formatting for the request. This will replace spoken emojis with the corresponding Unicode symbols in the final transcript. If `false`, spoken emojis are not replaced.
  - `enable_spoken_punctuation`**Type**: `BOOLEAN`**Provider name**: `enableSpokenPunctuation`**Description**: The spoken punctuation behavior for the call. If `true`, replaces spoken punctuation with the corresponding symbols in the request. For example, "how are you question mark" becomes "how are you?". See [https://cloud.google.com/speech-to-text/docs/spoken-punctuation](https://cloud.google.com/speech-to-text/docs/spoken-punctuation) for support. If `false`, spoken punctuation is not replaced.
  - `enable_word_confidence`**Type**: `BOOLEAN`**Provider name**: `enableWordConfidence`**Description**: If `true`, the top result includes a list of words and the confidence for those words. If `false`, no word-level confidence information is returned. The default is `false`.
  - `enable_word_time_offsets`**Type**: `BOOLEAN`**Provider name**: `enableWordTimeOffsets`**Description**: If `true`, the top result includes a list of words and the start and end time offsets (timestamps) for those words. If `false`, no word-level time offset information is returned. The default is `false`.
  - `max_alternatives`**Type**: `INT32`**Provider name**: `maxAlternatives`**Description**: Maximum number of recognition hypotheses to be returned. The server may return fewer than `max_alternatives`. Valid values are `0`-`30`. A value of `0` or `1` will return a maximum of one. If omitted, will return a maximum of one.
  - `multi_channel_mode`**Type**: `STRING`**Provider name**: `multiChannelMode`**Description**: Mode for recognizing multi-channel audio.**Possible values**:
    - `MULTI_CHANNEL_MODE_UNSPECIFIED` - Default value for the multi-channel mode. If the audio contains multiple channels, only the first channel will be transcribed; other channels will be ignored.
    - `SEPARATE_RECOGNITION_PER_CHANNEL` - If selected, each channel in the provided audio is transcribed independently. This cannot be selected if the selected model is `latest_short`.
  - `profanity_filter`**Type**: `BOOLEAN`**Provider name**: `profanityFilter`**Description**: If set to `true`, the server will attempt to filter out profanities, replacing all but the initial character in each filtered word with asterisks, for instance, "f***". If set to `false` or omitted, profanities won't be filtered out.

- `language_codes`**Type**: `UNORDERED_LIST_STRING`**Provider name**: `languageCodes`**Description**: Optional. The language of the supplied audio as a [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. Language tags are normalized to BCP-47 before they are used eg "en-us" becomes "en-US". Supported languages for each model are listed in the [Table of Supported Models](https://cloud.google.com/speech-to-text/v2/docs/speech-to-text-supported-languages). If additional languages are provided, recognition result will contain recognition in the most likely language detected. The recognition result will include the language tag of the language detected in the audio.

- `model`**Type**: `STRING`**Provider name**: `model`**Description**: Optional. Which model to use for recognition requests. Select the model best suited to your domain to get best results. Guidance for choosing which model to use can be found in the [Transcription Models Documentation](https://cloud.google.com/speech-to-text/v2/docs/transcription-model) and the models supported in each region can be found in the [Table Of Supported Models](https://cloud.google.com/speech-to-text/v2/docs/speech-to-text-supported-languages).

- `transcript_normalization`**Type**: `STRUCT`**Provider name**: `transcriptNormalization`**Description**: Optional. Use transcription normalization to automatically replace parts of the transcript with phrases of your choosing. For StreamingRecognize, this normalization only applies to stable partial transcripts (stability > 0.8) and final transcripts.

  - `entries`**Type**: `UNORDERED_LIST_STRUCT`**Provider name**: `entries`**Description**: A list of replacement entries. We will perform replacement with one entry at a time. For example, the second entry in ["cat" => "dog", "mountain cat" => "mountain dog"] will never be applied because we will always process the first entry before it. At most 100 entries.
    - `case_sensitive`**Type**: `BOOLEAN`**Provider name**: `caseSensitive`**Description**: Whether the search is case sensitive.
    - `replace`**Type**: `STRING`**Provider name**: `replace`**Description**: What to replace with. Max length is 100 characters.
    - `search`**Type**: `STRING`**Provider name**: `search`**Description**: What to replace. Max length is 100 characters.

- `translation_config`**Type**: `STRUCT`**Provider name**: `translationConfig`**Description**: Optional. Optional configuration used to automatically run translation on the given audio to the desired language for supported models.

  - `target_language`**Type**: `STRING`**Provider name**: `targetLanguage`**Description**: Required. The language code to translate to.

## `delete_time`{% #delete_time %}

**Type**: `TIMESTAMP`**Provider name**: `deleteTime`**Description**: Output only. The time at which this Recognizer was requested for deletion.

## `etag`{% #etag %}

**Type**: `STRING`**Provider name**: `etag`**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.

## `expire_time`{% #expire_time %}

**Type**: `TIMESTAMP`**Provider name**: `expireTime`**Description**: Output only. The time at which this Recognizer will be purged.

## `gcp_display_name`{% #gcp_display_name %}

**Type**: `STRING`**Provider name**: `displayName`**Description**: User-settable, human-readable name for the Recognizer. Must be 63 characters or less.

## `kms_key_name`{% #kms_key_name %}

**Type**: `STRING`**Provider name**: `kmsKeyName`**Description**: Output only. The [KMS key name](https://cloud.google.com/kms/docs/resource-hierarchy#keys) with which the Recognizer is encrypted. The expected format is `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`.

## `kms_key_version_name`{% #kms_key_version_name %}

**Type**: `STRING`**Provider name**: `kmsKeyVersionName`**Description**: Output only. The [KMS key version name](https://cloud.google.com/kms/docs/resource-hierarchy#key_versions) with which the Recognizer is encrypted. The expected format is `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}`.

## `labels`{% #labels %}

**Type**: `UNORDERED_LIST_STRING`

## `language_codes`{% #language_codes %}

**Type**: `UNORDERED_LIST_STRING`**Provider name**: `languageCodes`**Description**: Optional. This field is now deprecated. Prefer the `language_codes` field in the `RecognitionConfig` message. The language of the supplied audio as a [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. Supported languages for each model are listed in the [Table of Supported Models](https://cloud.google.com/speech-to-text/v2/docs/speech-to-text-supported-languages). If additional languages are provided, recognition result will contain recognition in the most likely language detected. The recognition result will include the language tag of the language detected in the audio. When you create or update a Recognizer, these values are stored in normalized BCP-47 form. For example, "en-us" is stored as "en-US".

## `model`{% #model %}

**Type**: `STRING`**Provider name**: `model`**Description**: Optional. This field is now deprecated. Prefer the `model` field in the `RecognitionConfig` message. Which model to use for recognition requests. Select the model best suited to your domain to get best results. Guidance for choosing which model to use can be found in the [Transcription Models Documentation](https://cloud.google.com/speech-to-text/v2/docs/transcription-model) and the models supported in each region can be found in the [Table Of Supported Models](https://cloud.google.com/speech-to-text/v2/docs/speech-to-text-supported-languages).

## `name`{% #name %}

**Type**: `STRING`**Provider name**: `name`**Description**: Output only. Identifier. The resource name of the Recognizer. Format: `projects/{project}/locations/{location}/recognizers/{recognizer}`.

## `organization_id`{% #organization_id %}

**Type**: `STRING`

## `parent`{% #parent %}

**Type**: `STRING`

## `project_id`{% #project_id %}

**Type**: `STRING`

## `project_number`{% #project_number %}

**Type**: `STRING`

## `reconciling`{% #reconciling %}

**Type**: `BOOLEAN`**Provider name**: `reconciling`**Description**: Output only. Whether or not this Recognizer is in the process of being updated.

## `region_id`{% #region_id %}

**Type**: `STRING`

## `resource_name`{% #resource_name %}

**Type**: `STRING`

## `state`{% #state %}

**Type**: `STRING`**Provider name**: `state`**Description**: Output only. The Recognizer lifecycle state.**Possible values**:

- `STATE_UNSPECIFIED` - The default value. This value is used if the state is omitted.
- `ACTIVE` - The Recognizer is active and ready for use.
- `DELETED` - This Recognizer has been deleted.

## `tags`{% #tags %}

**Type**: `UNORDERED_LIST_STRING`

## `uid`{% #uid %}

**Type**: `STRING`**Provider name**: `uid`**Description**: Output only. System-assigned unique identifier for the Recognizer.

## `update_time`{% #update_time %}

**Type**: `TIMESTAMP`**Provider name**: `updateTime`**Description**: Output only. The most recent time this Recognizer was modified.

## `zone_id`{% #zone_id %}

**Type**: `STRING`