google-api-python-client 2.107.0__py2.py3-none-any.whl → 2.109.0__py2.py3-none-any.whl

googleapiclient/discovery_cache/documents/serviceusage.v1beta1.json

@@ -964,7 +964,7 @@
       }
     }
   },
-  "revision": "20231105",
+  "revision": "20231114",
   "rootUrl": "https://serviceusage.googleapis.com/",
   "schemas": {
     "AddEnableRulesMetadata": {
@@ -2467,6 +2467,83 @@
       },
       "type": "object"
     },
+    "GoogleApiServiceusageV2alphaConsumerPolicy": {
+      "description": "Consumer Policy is a set of rules that define what services or service groups can be used for a cloud resource hierarchy.",
+      "id": "GoogleApiServiceusageV2alphaConsumerPolicy",
+      "properties": {
+        "annotations": {
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Optional. Annotations is an unstructured key-value map stored with a policy that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. [AIP-128](https://google.aip.dev/128#annotations)",
+          "type": "object"
+        },
+        "createTime": {
+          "description": "Output only. The time the policy was created. For singleton policies, this is the first touch of the policy.",
+          "format": "google-datetime",
+          "readOnly": true,
+          "type": "string"
+        },
+        "enableRules": {
+          "description": "Enable rules define usable services, groups, and categories. There can currently be at most one `EnableRule`. This restriction will be lifted in later releases.",
+          "items": {
+            "$ref": "GoogleApiServiceusageV2alphaEnableRule"
+          },
+          "type": "array"
+        },
+        "etag": {
+          "description": "Output only. An opaque tag indicating the current version of the policy, used for concurrency control.",
+          "readOnly": true,
+          "type": "string"
+        },
+        "name": {
+          "description": "Output only. The resource name of the policy. Only the `default` policy is supported: `projects/12345/consumerPolicies/default`, `folders/12345/consumerPolicies/default`, `organizations/12345/consumerPolicies/default`.",
+          "readOnly": true,
+          "type": "string"
+        },
+        "updateTime": {
+          "description": "Output only. The time the policy was last updated.",
+          "format": "google-datetime",
+          "readOnly": true,
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "GoogleApiServiceusageV2alphaEnableRule": {
+      "description": "The consumer policy rule that defines enabled services, groups, and categories.",
+      "id": "GoogleApiServiceusageV2alphaEnableRule",
+      "properties": {
+        "categories": {
+          "description": "The names of the categories that are enabled. Example: `categories/googleServices`.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "groups": {
+          "description": "The names of the service groups that are enabled. Example: `services/container.googleapis.com/groups/dependencies`.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "services": {
+          "description": "The names of the services that are enabled. Example: `services/storage.googleapis.com`.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
+    "GoogleApiServiceusageV2alphaUpdateConsumerPolicyMetadata": {
+      "description": "Metadata for the `UpdateConsumerPolicy` method.",
+      "id": "GoogleApiServiceusageV2alphaUpdateConsumerPolicyMetadata",
+      "properties": {},
+      "type": "object"
+    },
     "Http": {
       "description": "Defines the HTTP configuration for an API service. It contains a list of HttpRule, each specifying the mapping of an RPC method to one or more HTTP REST API methods.",
       "id": "Http",

googleapiclient/discovery_cache/documents/sheets.v4.json

@@ -870,7 +870,7 @@
       }
     }
   },
-  "revision": "20231031",
+  "revision": "20231114",
   "rootUrl": "https://sheets.googleapis.com/",
   "schemas": {
     "AddBandingRequest": {

googleapiclient/discovery_cache/documents/slides.v1.json

@@ -313,7 +313,7 @@
       }
     }
   },
-  "revision": "20231031",
+  "revision": "20231114",
   "rootUrl": "https://slides.googleapis.com/",
   "schemas": {
     "AffineTransform": {

googleapiclient/discovery_cache/documents/smartdevicemanagement.v1.json

@@ -2,9 +2,6 @@
   "auth": {
     "oauth2": {
       "scopes": {
-        "https://www.googleapis.com/auth/cloud-platform": {
-          "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account."
-        },
         "https://www.googleapis.com/auth/sdm.service": {
           "description": "See and/or control the devices that you selected"
         }
@@ -137,7 +134,6 @@
                 "$ref": "GoogleHomeEnterpriseSdmV1ExecuteDeviceCommandResponse"
               },
               "scopes": [
-                "https://www.googleapis.com/auth/cloud-platform",
                 "https://www.googleapis.com/auth/sdm.service"
               ]
             },
@@ -163,7 +159,6 @@
                 "$ref": "GoogleHomeEnterpriseSdmV1Device"
               },
               "scopes": [
-                "https://www.googleapis.com/auth/cloud-platform",
                 "https://www.googleapis.com/auth/sdm.service"
               ]
             },
@@ -194,7 +189,6 @@
                 "$ref": "GoogleHomeEnterpriseSdmV1ListDevicesResponse"
               },
               "scopes": [
-                "https://www.googleapis.com/auth/cloud-platform",
                 "https://www.googleapis.com/auth/sdm.service"
               ]
             }
@@ -224,7 +218,6 @@
                 "$ref": "GoogleHomeEnterpriseSdmV1Structure"
               },
               "scopes": [
-                "https://www.googleapis.com/auth/cloud-platform",
                 "https://www.googleapis.com/auth/sdm.service"
               ]
             },
@@ -255,7 +248,6 @@
                 "$ref": "GoogleHomeEnterpriseSdmV1ListStructuresResponse"
               },
               "scopes": [
-                "https://www.googleapis.com/auth/cloud-platform",
                 "https://www.googleapis.com/auth/sdm.service"
               ]
             }
