Google APIs updated at 2022-11-18

gcloud-sdk/genproto/google.cloud.aiplatform.v1.rs

@@ -2410,6 +2410,15 @@ pub struct BatchPredictionJob {
     /// must be provided.
     #[prost(message, optional, tag = "7")]
     pub dedicated_resources: ::core::option::Option<BatchDedicatedResources>,
+    /// The service account that the DeployedModel's container runs as. If not
+    /// specified, a system generated one will be used, which
+    /// has minimal permissions and the custom container, if used, may not have
+    /// enough permission to access other GCP resources.
+    ///
+    /// Users deploying the Model must have the `iam.serviceAccounts.actAs`
+    /// permission on this service account.
+    #[prost(string, tag = "29")]
+    pub service_account: ::prost::alloc::string::String,
     /// Immutable. Parameters configuring the batch behavior. Currently only applicable when
     /// \[dedicated_resources][google.cloud.aiplatform.v1.BatchPredictionJob.dedicated_resources\] are used (in other cases Vertex AI does
     /// the tuning itself).

gcloud-sdk/genproto/google.cloud.beyondcorp.appconnections.v1.rs

@@ -433,12 +433,12 @@ pub mod app_connections_service_client {
     #![allow(unused_variables, dead_code, missing_docs, clippy::let_unit_value)]
     use tonic::codegen::*;
     use tonic::codegen::http::Uri;
-    /// ## API Overview
+    /// API Overview:
     ///
     /// The `beyondcorp.googleapis.com` service implements the Google Cloud
     /// BeyondCorp API.
     ///
-    /// ## Data Model
+    /// Data Model:
     ///
     /// The AppConnectionsService exposes the following resources:
     ///

gcloud-sdk/genproto/google.cloud.beyondcorp.appconnectors.v1.rs

@@ -435,12 +435,12 @@ pub mod app_connectors_service_client {
     #![allow(unused_variables, dead_code, missing_docs, clippy::let_unit_value)]
     use tonic::codegen::*;
     use tonic::codegen::http::Uri;
-    /// ## API Overview
+    /// API Overview:
     ///
     /// The `beyondcorp.googleapis.com` service implements the Google Cloud
     /// BeyondCorp API.
     ///
-    /// ## Data Model
+    /// Data Model:
     ///
     /// The AppConnectorsService exposes the following resource:
     ///

gcloud-sdk/genproto/google.cloud.beyondcorp.appgateways.v1.rs

@@ -315,12 +315,12 @@ pub mod app_gateways_service_client {
     #![allow(unused_variables, dead_code, missing_docs, clippy::let_unit_value)]
     use tonic::codegen::*;
     use tonic::codegen::http::Uri;
-    /// ## API Overview
+    /// API Overview:
     ///
     /// The `beyondcorp.googleapis.com` service implements the Google Cloud
     /// BeyondCorp API.
     ///
-    /// ## Data Model
+    /// Data Model:
     ///
     /// The AppGatewaysService exposes the following resources:
     ///

gcloud-sdk/genproto/google.cloud.beyondcorp.clientconnectorservices.v1.rs

@@ -353,12 +353,12 @@ pub mod client_connector_services_service_client {
     #![allow(unused_variables, dead_code, missing_docs, clippy::let_unit_value)]
     use tonic::codegen::*;
     use tonic::codegen::http::Uri;
-    /// ## API Overview
+    /// API Overview:
     ///
     /// The `beyondcorp.googleapis.com` service implements the Google Cloud
     /// BeyondCorp API.
     ///
-    /// ## Data Model
+    /// Data Model:
     ///
     /// The ClientConnectorServicesService exposes the following resources:
     ///

gcloud-sdk/genproto/google.cloud.beyondcorp.clientgateways.v1.rs

@@ -207,12 +207,12 @@ pub mod client_gateways_service_client {
     #![allow(unused_variables, dead_code, missing_docs, clippy::let_unit_value)]
     use tonic::codegen::*;
     use tonic::codegen::http::Uri;
-    /// ## API Overview
+    /// API Overview:
     ///
     /// The `beyondcorp.googleapis.com` service implements the Google Cloud
     /// BeyondCorp API.
     ///
-    /// ## Data Model
+    /// Data Model:
     ///
     /// The ClientGatewaysService exposes the following resources:
     ///

gcloud-sdk/genproto/google.cloud.bigquery.datatransfer.v1.rs

@@ -55,7 +55,9 @@ pub struct TransferConfig {
     /// User specified display name for the data transfer.
     #[prost(string, tag = "3")]
     pub display_name: ::prost::alloc::string::String,
-    /// Data source id. Cannot be changed once data transfer is created.
+    /// Data source ID. This cannot be changed once data transfer is created. The
+    /// full list of available data source IDs can be returned through an API call:
+    /// <https://cloud.google.com/bigquery-transfer/docs/reference/datatransfer/rest/v1/projects.locations.dataSources/list>
     #[prost(string, tag = "5")]
     pub data_source_id: ::prost::alloc::string::String,
     /// Parameters specific to each data source. For more information see the
@@ -360,7 +362,7 @@ pub struct DataSourceParameter {
     /// For integer and double values specifies minimum allowed value.
     #[prost(message, optional, tag = "9")]
     pub min_value: ::core::option::Option<f64>,
-    /// For integer and double values specifies maxminum allowed value.
+    /// For integer and double values specifies maximum allowed value.
     #[prost(message, optional, tag = "10")]
     pub max_value: ::core::option::Option<f64>,
     /// Deprecated. This field has no effect.
@@ -604,7 +606,7 @@ pub struct GetDataSourceRequest {
 pub struct ListDataSourcesRequest {
     /// Required. The BigQuery project id for which data sources should be returned.
     /// Must be in the form: `projects/{project_id}` or
-    /// `projects/{project_id}/locations/{location_id}
+    /// `projects/{project_id}/locations/{location_id}`
     #[prost(string, tag = "1")]
     pub parent: ::prost::alloc::string::String,
     /// Pagination token, which can be used to request a specific page
@@ -632,9 +634,9 @@ pub struct ListDataSourcesResponse {
     pub next_page_token: ::prost::alloc::string::String,
 }
 /// A request to create a data transfer configuration. If new credentials are
-/// needed for this transfer configuration, an authorization code must be
-/// provided. If an authorization code is provided, the transfer configuration
-/// will be associated with the user id corresponding to the authorization code.
+/// needed for this transfer configuration, authorization info must be provided.
+/// If authorization info is provided, the transfer configuration will be
+/// associated with the user id corresponding to the authorization info.
 /// Otherwise, the transfer configuration will be associated with the calling
 /// user.
 #[derive(Clone, PartialEq, ::prost::Message)]
@@ -649,79 +651,100 @@ pub struct CreateTransferConfigRequest {
     #[prost(message, optional, tag = "2")]
     pub transfer_config: ::core::option::Option<TransferConfig>,
     /// Optional OAuth2 authorization code to use with this transfer configuration.
-    /// This is required if new credentials are needed, as indicated by
-    /// `CheckValidCreds`.
-    /// In order to obtain authorization_code, please make a
-    /// request to
-    /// <https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?client_id=<datatransferapiclientid>&scope=<data_source_scopes>&redirect_uri=<redirect_uri>>
+    /// This is required only if `transferConfig.dataSourceId` is 'youtube_channel'
+    /// and new credentials are needed, as indicated by `CheckValidCreds`. In order
+    /// to obtain authorization_code, make a request to the following URL:
+    /// <pre class="prettyprint" suppresswarning="true">
+    /// <https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?redirect_uri=urn:ietf:wg:oauth:2.0:oob&response_type=authorization_code&client_id=<var>client_id</var>&scope=<var>data_source_scopes</var>>
+    /// </pre>
+    /// * The <var>client_id</var> is the OAuth client_id of the a data source as
+    /// returned by ListDataSources method.
+    /// * <var>data_source_scopes</var> are the scopes returned by ListDataSources
+    /// method.
     ///
-    /// * client_id should be OAuth client_id of BigQuery DTS API for the given
-    ///    data source returned by ListDataSources method.
-    /// * data_source_scopes are the scopes returned by ListDataSources method.
-    /// * redirect_uri is an optional parameter. If not specified, then
-    ///    authorization code is posted to the opener of authorization flow window.
-    ///    Otherwise it will be sent to the redirect uri. A special value of
-    ///    urn:ietf:wg:oauth:2.0:oob means that authorization code should be
-    ///    returned in the title bar of the browser, with the page text prompting
-    ///    the user to copy the code and paste it in the application.
+    /// Note that this should not be set when `service_account_name` is used to
+    /// create the transfer config.
     #[prost(string, tag = "3")]
     pub authorization_code: ::prost::alloc::string::String,
-    /// Optional version info. If users want to find a very recent access token,
-    /// that is, immediately after approving access, users have to set the
-    /// version_info claim in the token request. To obtain the version_info, users
-    /// must use the "none+gsession" response type. which be return a
-    /// version_info back in the authorization response which be be put in a JWT
-    /// claim in the token request.
+    /// Optional version info. This is required only if
+    /// `transferConfig.dataSourceId` is not 'youtube_channel' and new credentials
+    /// are needed, as indicated by `CheckValidCreds`. In order to obtain version
+    /// info, make a request to the following URL:
+    /// <pre class="prettyprint" suppresswarning="true">
+    /// <https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?redirect_uri=urn:ietf:wg:oauth:2.0:oob&response_type=version_info&client_id=<var>client_id</var>&scope=<var>data_source_scopes</var>>
+    /// </pre>
+    /// * The <var>client_id</var> is the OAuth client_id of the a data source as
+    /// returned by ListDataSources method.
+    /// * <var>data_source_scopes</var> are the scopes returned by ListDataSources
+    /// method.
+    ///
+    /// Note that this should not be set when `service_account_name` is used to
+    /// create the transfer config.
     #[prost(string, tag = "5")]
     pub version_info: ::prost::alloc::string::String,
-    /// Optional service account name. If this field is set, transfer config will
-    /// be created with this service account credentials. It requires that
-    /// requesting user calling this API has permissions to act as this service
+    /// Optional service account name. If this field is set, the transfer config
+    /// will be created with this service account's credentials. It requires that
+    /// the requesting user calling this API has permissions to act as this service
     /// account.
+    ///
+    /// Note that not all data sources support service account credentials when
+    /// creating a transfer config. For the latest list of data sources, read about
+    /// [using service
+    /// accounts](<https://cloud.google.com/bigquery-transfer/docs/use-service-accounts>).
     #[prost(string, tag = "6")]
     pub service_account_name: ::prost::alloc::string::String,
 }
 /// A request to update a transfer configuration. To update the user id of the
-/// transfer configuration, an authorization code needs to be provided.
+/// transfer configuration, authorization info needs to be provided.
 #[derive(Clone, PartialEq, ::prost::Message)]
 pub struct UpdateTransferConfigRequest {
     /// Required. Data transfer configuration to create.
     #[prost(message, optional, tag = "1")]
     pub transfer_config: ::core::option::Option<TransferConfig>,
     /// Optional OAuth2 authorization code to use with this transfer configuration.
-    /// If it is provided, the transfer configuration will be associated with the
-    /// authorizing user.
-    /// In order to obtain authorization_code, please make a
-    /// request to
-    /// <https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?client_id=<datatransferapiclientid>&scope=<data_source_scopes>&redirect_uri=<redirect_uri>>
+    /// This is required only if `transferConfig.dataSourceId` is 'youtube_channel'
+    /// and new credentials are needed, as indicated by `CheckValidCreds`. In order
+    /// to obtain authorization_code, make a request to the following URL:
+    /// <pre class="prettyprint" suppresswarning="true">
+    /// <https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?redirect_uri=urn:ietf:wg:oauth:2.0:oob&response_type=authorization_code&client_id=<var>client_id</var>&scope=<var>data_source_scopes</var>>
+    /// </pre>
+    /// * The <var>client_id</var> is the OAuth client_id of the a data source as
+    /// returned by ListDataSources method.
+    /// * <var>data_source_scopes</var> are the scopes returned by ListDataSources
+    /// method.
     ///
-    /// * client_id should be OAuth client_id of BigQuery DTS API for the given
-    ///    data source returned by ListDataSources method.
-    /// * data_source_scopes are the scopes returned by ListDataSources method.
-    /// * redirect_uri is an optional parameter. If not specified, then
-    ///    authorization code is posted to the opener of authorization flow window.
-    ///    Otherwise it will be sent to the redirect uri. A special value of
-    ///    urn:ietf:wg:oauth:2.0:oob means that authorization code should be
-    ///    returned in the title bar of the browser, with the page text prompting
-    ///    the user to copy the code and paste it in the application.
+    /// Note that this should not be set when `service_account_name` is used to
+    /// update the transfer config.
     #[prost(string, tag = "3")]
     pub authorization_code: ::prost::alloc::string::String,
     /// Required. Required list of fields to be updated in this request.
     #[prost(message, optional, tag = "4")]
     pub update_mask: ::core::option::Option<::prost_types::FieldMask>,
-    /// Optional version info. If users want to find a very recent access token,
-    /// that is, immediately after approving access, users have to set the
-    /// version_info claim in the token request. To obtain the version_info, users
-    /// must use the "none+gsession" response type. which be return a
-    /// version_info back in the authorization response which be be put in a JWT
-    /// claim in the token request.
+    /// Optional version info. This is required only if
+    /// `transferConfig.dataSourceId` is not 'youtube_channel' and new credentials
+    /// are needed, as indicated by `CheckValidCreds`. In order to obtain version
+    /// info, make a request to the following URL:
+    /// <pre class="prettyprint" suppresswarning="true">
+    /// <https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?redirect_uri=urn:ietf:wg:oauth:2.0:oob&response_type=version_info&client_id=<var>client_id</var>&scope=<var>data_source_scopes</var>>
+    /// </pre>
+    /// * The <var>client_id</var> is the OAuth client_id of the a data source as
+    /// returned by ListDataSources method.
+    /// * <var>data_source_scopes</var> are the scopes returned by ListDataSources
+    /// method.
+    ///
+    /// Note that this should not be set when `service_account_name` is used to
+    /// update the transfer config.
     #[prost(string, tag = "5")]
     pub version_info: ::prost::alloc::string::String,
-    /// Optional service account name. If this field is set and
-    /// "service_account_name" is set in update_mask, transfer config will be
-    /// updated to use this service account credentials. It requires that
-    /// requesting user calling this API has permissions to act as this service
+    /// Optional service account name. If this field is set, the transfer config
+    /// will be created with this service account's credentials. It requires that
+    /// the requesting user calling this API has permissions to act as this service
     /// account.
+    ///
+    /// Note that not all data sources support service account credentials when
+    /// creating a transfer config. For the latest list of data sources, read about
+    /// [using service
+    /// accounts](<https://cloud.google.com/bigquery-transfer/docs/use-service-accounts>).
     #[prost(string, tag = "6")]
     pub service_account_name: ::prost::alloc::string::String,
 }
@@ -765,7 +788,7 @@ pub struct DeleteTransferRunRequest {
 /// A request to list data transfers configured for a BigQuery project.
 #[derive(Clone, PartialEq, ::prost::Message)]
 pub struct ListTransferConfigsRequest {
-    /// Required. The BigQuery project id for which data sources
+    /// Required. The BigQuery project id for which transfer configs
     /// should be returned: `projects/{project_id}` or
     /// `projects/{project_id}/locations/{location_id}`
     #[prost(string, tag = "1")]
@@ -1007,8 +1030,7 @@ pub struct StartManualTransferRunsResponse {
 /// BigQuery UI's `Transfer` tab.
 #[derive(Clone, PartialEq, ::prost::Message)]
 pub struct EnrollDataSourcesRequest {
-    /// The name of the project resource in the form:
-    /// `projects/{project_id}`
+    /// The name of the project resource in the form: `projects/{project_id}`
     #[prost(string, tag = "1")]
     pub name: ::prost::alloc::string::String,
     /// Data sources that are enrolled. It is required to provide at least one
@@ -1385,10 +1407,12 @@ pub mod data_transfer_service_client {
         }
         /// Enroll data sources in a user project. This allows users to create transfer
         /// configurations for these data sources. They will also appear in the
-        /// ListDataSources RPC and as such, will appear in the BigQuery UI
-        /// 'https://bigquery.cloud.google.com' (and the documents can be found at
-        /// https://cloud.google.com/bigquery/bigquery-web-ui and
-        /// https://cloud.google.com/bigquery/docs/working-with-transfers).
+        /// ListDataSources RPC and as such, will appear in the
+        /// [BigQuery UI](https://console.cloud.google.com/bigquery), and the documents
+        /// can be found in the public guide for
+        /// [BigQuery Web UI](https://cloud.google.com/bigquery/bigquery-web-ui) and
+        /// [Data Transfer
+        /// Service](https://cloud.google.com/bigquery/docs/working-with-transfers).
         pub async fn enroll_data_sources(
             &mut self,
             request: impl tonic::IntoRequest<super::EnrollDataSourcesRequest>,