google-apis-bigquerydatatransfer_v1 0.41.0 → 0.43.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4a2a15234210f4da0c4bd937a53df4df7c97edd9058d38a07964328148b9b4bd
-  data.tar.gz: 6757ab1fa848352d6162f231702ef0663da6127f239e23b18003d6651f74abda
+  metadata.gz: '0629d26bebba2582757fed7efb9f16bbf36264bc7121878bd9dddf3c22056f47'
+  data.tar.gz: 9a7e50de6a2be97e39ae4bb298ab4d19a6d391c81da643c0c14bf8e265710c49
 SHA512:
-  metadata.gz: 17f6cc19ec6b3c49a4291a629fe49a93817753c559bcafa42fee2caf691f82228e16ac46c3865da59b42499b6375747a808453757ad761cf014220a92873625c
-  data.tar.gz: d42076cab94ab56de56273ed3045a48832323b209b2c9988e1a2944a8fc27f5d08c2cd7a1d6509b4ad235daa8eaedca881b572ebfa640ac58f97b11b9371141e
+  metadata.gz: 907a6a85dcd9a7a388373274fa91a2710b98d58c1b321755ef63940dac8f99c1201cc5b03dba4a8bbfa6c844c6334f47820493e5496c72fd2b95b9d53edffb44
+  data.tar.gz: 5aace50e8f754e0f5333756837806499602563f80c1088c439640dabc72d89ddb7cba567618c5a812e3ba6b3765f8fa80b6976c4b114b71d3a087142d27d5e24

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Release history for google-apis-bigquerydatatransfer_v1
 
+### v0.43.0 (2024-09-22)
+
+* Regenerated from discovery document revision 20240914
+
+### v0.42.0 (2024-08-11)
+
+* Regenerated from discovery document revision 20240806
+* Regenerated using generator version 0.15.1
+
 ### v0.41.0 (2024-05-19)
 
 * Regenerated from discovery document revision 20240512

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

@@ -385,6 +385,27 @@ module Google
         end
       end
       
+      # Options customizing EventDriven transfers schedule.
+      class EventDrivenSchedule
+        include Google::Apis::Core::Hashable
+      
+        # Pub/Sub subscription name used to receive events. Only Google Cloud Storage
+        # data source support this option. Format: projects/`project`/subscriptions/`
+        # subscription`
+        # Corresponds to the JSON property `pubsubSubscription`
+        # @return [String]
+        attr_accessor :pubsub_subscription
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @pubsub_subscription = args[:pubsub_subscription] if args.key?(:pubsub_subscription)
+        end
+      end
+      
       # Returns list of supported data sources and their metadata.
       class ListDataSourcesResponse
         include Google::Apis::Core::Hashable
@@ -565,6 +586,19 @@ module Google
         end
       end
       
+      # Options customizing manual transfers schedule.
+      class ManualSchedule
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Options customizing the data transfer schedule.
       class ScheduleOptions
         include Google::Apis::Core::Hashable
@@ -606,6 +640,41 @@ module Google
         end
       end
       
+      # V2 options customizing different types of data transfer schedule. This field
+      # supports existing time-based and manual transfer schedule. Also supports Event-
+      # Driven transfer schedule. ScheduleOptionsV2 cannot be used together with
+      # ScheduleOptions/Schedule.
+      class ScheduleOptionsV2
+        include Google::Apis::Core::Hashable
+      
+        # Options customizing EventDriven transfers schedule.
+        # Corresponds to the JSON property `eventDrivenSchedule`
+        # @return [Google::Apis::BigquerydatatransferV1::EventDrivenSchedule]
+        attr_accessor :event_driven_schedule
+      
+        # Options customizing manual transfers schedule.
+        # Corresponds to the JSON property `manualSchedule`
+        # @return [Google::Apis::BigquerydatatransferV1::ManualSchedule]
+        attr_accessor :manual_schedule
+      
+        # Options customizing the time based transfer schedule. Options are migrated
+        # from the original ScheduleOptions message.
+        # Corresponds to the JSON property `timeBasedSchedule`
+        # @return [Google::Apis::BigquerydatatransferV1::TimeBasedSchedule]
+        attr_accessor :time_based_schedule
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @event_driven_schedule = args[:event_driven_schedule] if args.key?(:event_driven_schedule)
+          @manual_schedule = args[:manual_schedule] if args.key?(:manual_schedule)
+          @time_based_schedule = args[:time_based_schedule] if args.key?(:time_based_schedule)
+        end
+      end
+      
       # A request to schedule transfer runs for a time range.
       class ScheduleTransferRunsRequest
         include Google::Apis::Core::Hashable