@@ -285,7 +277,6 @@
                     "$ref": "GoogleHomeEnterpriseSdmV1Room"
                   },
                   "scopes": [
-                    "https://www.googleapis.com/auth/cloud-platform",
                     "https://www.googleapis.com/auth/sdm.service"
                   ]
                 },
@@ -311,7 +302,6 @@
                     "$ref": "GoogleHomeEnterpriseSdmV1ListRoomsResponse"
                   },
                   "scopes": [
-                    "https://www.googleapis.com/auth/cloud-platform",
                     "https://www.googleapis.com/auth/sdm.service"
                   ]
                 }
@@ -322,7 +312,7 @@
       }
     }
   },
-  "revision": "20231029",
+  "revision": "20231119",
   "rootUrl": "https://smartdevicemanagement.googleapis.com/",
   "schemas": {
     "GoogleHomeEnterpriseSdmV1Device": {

googleapiclient/discovery_cache/documents/sourcerepo.v1.json

@@ -450,7 +450,7 @@
       }
     }
   },
-  "revision": "20231102",
+  "revision": "20231105",
   "rootUrl": "https://sourcerepo.googleapis.com/",
   "schemas": {
     "AuditConfig": {

googleapiclient/discovery_cache/documents/spanner.v1.json

@@ -450,6 +450,134 @@
                   ]
                 }
               }
+            },
+            "ssdCaches": {
+              "resources": {
+                "operations": {
+                  "methods": {
+                    "cancel": {
+                      "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.",
+                      "flatPath": "v1/projects/{projectsId}/instanceConfigs/{instanceConfigsId}/ssdCaches/{ssdCachesId}/operations/{operationsId}:cancel",
+                      "httpMethod": "POST",
+                      "id": "spanner.projects.instanceConfigs.ssdCaches.operations.cancel",
+                      "parameterOrder": [
+                        "name"
+                      ],
+                      "parameters": {
+                        "name": {
+                          "description": "The name of the operation resource to be cancelled.",
+                          "location": "path",
+                          "pattern": "^projects/[^/]+/instanceConfigs/[^/]+/ssdCaches/[^/]+/operations/[^/]+$",
+                          "required": true,
+                          "type": "string"
+                        }
+                      },
+                      "path": "v1/{+name}:cancel",
+                      "response": {
+                        "$ref": "Empty"
+                      },
+                      "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/spanner.admin"
+                      ]
+                    },
+                    "delete": {
+                      "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.",
+                      "flatPath": "v1/projects/{projectsId}/instanceConfigs/{instanceConfigsId}/ssdCaches/{ssdCachesId}/operations/{operationsId}",
+                      "httpMethod": "DELETE",
+                      "id": "spanner.projects.instanceConfigs.ssdCaches.operations.delete",
+                      "parameterOrder": [
+                        "name"
+                      ],
+                      "parameters": {
+                        "name": {
+                          "description": "The name of the operation resource to be deleted.",
+                          "location": "path",
+                          "pattern": "^projects/[^/]+/instanceConfigs/[^/]+/ssdCaches/[^/]+/operations/[^/]+$",
+                          "required": true,
+                          "type": "string"
+                        }
+                      },
+                      "path": "v1/{+name}",
+                      "response": {
+                        "$ref": "Empty"
+                      },
+                      "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/spanner.admin"
+                      ]
+                    },
+                    "get": {
+                      "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.",
+                      "flatPath": "v1/projects/{projectsId}/instanceConfigs/{instanceConfigsId}/ssdCaches/{ssdCachesId}/operations/{operationsId}",
+                      "httpMethod": "GET",
+                      "id": "spanner.projects.instanceConfigs.ssdCaches.operations.get",
+                      "parameterOrder": [
+                        "name"
+                      ],
+                      "parameters": {
+                        "name": {
+                          "description": "The name of the operation resource.",
+                          "location": "path",
+                          "pattern": "^projects/[^/]+/instanceConfigs/[^/]+/ssdCaches/[^/]+/operations/[^/]+$",
+                          "required": true,
+                          "type": "string"
+                        }
+                      },
+                      "path": "v1/{+name}",
+                      "response": {
+                        "$ref": "Operation"
+                      },
+                      "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/spanner.admin"
+                      ]
+                    },
+                    "list": {
+                      "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.",
+                      "flatPath": "v1/projects/{projectsId}/instanceConfigs/{instanceConfigsId}/ssdCaches/{ssdCachesId}/operations",
+                      "httpMethod": "GET",
+                      "id": "spanner.projects.instanceConfigs.ssdCaches.operations.list",
+                      "parameterOrder": [
+                        "name"
+                      ],
+                      "parameters": {
+                        "filter": {
+                          "description": "The standard list filter.",
+                          "location": "query",
+                          "type": "string"
+                        },
+                        "name": {
+                          "description": "The name of the operation's parent resource.",
+                          "location": "path",
+                          "pattern": "^projects/[^/]+/instanceConfigs/[^/]+/ssdCaches/[^/]+/operations$",
+                          "required": true,
+                          "type": "string"
+                        },
+                        "pageSize": {
+                          "description": "The standard list page size.",
+                          "format": "int32",
+                          "location": "query",
+                          "type": "integer"
+                        },
+                        "pageToken": {
+                          "description": "The standard list page token.",
+                          "location": "query",
+                          "type": "string"
+                        }
+                      },
+                      "path": "v1/{+name}",
+                      "response": {
+                        "$ref": "ListOperationsResponse"
+                      },
+                      "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/spanner.admin"
+                      ]
+                    }
+                  }
+                }
+              }
             }
           }
         },
