google-apis-bigquerydatatransfer_v1 0.17.0 → 0.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 497ef6d9bb2b329de406722851258fe3539aeb89cb4f2e3772beb0e12eac5fbc
-  data.tar.gz: e652b6c33359bb3e5d4e4cb3d0b5639a26094c3b617d75fd1a4ae7a0904d0571
+  metadata.gz: 8ce037f5151bd4017f61fdbabb8b6b7d6990d33fa6616863a04a165cff70dd03
+  data.tar.gz: 3ced706c1326d09dcd37eb6f936d3101723a0b32e8d46ce72a4deef87cded3ee
 SHA512:
-  metadata.gz: a7133be568090c663d3d142c7d4a41a7e1f405a0b63dbd68440641edb91ef3d8ef6441a7e62f2fc5b9ad0b4ea83991decdf5b046fbaf5964a0a89c2f97941835
-  data.tar.gz: 0d55d022dac3aff0c537befce65743f9ba1f91b14cd6834f4a9a6aa37b49672b4efbea48c0cc37a2d43f653f5d086421c5ca1945aa8de7ae5ba98e8776cba7ed
+  metadata.gz: 1de2a407c337968c049c9ceba25837951aa09e45a7661b92755577194444d8b6f0c70f39b8ff447ec94cad24a51fc04009269a3cba4f7668491392b8c9137576
+  data.tar.gz: d5a8a62a01518915e538c83c675e7036a9c0b0a9267479bb610b57375ba8a13fff768d318a1dbe569e38405716e58ac761b2f36873cac352487577d6333593b4

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Release history for google-apis-bigquerydatatransfer_v1
 
+### v0.20.0 (2022-04-21)
+
+* Regenerated from discovery document revision 20220409
+
+### v0.19.0 (2022-03-27)
+
+* Regenerated from discovery document revision 20220319
+
+### v0.18.0 (2022-03-03)
+
+* Regenerated from discovery document revision 20220225
+
 ### v0.17.0 (2022-01-20)
 
 * Regenerated from discovery document revision 20220116

data/lib/google/apis/bigquerydatatransfer_v1/classes.rb

@@ -332,8 +332,7 @@ module Google
       # 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); ` The JSON representation for
-      # `Empty` is empty JSON object ````.
+      # protobuf.Empty) returns (google.protobuf.Empty); `
       class Empty
         include Google::Apis::Core::Hashable
       

data/lib/google/apis/bigquerydatatransfer_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module BigquerydatatransferV1
       # Version of the google-apis-bigquerydatatransfer_v1 gem
-      GEM_VERSION = "0.17.0"
+      GEM_VERSION = "0.20.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.4.1"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20220116"
+      REVISION = "20220409"
     end
   end
 end

data/lib/google/apis/bigquerydatatransfer_v1/service.rb

@@ -52,9 +52,10 @@ module Google
         
         # 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/
+        # 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).
         # @param [String] name
         #   The name of the project resource in the form: `projects/`project_id``
@@ -199,9 +200,10 @@ module Google
         
         # 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/
+        # 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).
         # @param [String] name
         #   The name of the project resource in the form: `projects/`project_id``
@@ -270,8 +272,8 @@ module Google
         #   The resource that owns the locations collection, if applicable.
         # @param [String] filter
         #   A filter to narrow down results to a preferred subset. The filtering language
-        #   accepts strings like "displayName=tokyo", and is documented in more detail in [
-        #   AIP-160](https://google.aip.dev/160).
+        #   accepts strings like `"displayName=tokyo"`, and is documented in more detail
+        #   in [AIP-160](https://google.aip.dev/160).
         # @param [Fixnum] page_size
         #   The maximum number of results to return. If not set, the service selects a
         #   default.
@@ -426,27 +428,33 @@ module Google
         # @param [Google::Apis::BigquerydatatransferV1::TransferConfig] transfer_config_object
         # @param [String] authorization_code
         #   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=&scope=&
-        #   redirect_uri= * 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.
+        #   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: https://www.
+        #   gstatic.com/bigquerydatatransfer/oauthz/auth? client_id=client_id&scope=
+        #   data_source_scopes &redirect_uri=urn:ietf:wg:oauth:2.0:oob&response_type=
+        #   authorization_code * The client_id is the OAuth client_id of the a data source
+        #   as returned by ListDataSources method. * data_source_scopes 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.
         # @param [String] service_account_name
