Struct RecognizeRequest 

#[non_exhaustive]
pub struct RecognizeRequest {
    pub recognizer: String,
    pub config: Option<RecognitionConfig>,
    pub config_mask: Option<FieldMask>,
    pub audio_source: Option<AudioSource>,
    /* private fields */
}

Request message for the Recognize method. Either content or uri must be supplied. Supplying both or neither returns [INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]. See content limits.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

recognizer: String

Required. The name of the Recognizer to use during recognition. The expected format is projects/{project}/locations/{location}/recognizers/{recognizer}. The {recognizer} segment may be set to _ to use an empty implicit Recognizer.

config: Option<RecognitionConfig>

Features and audio metadata to use for the Automatic Speech Recognition. This field in combination with the config_mask field can be used to override parts of the default_recognition_config of the Recognizer resource.

config_mask: Option<FieldMask>

The list of fields in config that override the values in the default_recognition_config of the recognizer during this recognition request. If no mask is provided, all non-default valued fields in config override the values in the recognizer for this recognition request. If a mask is provided, only the fields listed in the mask override the config in the recognizer for this recognition request. If a wildcard (*) is provided, config completely overrides and replaces the config in the recognizer for this recognition request.

audio_source: Option<AudioSource>

The audio source, which is either inline content or a Google Cloud Storage URI.

Implementations

impl RecognizeRequest

pub fn new() -> Self

Creates a new default instance.

pub fn set_recognizer<T: Into<String>>(self, v: T) -> Self

Sets the value of recognizer.

Example

let x = RecognizeRequest::new().set_recognizer(format!("projects/{project_id}/locations/{location_id}/recognizers/{recognizer_id}"));

pub fn set_config<T>(self, v: T) -> Self

where T: Into<RecognitionConfig>,

Sets the value of config.

Example

use google_cloud_speech_v2::model::RecognitionConfig;
let x = RecognizeRequest::new().set_config(RecognitionConfig::default()/* use setters */);

pub fn set_or_clear_config<T>(self, v: Option<T>) -> Self

where T: Into<RecognitionConfig>,

Sets or clears the value of config.

Example

use google_cloud_speech_v2::model::RecognitionConfig;
let x = RecognizeRequest::new().set_or_clear_config(Some(RecognitionConfig::default()/* use setters */));
let x = RecognizeRequest::new().set_or_clear_config(None::<RecognitionConfig>);

pub fn set_config_mask<T>(self, v: T) -> Self

where T: Into<FieldMask>,

Sets the value of config_mask.

Example

use wkt::FieldMask;
let x = RecognizeRequest::new().set_config_mask(FieldMask::default()/* use setters */);

pub fn set_or_clear_config_mask<T>(self, v: Option<T>) -> Self

where T: Into<FieldMask>,

Sets or clears the value of config_mask.

Example

use wkt::FieldMask;
let x = RecognizeRequest::new().set_or_clear_config_mask(Some(FieldMask::default()/* use setters */));
let x = RecognizeRequest::new().set_or_clear_config_mask(None::<FieldMask>);

pub fn set_audio_source<T: Into<Option<AudioSource>>>(self, v: T) -> Self

Sets the value of audio_source.

Note that all the setters affecting audio_source are mutually exclusive.

Example

use google_cloud_speech_v2::model::recognize_request::AudioSource;
let x = RecognizeRequest::new().set_audio_source(Some(AudioSource::Content(bytes::Bytes::from_static(b"example"))));

pub fn content(&self) -> Option<&Bytes>

The value of audio_source if it holds a Content, None if the field is not set or holds a different branch.

pub fn set_content<T: Into<Bytes>>(self, v: T) -> Self

Sets the value of audio_source to hold a Content.

Note that all the setters affecting audio_source are mutually exclusive.

Example

let x = RecognizeRequest::new().set_content(bytes::Bytes::from_static(b"example"));
assert!(x.content().is_some());
assert!(x.uri().is_none());

pub fn uri(&self) -> Option<&String>

The value of audio_source if it holds a Uri, None if the field is not set or holds a different branch.

pub fn set_uri<T: Into<String>>(self, v: T) -> Self

Sets the value of audio_source to hold a Uri.

Note that all the setters affecting audio_source are mutually exclusive.

Example

let x = RecognizeRequest::new().set_uri("example");
assert!(x.uri().is_some());
assert!(x.content().is_none());

Trait Implementations

impl Clone for RecognizeRequest

fn clone(&self) -> RecognizeRequest

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RecognizeRequest

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for RecognizeRequest

fn default() -> RecognizeRequest

Returns the “default value” for a type.

impl Message for RecognizeRequest

fn typename() -> &'static str

The typename of this message.

impl PartialEq for RecognizeRequest

fn eq(&self, other: &RecognizeRequest) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for RecognizeRequest