@@ -2601,7 +2729,7 @@
       }
     }
   },
-  "revision": "20231017",
+  "revision": "20231101",
   "rootUrl": "https://spanner.googleapis.com/",
   "schemas": {
     "AutoscalingConfig": {
@@ -3446,6 +3574,21 @@
       },
       "type": "object"
     },
+    "DirectedReadOptions": {
+      "description": "The DirectedReadOptions can be used to indicate which replicas or regions should be used for non-transactional reads or queries. DirectedReadOptions may only be specified for a read-only transaction, otherwise the API will return an `INVALID_ARGUMENT` error.",
+      "id": "DirectedReadOptions",
+      "properties": {
+        "excludeReplicas": {
+          "$ref": "ExcludeReplicas",
+          "description": "Exclude_replicas indicates that should be excluded from serving requests. Spanner will not route requests to the replicas in this list."
+        },
+        "includeReplicas": {
+          "$ref": "IncludeReplicas",
+          "description": "Include_replicas indicates the order of replicas (as they appear in this list) to process the request. If auto_failover_disabled is set to true and all replicas are exhausted without finding a healthy replica, Spanner will wait for a replica in the list to become available, requests may fail due to `DEADLINE_EXCEEDED` errors."
+        }
+      },
+      "type": "object"
+    },
     "Empty": {
       "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }",
       "id": "Empty",
@@ -3495,6 +3638,20 @@
       },
       "type": "object"
     },