@@ -738,6 +807,49 @@ module Google
         end
       end
       
+      # Options customizing the time based transfer schedule. Options are migrated
+      # from the original ScheduleOptions message.
+      class TimeBasedSchedule
+        include Google::Apis::Core::Hashable
+      
+        # Defines time to stop scheduling transfer runs. A transfer run cannot be
+        # scheduled at or after the end time. The end time can be changed at any moment.
+        # Corresponds to the JSON property `endTime`
+        # @return [String]
+        attr_accessor :end_time
+      
+        # Data transfer schedule. If the data source does not support a custom schedule,
+        # this should be empty. If it is empty, the default value for the data source
+        # will be used. The specified times are in UTC. Examples of valid format: `1st,
+        # 3rd monday of month 15:30`, `every wed,fri of jan,jun 13:15`, and `first
+        # sunday of quarter 00:00`. See more explanation about the format here: https://
+        # cloud.google.com/appengine/docs/flexible/python/scheduling-jobs-with-cron-yaml#
+        # the_schedule_format NOTE: The minimum interval time between recurring
+        # transfers depends on the data source; refer to the documentation for your data
+        # source.
+        # Corresponds to the JSON property `schedule`
+        # @return [String]
+        attr_accessor :schedule
+      
+        # Specifies time to start scheduling transfer runs. The first run will be
+        # scheduled at or after the start time according to a recurrence pattern defined
+        # in the schedule string. The start time can be changed at any moment.
+        # Corresponds to the JSON property `startTime`
+        # @return [String]
+        attr_accessor :start_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @end_time = args[:end_time] if args.key?(:end_time)
+          @schedule = args[:schedule] if args.key?(:schedule)
+          @start_time = args[:start_time] if args.key?(:start_time)
+        end
+      end
+      
       # A specification for a time range, this will request transfer runs with
       # run_time between start_time (inclusive) and end_time (exclusive).
       class TimeRange
@@ -828,6 +940,16 @@ module Google
         # @return [Google::Apis::BigquerydatatransferV1::EncryptionConfiguration]
         attr_accessor :encryption_configuration
       
+        # The `Status` type defines a logical error model that is suitable for different
+        # programming environments, including REST APIs and RPC APIs. It is used by [
+        # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+        # data: error code, error message, and error details. You can find out more
+        # about this error model and how to work with it in the [API Design Guide](https:
+        # //cloud.google.com/apis/design/errors).
+        # Corresponds to the JSON property `error`
+        # @return [Google::Apis::BigquerydatatransferV1::Status]
+        attr_accessor :error
+      
         # Identifier. The resource name of the transfer config. Transfer config names
         # have the form either `projects/`project_id`/locations/`region`/transferConfigs/
         # `config_id`` or `projects/`project_id`/transferConfigs/`config_id``, where `
@@ -880,6 +1002,14 @@ module Google
         # @return [Google::Apis::BigquerydatatransferV1::ScheduleOptions]
         attr_accessor :schedule_options
       
+        # V2 options customizing different types of data transfer schedule. This field
+        # supports existing time-based and manual transfer schedule. Also supports Event-
+        # Driven transfer schedule. ScheduleOptionsV2 cannot be used together with
+        # ScheduleOptions/Schedule.
+        # Corresponds to the JSON property `scheduleOptionsV2`
+        # @return [Google::Apis::BigquerydatatransferV1::ScheduleOptionsV2]
+        attr_accessor :schedule_options_v2
+      
         # Output only. State of the most recently updated transfer run.
         # Corresponds to the JSON property `state`
         # @return [String]
@@ -909,6 +1039,7 @@ module Google
           @display_name = args[:display_name] if args.key?(:display_name)
           @email_preferences = args[:email_preferences] if args.key?(:email_preferences)
           @encryption_configuration = args[:encryption_configuration] if args.key?(:encryption_configuration)
