google_cloudevents/google/events/cloud/speech/v1/mod.rs
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316
// This file is @generated by prost-build.
/// A set of words or phrases that represents a common concept likely to appear
/// in your audio, for example a list of passenger ship names. CustomClass items
/// can be substituted into placeholders that you set in PhraseSet phrases.
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct CustomClass {
/// The resource name of the custom class.
#[prost(string, tag = "1")]
pub name: ::prost::alloc::string::String,
/// If this custom class is a resource, the custom_class_id is the resource id
/// of the CustomClass. Case sensitive.
#[prost(string, tag = "2")]
pub custom_class_id: ::prost::alloc::string::String,
/// A collection of class items.
#[prost(message, repeated, tag = "3")]
pub items: ::prost::alloc::vec::Vec<custom_class::ClassItem>,
/// Output only. The [KMS key
/// name](<https://cloud.google.com/kms/docs/resource-hierarchy#keys>) with which
/// the content of the ClassItem is encrypted. The expected format is
/// `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`.
#[prost(string, tag = "6")]
pub kms_key_name: ::prost::alloc::string::String,
/// Output only. The [KMS key version
/// name](<https://cloud.google.com/kms/docs/resource-hierarchy#key_versions>)
/// with which content of the ClassItem is encrypted. The expected format is
/// `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}`.
#[prost(string, tag = "7")]
pub kms_key_version_name: ::prost::alloc::string::String,
/// Output only. System-assigned unique identifier for the CustomClass.
/// This field is not used.
#[prost(string, tag = "8")]
pub uid: ::prost::alloc::string::String,
/// Output only. User-settable, human-readable name for the CustomClass. Must
/// be 63 characters or less. This field is not used.
#[prost(string, tag = "9")]
pub display_name: ::prost::alloc::string::String,
/// Output only. The CustomClass lifecycle state.
/// This field is not used.
#[prost(enumeration = "custom_class::State", tag = "10")]
pub state: i32,
/// Output only. The time at which this resource was requested for deletion.
/// This field is not used.
#[prost(message, optional, tag = "11")]
pub delete_time: ::core::option::Option<::prost_types::Timestamp>,
/// Output only. The time at which this resource will be purged.
/// This field is not used.
#[prost(message, optional, tag = "12")]
pub expire_time: ::core::option::Option<::prost_types::Timestamp>,
/// 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.
#[prost(map = "string, string", tag = "13")]
pub annotations:
::std::collections::HashMap<::prost::alloc::string::String, ::prost::alloc::string::String>,
/// 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.
#[prost(string, tag = "14")]
pub etag: ::prost::alloc::string::String,
/// Output only. Whether or not this CustomClass is in the process of being
/// updated. This field is not used.
#[prost(bool, tag = "15")]
pub reconciling: bool,
}
/// Nested message and enum types in `CustomClass`.
pub mod custom_class {
/// An item of the class.
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct ClassItem {
/// The class item's value.
#[prost(string, tag = "1")]
pub value: ::prost::alloc::string::String,
}
/// Set of states that define the lifecycle of a CustomClass.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash, PartialOrd, Ord, ::prost::Enumeration)]
#[repr(i32)]
pub enum State {
/// Unspecified state. This is only used/useful for distinguishing
/// unset values.
Unspecified = 0,
/// The normal and active state.
Active = 2,
/// This CustomClass has been deleted.
Deleted = 4,
}
impl State {
/// String value of the enum field names used in the ProtoBuf definition.
///
/// The values are not transformed in any way and thus are considered stable
/// (if the ProtoBuf definition does not change) and safe for programmatic use.
pub fn as_str_name(&self) -> &'static str {
match self {
Self::Unspecified => "STATE_UNSPECIFIED",
Self::Active => "ACTIVE",
Self::Deleted => "DELETED",
}
}
/// Creates an enum from field names used in the ProtoBuf definition.
pub fn from_str_name(value: &str) -> ::core::option::Option<Self> {
match value {
"STATE_UNSPECIFIED" => Some(Self::Unspecified),
"ACTIVE" => Some(Self::Active),
"DELETED" => Some(Self::Deleted),
_ => None,
}
}
}
}
/// Provides "hints" to the speech recognizer to favor specific words and phrases
/// in the results.
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct PhraseSet {
/// The resource name of the phrase set.
#[prost(string, tag = "1")]
pub name: ::prost::alloc::string::String,
/// A list of word and phrases.
#[prost(message, repeated, tag = "2")]
pub phrases: ::prost::alloc::vec::Vec<phrase_set::Phrase>,
/// 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.
#[prost(float, tag = "4")]
pub boost: f32,
/// 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}`.
#[prost(string, tag = "7")]
pub kms_key_name: ::prost::alloc::string::String,
/// 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}`.
#[prost(string, tag = "8")]
pub kms_key_version_name: ::prost::alloc::string::String,
/// Output only. System-assigned unique identifier for the PhraseSet.
/// This field is not used.
#[prost(string, tag = "9")]
pub uid: ::prost::alloc::string::String,
/// Output only. User-settable, human-readable name for the PhraseSet. Must be
/// 63 characters or less. This field is not used.
#[prost(string, tag = "10")]
pub display_name: ::prost::alloc::string::String,
/// Output only. The CustomClass lifecycle state.
/// This field is not used.
#[prost(enumeration = "phrase_set::State", tag = "11")]
pub state: i32,
/// Output only. The time at which this resource was requested for deletion.
/// This field is not used.
#[prost(message, optional, tag = "12")]
pub delete_time: ::core::option::Option<::prost_types::Timestamp>,
/// Output only. The time at which this resource will be purged.
/// This field is not used.
#[prost(message, optional, tag = "13")]
pub expire_time: ::core::option::Option<::prost_types::Timestamp>,
/// 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.
#[prost(map = "string, string", tag = "14")]
pub annotations:
::std::collections::HashMap<::prost::alloc::string::String, ::prost::alloc::string::String>,
/// 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.
#[prost(string, tag = "15")]
pub etag: ::prost::alloc::string::String,
/// Output only. Whether or not this PhraseSet is in the process of being
/// updated. This field is not used.
#[prost(bool, tag = "16")]
pub reconciling: bool,
}
/// Nested message and enum types in `PhraseSet`.
pub mod phrase_set {
/// 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.
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct Phrase {
/// The phrase itself.
#[prost(string, tag = "1")]
pub value: ::prost::alloc::string::String,
/// 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.
#[prost(float, tag = "2")]
pub boost: f32,
}
/// Set of states that define the lifecycle of a CustomClass.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash, PartialOrd, Ord, ::prost::Enumeration)]
#[repr(i32)]
pub enum State {
/// Unspecified state. This is only used/useful for distinguishing
/// unset values.
Unspecified = 0,
/// The normal and active state.
Active = 2,
/// This CustomClass has been deleted.
Deleted = 4,
}
impl State {
/// String value of the enum field names used in the ProtoBuf definition.
///
/// The values are not transformed in any way and thus are considered stable
/// (if the ProtoBuf definition does not change) and safe for programmatic use.
pub fn as_str_name(&self) -> &'static str {
match self {
Self::Unspecified => "STATE_UNSPECIFIED",
Self::Active => "ACTIVE",
Self::Deleted => "DELETED",
}
}
/// Creates an enum from field names used in the ProtoBuf definition.
pub fn from_str_name(value: &str) -> ::core::option::Option<Self> {
match value {
"STATE_UNSPECIFIED" => Some(Self::Unspecified),
"ACTIVE" => Some(Self::Active),
"DELETED" => Some(Self::Deleted),
_ => None,
}
}
}
}
/// The data within all PhraseSet events.
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct PhraseSetEventData {
/// Optional. The PhraseSet event payload. Unset for deletion events.
#[prost(message, optional, tag = "1")]
pub payload: ::core::option::Option<PhraseSet>,
}
/// The data within all CustomClass events.
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct CustomClassEventData {
/// Optional. The CustomClass event payload. Unset for deletion events.
#[prost(message, optional, tag = "1")]
pub payload: ::core::option::Option<CustomClass>,
}
/// The CloudEvent raised when a PhraseSet is created.
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct PhraseSetCreatedEvent {
/// The data associated with the event.
#[prost(message, optional, tag = "1")]
pub data: ::core::option::Option<PhraseSetEventData>,
}
/// The CloudEvent raised when a PhraseSet is updated.
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct PhraseSetUpdatedEvent {
/// The data associated with the event.
#[prost(message, optional, tag = "1")]
pub data: ::core::option::Option<PhraseSetEventData>,
}
/// The CloudEvent raised when a PhraseSet is deleted.
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct PhraseSetDeletedEvent {
/// The data associated with the event.
#[prost(message, optional, tag = "1")]
pub data: ::core::option::Option<PhraseSetEventData>,
}
/// The CloudEvent raised when a CustomClass is created.
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct CustomClassCreatedEvent {
/// The data associated with the event.
#[prost(message, optional, tag = "1")]
pub data: ::core::option::Option<CustomClassEventData>,
}
/// The CloudEvent raised when a CustomClass is updated.
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct CustomClassUpdatedEvent {
/// The data associated with the event.
#[prost(message, optional, tag = "1")]
pub data: ::core::option::Option<CustomClassEventData>,
}
/// The CloudEvent raised when a CustomClass is deleted.
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct CustomClassDeletedEvent {
/// The data associated with the event.
#[prost(message, optional, tag = "1")]
pub data: ::core::option::Option<CustomClassEventData>,
}