+    "ExcludeReplicas": {
+      "description": "An ExcludeReplicas contains a repeated set of ReplicaSelection that should be excluded from serving requests.",
+      "id": "ExcludeReplicas",
+      "properties": {
+        "replicaSelections": {
+          "description": "The directed read replica selector.",
+          "items": {
+            "$ref": "ReplicaSelection"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
     "ExecuteBatchDmlRequest": {
       "description": "The request for ExecuteBatchDml.",
       "id": "ExecuteBatchDmlRequest",
@@ -3548,6 +3705,10 @@
           "description": "If this is for a partitioned query and this field is set to `true`, the request is executed with Spanner Data Boost independent compute resources. If the field is set to `true` but the request does not set `partition_token`, the API returns an `INVALID_ARGUMENT` error.",
           "type": "boolean"
         },
+        "directedReadOptions": {
+          "$ref": "DirectedReadOptions",
+          "description": "Directed read options for this request."
+        },
         "paramTypes": {
           "additionalProperties": {
             "$ref": "Type"
@@ -3724,6 +3885,24 @@
       },
       "type": "object"
     },
+    "IncludeReplicas": {
+      "description": "An IncludeReplicas contains a repeated set of ReplicaSelection which indicates the order in which replicas should be considered.",
+      "id": "IncludeReplicas",
+      "properties": {
+        "autoFailoverDisabled": {
+          "description": "If true, Spanner will not route requests to a replica outside the include_replicas list when all of the specified replicas are unavailable or unhealthy. Default value is `false`.",
+          "type": "boolean"
+        },
+        "replicaSelections": {
+          "description": "The directed read replica selector.",
+          "items": {
+            "$ref": "ReplicaSelection"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
     "IndexAdvice": {
       "description": "Recommendation to add new indexes to run queries more efficiently.",
       "id": "IndexAdvice",
@@ -4926,6 +5105,10 @@
           "description": "If this is for a partitioned read and this field is set to `true`, the request is executed with Spanner Data Boost independent compute resources. If the field is set to `true` but the request does not set `partition_token`, the API returns an `INVALID_ARGUMENT` error.",
           "type": "boolean"
         },
+        "directedReadOptions": {
+          "$ref": "DirectedReadOptions",
+          "description": "Directed read options for this request."
+        },
         "index": {
           "description": "If non-empty, the name of an index on table. This index is used instead of the table primary key when interpreting key_set and sorting result rows. See key_set for further information.",
           "type": "string"
@@ -5015,6 +5198,31 @@
       },
       "type": "object"
     },
+    "ReplicaSelection": {
+      "description": "The directed read replica selector. Callers must provide one or more of the following fields for replica selection: * `location` - The location must be one of the regions within the multi-region configuration of your database. * `type` - The type of the replica. Some examples of using replica_selectors are: * `location:us-east1` --> The \"us-east1\" replica(s) of any available type will be used to process the request. * `type:READ_ONLY` --> The \"READ_ONLY\" type replica(s) in nearest . available location will be used to process the request. * `location:us-east1 type:READ_ONLY` --> The \"READ_ONLY\" type replica(s) in location \"us-east1\" will be used to process the request.",
+      "id": "ReplicaSelection",
+      "properties": {
+        "location": {
+          "description": "The location or region of the serving requests, e.g. \"us-east1\".",
+          "type": "string"
+        },
+        "type": {
+          "description": "The type of replica.",
+          "enum": [
+            "TYPE_UNSPECIFIED",
+            "READ_WRITE",
+            "READ_ONLY"
+          ],
+          "enumDescriptions": [
+            "Not specified.",
+            "Read-write replicas support both reads and writes.",
+            "Read-only replicas only support reads (not writes)."
+          ],
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "RequestOptions": {
       "description": "Common request options for various APIs.",
       "id": "RequestOptions",

googleapiclient/discovery_cache/documents/speech.v1.json

@@ -524,7 +524,7 @@
       }
     }
   },
-  "revision": "20231024",
+  "revision": "20231115",
   "rootUrl": "https://speech.googleapis.com/",
   "schemas": {
     "ABNFGrammar": {
@@ -674,6 +674,25 @@
       "properties": {},
       "type": "object"
     },
+    "Entry": {
+      "description": "A single replacement configuration.",
+      "id": "Entry",
+      "properties": {
+        "caseSensitive": {
+          "description": "Whether the search is case sensitive.",
+          "type": "boolean"
+        },
+        "replace": {
+          "description": "What to replace with. Max length is 100 characters.",
+          "type": "string"
+        },
+        "search": {
+          "description": "What to replace. Max length is 100 characters.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "ListCustomClassesResponse": {
       "description": "Message returned to the client by the `ListCustomClasses` method.",
       "id": "ListCustomClassesResponse",
@@ -1024,6 +1043,7 @@
             "AMR_WB",
             "OGG_OPUS",
             "SPEEX_WITH_HEADER_BYTE",
+            "MP3",
             "WEBM_OPUS"
           ],
           "enumDescriptions": [
@@ -1035,7 +1055,8 @@
             "Adaptive Multi-Rate Wideband codec. `sample_rate_hertz` must be 16000.",
             "Opus encoded audio frames in Ogg container ([OggOpus](https://wiki.xiph.org/OggOpus)). `sample_rate_hertz` must be one of 8000, 12000, 16000, 24000, or 48000.",
             "Although the use of lossy encodings is not recommended, if a very low bitrate encoding is required, `OGG_OPUS` is highly preferred over Speex encoding. The [Speex](https://speex.org/) encoding supported by Cloud Speech API has a header byte in each block, as in MIME type `audio/x-speex-with-header-byte`. It is a variant of the RTP Speex encoding defined in [RFC 5574](https://tools.ietf.org/html/rfc5574). The stream is a sequence of blocks, one block per RTP packet. Each block starts with a byte containing the length of the block, in bytes, followed by one or more frames of Speex data, padded to an integral number of bytes (octets) as specified in RFC 5574. In other words, each RTP header is replaced with a single byte containing the block length. Only Speex wideband is supported. `sample_rate_hertz` must be 16000.",
-            "Opus encoded audio frames in WebM container ([OggOpus](https://wiki.xiph.org/OggOpus)). `sample_rate_hertz` must be one of 8000, 12000, 16000, 24000, or 48000."
+            "MP3 audio. MP3 encoding is a Beta feature and only available in v1p1beta1. Support all standard MP3 bitrates (which range from 32-320 kbps). When using this encoding, `sample_rate_hertz` has to match the sample rate of the file being used.",
+            "Opus encoded audio frames in WebM container ([WebM](https://www.webmproject.org/docs/container/)). `sample_rate_hertz` must be one of 8000, 12000, 16000, 24000, or 48000."
           ],
           "type": "string"
         },
@@ -1072,6 +1093,10 @@
           },
           "type": "array"
         },
+        "transcriptNormalization": {
+          "$ref": "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."
+        },
         "useEnhanced": {
           "description": "Set to true to use an enhanced model for speech recognition. If `use_enhanced` is set to true and the `model` field is not set, then an appropriate enhanced model is chosen if an enhanced model exists for the audio. If `use_enhanced` is true and an enhanced version of the specified model does not exist, then the speech is recognized using the standard version of the specified model.",
           "type": "boolean"
@@ -1398,6 +1423,20 @@
       },
       "type": "object"
     },
+    "TranscriptNormalization": {
+      "description": "Transcription normalization configuration. 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.",
+      "id": "TranscriptNormalization",
+      "properties": {
+        "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.",
+          "items": {
+            "$ref": "Entry"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
     "TranscriptOutputConfig": {
       "description": "Specifies an optional destination for the recognition results.",
       "id": "TranscriptOutputConfig",

googleapiclient/discovery_cache/documents/speech.v1p1beta1.json

@@ -524,7 +524,7 @@
       }
     }
   },
-  "revision": "20231024",
+  "revision": "20231115",
   "rootUrl": "https://speech.googleapis.com/",
   "schemas": {
     "ABNFGrammar": {
@@ -1072,7 +1072,7 @@
             "Opus encoded audio frames in Ogg container ([OggOpus](https://wiki.xiph.org/OggOpus)). `sample_rate_hertz` must be one of 8000, 12000, 16000, 24000, or 48000.",
             "Although the use of lossy encodings is not recommended, if a very low bitrate encoding is required, `OGG_OPUS` is highly preferred over Speex encoding. The [Speex](https://speex.org/) encoding supported by Cloud Speech API has a header byte in each block, as in MIME type `audio/x-speex-with-header-byte`. It is a variant of the RTP Speex encoding defined in [RFC 5574](https://tools.ietf.org/html/rfc5574). The stream is a sequence of blocks, one block per RTP packet. Each block starts with a byte containing the length of the block, in bytes, followed by one or more frames of Speex data, padded to an integral number of bytes (octets) as specified in RFC 5574. In other words, each RTP header is replaced with a single byte containing the block length. Only Speex wideband is supported. `sample_rate_hertz` must be 16000.",
             "MP3 audio. MP3 encoding is a Beta feature and only available in v1p1beta1. Support all standard MP3 bitrates (which range from 32-320 kbps). When using this encoding, `sample_rate_hertz` has to match the sample rate of the file being used.",
-            "Opus encoded audio frames in WebM container ([OggOpus](https://wiki.xiph.org/OggOpus)). `sample_rate_hertz` must be one of 8000, 12000, 16000, 24000, or 48000."
+            "Opus encoded audio frames in WebM container ([WebM](https://www.webmproject.org/docs/container/)). `sample_rate_hertz` must be one of 8000, 12000, 16000, 24000, or 48000."
           ],
           "type": "string"
         },
@@ -1111,7 +1111,7 @@
         },
         "transcriptNormalization": {
           "$ref": "TranscriptNormalization",
-          "description": "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."
+          "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."
         },
         "useEnhanced": {
           "description": "Set to true to use an enhanced model for speech recognition. If `use_enhanced` is set to true and the `model` field is not set, then an appropriate enhanced model is chosen if an enhanced model exists for the audio. If `use_enhanced` is true and an enhanced version of the specified model does not exist, then the speech is recognized using the standard version of the specified model.",