+          @error = args[:error] if args.key?(:error)
           @name = args[:name] if args.key?(:name)
           @next_run_time = args[:next_run_time] if args.key?(:next_run_time)
           @notification_pubsub_topic = args[:notification_pubsub_topic] if args.key?(:notification_pubsub_topic)
@@ -916,6 +1047,7 @@ module Google
           @params = args[:params] if args.key?(:params)
           @schedule = args[:schedule] if args.key?(:schedule)
           @schedule_options = args[:schedule_options] if args.key?(:schedule_options)
+          @schedule_options_v2 = args[:schedule_options_v2] if args.key?(:schedule_options_v2)
           @state = args[:state] if args.key?(:state)
           @update_time = args[:update_time] if args.key?(:update_time)
           @user_id = args[:user_id] if args.key?(:user_id)

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.41.0"
+      GEM_VERSION = "0.43.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.15.0"
+      GENERATOR_VERSION = "0.15.1"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20240512"
+      REVISION = "20240914"
     end
   end
 end

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

@@ -70,6 +70,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class EventDrivenSchedule
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ListDataSourcesResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -106,12 +112,24 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ManualSchedule
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ScheduleOptions
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ScheduleOptionsV2
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ScheduleTransferRunsRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -142,6 +160,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class TimeBasedSchedule
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class TimeRange
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -266,6 +290,13 @@ module Google
         end
       end
       
+      class EventDrivenSchedule
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :pubsub_subscription, as: 'pubsubSubscription'
+        end
+      end
+      
       class ListDataSourcesResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -322,6 +353,12 @@ module Google
         end
       end
       
+      class ManualSchedule
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class ScheduleOptions
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -331,6 +368,18 @@ module Google
         end
       end
       
+      class ScheduleOptionsV2
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :event_driven_schedule, as: 'eventDrivenSchedule', class: Google::Apis::BigquerydatatransferV1::EventDrivenSchedule, decorator: Google::Apis::BigquerydatatransferV1::EventDrivenSchedule::Representation
+      
+          property :manual_schedule, as: 'manualSchedule', class: Google::Apis::BigquerydatatransferV1::ManualSchedule, decorator: Google::Apis::BigquerydatatransferV1::ManualSchedule::Representation
+      
+          property :time_based_schedule, as: 'timeBasedSchedule', class: Google::Apis::BigquerydatatransferV1::TimeBasedSchedule, decorator: Google::Apis::BigquerydatatransferV1::TimeBasedSchedule::Representation
+      
+        end
+      end
+      
       class ScheduleTransferRunsRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -373,6 +422,15 @@ module Google
         end
       end
       
+      class TimeBasedSchedule
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :end_time, as: 'endTime'
+          property :schedule, as: 'schedule'
+          property :start_time, as: 'startTime'
+        end
+      end
+      
       class TimeRange
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -394,6 +452,8 @@ module Google
       
           property :encryption_configuration, as: 'encryptionConfiguration', class: Google::Apis::BigquerydatatransferV1::EncryptionConfiguration, decorator: Google::Apis::BigquerydatatransferV1::EncryptionConfiguration::Representation
       
+          property :error, as: 'error', class: Google::Apis::BigquerydatatransferV1::Status, decorator: Google::Apis::BigquerydatatransferV1::Status::Representation
+      
           property :name, as: 'name'
           property :next_run_time, as: 'nextRunTime'
           property :notification_pubsub_topic, as: 'notificationPubsubTopic'
@@ -403,6 +463,8 @@ module Google
           property :schedule, as: 'schedule'
           property :schedule_options, as: 'scheduleOptions', class: Google::Apis::BigquerydatatransferV1::ScheduleOptions, decorator: Google::Apis::BigquerydatatransferV1::ScheduleOptions::Representation
       
+          property :schedule_options_v2, as: 'scheduleOptionsV2', class: Google::Apis::BigquerydatatransferV1::ScheduleOptionsV2, decorator: Google::Apis::BigquerydatatransferV1::ScheduleOptionsV2::Representation
+      
           property :state, as: 'state'
           property :update_time, as: 'updateTime'
           property :user_id, :numeric_string => true, as: 'userId'

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