-        #   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 account.
+        #   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).
         # @param [String] version_info
-        #   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: https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?
+        #   client_id=client_id&scope=data_source_scopes &redirect_uri=urn:ietf:wg:oauth:2.
+        #   0:oob&response_type=version_info * The client_id is the OAuth client_id of the
+        #   a data source as returned by ListDataSources method. * data_source_scopes 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.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -598,31 +606,36 @@ module Google
         #   The name is ignored when creating a transfer config.
         # @param [Google::Apis::BigquerydatatransferV1::TransferConfig] transfer_config_object
         # @param [String] authorization_code
-        #   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=&scope=&
-        #   redirect_uri= * 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.
+        #   Optional OAuth2 authorization code to use with this transfer configuration.
+        #   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: https://www.
+        #   gstatic.com/bigquerydatatransfer/oauthz/auth? client_id=client_id&scope=
+        #   data_source_scopes &redirect_uri=urn:ietf:wg:oauth:2.0:oob&response_type=
+        #   authorization_code * The client_id is the OAuth client_id of the a data source
+        #   as returned by ListDataSources method. * data_source_scopes 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.
         # @param [String] service_account_name
-        #   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 account.
+        #   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).
         # @param [String] update_mask
         #   Required. Required list of fields to be updated in this request.
         # @param [String] version_info
-        #   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: https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?
+        #   client_id=client_id&scope=data_source_scopes &redirect_uri=urn:ietf:wg:oauth:2.
+        #   0:oob&response_type=version_info * The client_id is the OAuth client_id of the
+        #   a data source as returned by ListDataSources method. * data_source_scopes 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.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -898,27 +911,33 @@ module Google
         # @param [Google::Apis::BigquerydatatransferV1::TransferConfig] transfer_config_object
         # @param [String] authorization_code
         #   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=&scope=&
-        #   redirect_uri= * 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.
+        #   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: https://www.
+        #   gstatic.com/bigquerydatatransfer/oauthz/auth? client_id=client_id&scope=
+        #   data_source_scopes &redirect_uri=urn:ietf:wg:oauth:2.0:oob&response_type=
+        #   authorization_code * The client_id is the OAuth client_id of the a data source
+        #   as returned by ListDataSources method. * data_source_scopes 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.
         # @param [String] service_account_name
-        #   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 account.
+        #   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).
         # @param [String] version_info
-        #   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: https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?
+        #   client_id=client_id&scope=data_source_scopes &redirect_uri=urn:ietf:wg:oauth:2.
+        #   0:oob&response_type=version_info * The client_id is the OAuth client_id of the
+        #   a data source as returned by ListDataSources method. * data_source_scopes 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.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1070,31 +1089,36 @@ module Google
         #   The name is ignored when creating a transfer config.
         # @param [Google::Apis::BigquerydatatransferV1::TransferConfig] transfer_config_object
         # @param [String] authorization_code
-        #   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=&scope=&
-        #   redirect_uri= * 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.
+        #   Optional OAuth2 authorization code to use with this transfer configuration.
+        #   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: https://www.
+        #   gstatic.com/bigquerydatatransfer/oauthz/auth? client_id=client_id&scope=
+        #   data_source_scopes &redirect_uri=urn:ietf:wg:oauth:2.0:oob&response_type=
+        #   authorization_code * The client_id is the OAuth client_id of the a data source
+        #   as returned by ListDataSources method. * data_source_scopes 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.
         # @param [String] service_account_name
-        #   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 account.
+        #   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).
         # @param [String] update_mask
         #   Required. Required list of fields to be updated in this request.
         # @param [String] version_info
-        #   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: https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?
+        #   client_id=client_id&scope=data_source_scopes &redirect_uri=urn:ietf:wg:oauth:2.
+        #   0:oob&response_type=version_info * The client_id is the OAuth client_id of the
+        #   a data source as returned by ListDataSources method. * data_source_scopes 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.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-bigquerydatatransfer_v1
 version: !ruby/object:Gem::Version
-  version: 0.17.0
+  version: 0.20.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-01-24 00:00:00.000000000 Z
+date: 2022-04-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-bigquerydatatransfer_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-bigquerydatatransfer_v1/v0.17.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-bigquerydatatransfer_v1/v0.20.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-bigquerydatatransfer_v1
 post_install_message: 
 rdoc_options: []