@@ -466,16 +466,19 @@ module Google
         #   destination bigquery dataset do not match - the request will fail.
         # @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 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://
-        #   bigquery.cloud.google.com/datatransfer/oauthz/auth?redirect_uri=urn:ietf:wg:
-        #   oauth:2.0:oob&response_type=authorization_code&client_id=client_id&scope=
-        #   data_source_scopes * 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.
+        #   Deprecated: Authorization code was required when `transferConfig.dataSourceId`
+        #   is 'youtube_channel' but it is no longer used in any data sources. Use `
+        #   version_info` instead. 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://bigquery.cloud.google.com/datatransfer/oauthz/auth?
+        #   redirect_uri=urn:ietf:wg:oauth:2.0:oob&response_type=authorization_code&
+        #   client_id=client_id&scope=data_source_scopes * The client_id is the OAuth
+        #   client_id of the 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 email. If this field is set, the transfer config will
         #   be created with this service account's credentials. It requires that the
@@ -485,15 +488,17 @@ module Google
         #   about [using service accounts](https://cloud.google.com/bigquery-transfer/docs/
         #   use-service-accounts).
         # @param [String] version_info
-        #   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://bigquery.cloud.google.com/datatransfer/oauthz/auth?
-        #   redirect_uri=urn:ietf:wg:oauth:2.0:oob&response_type=version_info&client_id=
-        #   client_id&scope=data_source_scopes * 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.
+        #   Optional version info. This parameter replaces `authorization_code` which is
+        #   no longer used in any data sources. This is required only if `transferConfig.
+        #   dataSourceId` is 'youtube_channel' *or* new credentials are needed, as
+        #   indicated by `CheckValidCreds`. In order to obtain version info, make a
+        #   request to the following URL: https://bigquery.cloud.google.com/datatransfer/
+        #   oauthz/auth?redirect_uri=urn:ietf:wg:oauth:2.0:oob&response_type=version_info&
+        #   client_id=client_id&scope=data_source_scopes * The client_id is the OAuth
+        #   client_id of the 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
@@ -646,16 +651,19 @@ 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.
-        #   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://
-        #   bigquery.cloud.google.com/datatransfer/oauthz/auth?redirect_uri=urn:ietf:wg:
-        #   oauth:2.0:oob&response_type=authorization_code&client_id=client_id&scope=
-        #   data_source_scopes * 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.
+        #   Deprecated: Authorization code was required when `transferConfig.dataSourceId`
+        #   is 'youtube_channel' but it is no longer used in any data sources. Use `
+        #   version_info` instead. 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://bigquery.cloud.google.com/datatransfer/oauthz/auth?
+        #   redirect_uri=urn:ietf:wg:oauth:2.0:oob&response_type=authorization_code&
+        #   client_id=client_id&scope=data_source_scopes * The client_id is the OAuth
+        #   client_id of the 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 email. If this field is set, the transfer config will
         #   be created with this service account's credentials. It requires that the
@@ -667,15 +675,17 @@ module Google
         # @param [String] update_mask
         #   Required. Required list of fields to be updated in this request.
         # @param [String] version_info
-        #   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://bigquery.cloud.google.com/datatransfer/oauthz/auth?
-        #   redirect_uri=urn:ietf:wg:oauth:2.0:oob&response_type=version_info&client_id=
-        #   client_id&scope=data_source_scopes * 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.
+        #   Optional version info. This parameter replaces `authorization_code` which is
+        #   no longer used in any data sources. This is required only if `transferConfig.
+        #   dataSourceId` is 'youtube_channel' *or* new credentials are needed, as
+        #   indicated by `CheckValidCreds`. In order to obtain version info, make a
+        #   request to the following URL: https://bigquery.cloud.google.com/datatransfer/
+        #   oauthz/auth?redirect_uri=urn:ietf:wg:oauth:2.0:oob&response_type=version_info&
+        #   client_id=client_id&scope=data_source_scopes * The client_id is the OAuth
+        #   client_id of the 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
@@ -950,16 +960,19 @@ module Google
         #   destination bigquery dataset do not match - the request will fail.
         # @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 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://
-        #   bigquery.cloud.google.com/datatransfer/oauthz/auth?redirect_uri=urn:ietf:wg:
-        #   oauth:2.0:oob&response_type=authorization_code&client_id=client_id&scope=
-        #   data_source_scopes * 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.
+        #   Deprecated: Authorization code was required when `transferConfig.dataSourceId`
+        #   is 'youtube_channel' but it is no longer used in any data sources. Use `
+        #   version_info` instead. 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://bigquery.cloud.google.com/datatransfer/oauthz/auth?
+        #   redirect_uri=urn:ietf:wg:oauth:2.0:oob&response_type=authorization_code&
+        #   client_id=client_id&scope=data_source_scopes * The client_id is the OAuth
+        #   client_id of the 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 email. If this field is set, the transfer config will
         #   be created with this service account's credentials. It requires that the
@@ -969,15 +982,17 @@ module Google
         #   about [using service accounts](https://cloud.google.com/bigquery-transfer/docs/
         #   use-service-accounts).
         # @param [String] version_info
-        #   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://bigquery.cloud.google.com/datatransfer/oauthz/auth?
-        #   redirect_uri=urn:ietf:wg:oauth:2.0:oob&response_type=version_info&client_id=
-        #   client_id&scope=data_source_scopes * 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.
+        #   Optional version info. This parameter replaces `authorization_code` which is
+        #   no longer used in any data sources. This is required only if `transferConfig.
+        #   dataSourceId` is 'youtube_channel' *or* new credentials are needed, as
+        #   indicated by `CheckValidCreds`. In order to obtain version info, make a
+        #   request to the following URL: https://bigquery.cloud.google.com/datatransfer/
+        #   oauthz/auth?redirect_uri=urn:ietf:wg:oauth:2.0:oob&response_type=version_info&
+        #   client_id=client_id&scope=data_source_scopes * The client_id is the OAuth
+        #   client_id of the 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
@@ -1130,16 +1145,19 @@ 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.
-        #   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://
-        #   bigquery.cloud.google.com/datatransfer/oauthz/auth?redirect_uri=urn:ietf:wg:
-        #   oauth:2.0:oob&response_type=authorization_code&client_id=client_id&scope=
-        #   data_source_scopes * 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.
+        #   Deprecated: Authorization code was required when `transferConfig.dataSourceId`
+        #   is 'youtube_channel' but it is no longer used in any data sources. Use `
+        #   version_info` instead. 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://bigquery.cloud.google.com/datatransfer/oauthz/auth?
+        #   redirect_uri=urn:ietf:wg:oauth:2.0:oob&response_type=authorization_code&
+        #   client_id=client_id&scope=data_source_scopes * The client_id is the OAuth
+        #   client_id of the 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 email. If this field is set, the transfer config will
         #   be created with this service account's credentials. It requires that the
@@ -1151,15 +1169,17 @@ module Google
         # @param [String] update_mask
         #   Required. Required list of fields to be updated in this request.
         # @param [String] version_info
-        #   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://bigquery.cloud.google.com/datatransfer/oauthz/auth?
-        #   redirect_uri=urn:ietf:wg:oauth:2.0:oob&response_type=version_info&client_id=
-        #   client_id&scope=data_source_scopes * 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.
+        #   Optional version info. This parameter replaces `authorization_code` which is
+        #   no longer used in any data sources. This is required only if `transferConfig.
+        #   dataSourceId` is 'youtube_channel' *or* new credentials are needed, as
+        #   indicated by `CheckValidCreds`. In order to obtain version info, make a
+        #   request to the following URL: https://bigquery.cloud.google.com/datatransfer/
+        #   oauthz/auth?redirect_uri=urn:ietf:wg:oauth:2.0:oob&response_type=version_info&
+        #   client_id=client_id&scope=data_source_scopes * The client_id is the OAuth
+        #   client_id of the 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.41.0
+  version: 0.43.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-05-19 00:00:00.000000000 Z
+date: 2024-09-22 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.41.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-bigquerydatatransfer_v1/v0.43.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-bigquerydatatransfer_v1
 post_install_message: 
 rdoc_options: []