google-apis-bigquerydatatransfer_v1 0.10.0 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9122cfefb8d4c2d0dd97c8cffa9d82c9973cb72781086b5668e557c4fc8e44e8
-  data.tar.gz: 7b2e943be7a95af45c0a42195471ce94240db0dd0d27b258f699477446c4fb79
+  metadata.gz: ec38191126baecd824d4cd399240762e6599fad8a10e0251342d6ab3e5bfd09f
+  data.tar.gz: 7a38a8e0fef8d5dbab8044e13a9a7e0a7aa1247d6ec0afb69ed5ee399b9a6205
 SHA512:
-  metadata.gz: ee49e0b0a38e426422ef28cd2148f7431def9b4e58ea728a3428b246ad518f545750ef8c9acf1752e6504cb3091c06f6708a97ac0418ea8d57e0f908e5898c57
-  data.tar.gz: 8cc50448429a6d13ce0aaaccf42060a02fc5fc6228657fc8fcb7a5ce371a66c6e25b8161c8f4186cd61f5d005bc0afcec2c4598c925a46256e50f22e915706be
+  metadata.gz: 38e74a508972010789416e984b1585198780670cbf6cab46c9a1d2d1d8b7a6a82a62179f54946528ef523b8383c63ac84f7f962668a183f4c0376e4e053b8789
+  data.tar.gz: 0ad1a7da0b45d08973f680538382831d38648644c482561591f05e345f91a582076eb14c016a1a93b73b9e49598aae3439aca567218ed1b3c67b5a5ba7cac81c

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Release history for google-apis-bigquerydatatransfer_v1
 
+### v0.14.0 (2021-10-20)
+
+* Unspecified changes
+
+### v0.13.0 (2021-08-27)
+
+* Regenerated from discovery document revision 20210822
+
+### v0.12.0 (2021-08-22)
+
+* Regenerated from discovery document revision 20210814
+
+### v0.11.0 (2021-07-22)
+
+* Regenerated from discovery document revision 20210717
+
 ### v0.10.0 (2021-06-29)
 
 * Regenerated using generator version 0.4.0

data/OVERVIEW.md

@@ -60,8 +60,8 @@ See the class reference docs for information on the methods you can call from a
 
 More detailed descriptions of the Google simple REST clients are available in two documents.
 
- *  The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging.
- *  The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables.
+ *  The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/main/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging.
+ *  The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/main/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables.
 
 (Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Bigquerydatatransfer service in particular.)
 

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

@@ -351,6 +351,27 @@ module Google
         end
       end
       
+      # A request to enroll a set of data sources so they are visible in the BigQuery
+      # UI's `Transfer` tab.
+      class EnrollDataSourcesRequest
+        include Google::Apis::Core::Hashable
+      
+        # Data sources that are enrolled. It is required to provide at least one data
+        # source id.
+        # Corresponds to the JSON property `dataSourceIds`
+        # @return [Array<String>]
+        attr_accessor :data_source_ids
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @data_source_ids = args[:data_source_ids] if args.key?(:data_source_ids)
+        end
+      end
+      
       # Returns list of supported data sources and their metadata.
       class ListDataSourcesResponse
         include Google::Apis::Core::Hashable
@@ -799,11 +820,17 @@ module Google
         attr_accessor :next_run_time
       
         # Pub/Sub topic where notifications will be sent after transfer runs associated
-        # with this transfer config finish.
+        # with this transfer config finish. The format for specifying a pubsub topic is:
+        # `projects/`project`/topics/`topic``
         # Corresponds to the JSON property `notificationPubsubTopic`
         # @return [String]
         attr_accessor :notification_pubsub_topic
       
+        # Information about a user.
+        # Corresponds to the JSON property `ownerInfo`
+        # @return [Google::Apis::BigquerydatatransferV1::UserInfo]
+        attr_accessor :owner_info
+      
         # Parameters specific to each data source. For more information see the bq tab
         # in the 'Setting up a data transfer' section for each data source. For example
         # the parameters for Cloud Storage transfers are listed here: https://cloud.
@@ -860,6 +887,7 @@ module Google
           @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)
+          @owner_info = args[:owner_info] if args.key?(:owner_info)
           @params = args[:params] if args.key?(:params)
           @schedule = args[:schedule] if args.key?(:schedule)
           @schedule_options = args[:schedule_options] if args.key?(:schedule_options)
@@ -943,7 +971,8 @@ module Google
         attr_accessor :name
       
         # Output only. Pub/Sub topic where a notification will be sent after this
-        # transfer run finishes
+        # transfer run finishes. The format for specifying a pubsub topic is: `projects/`
+        # project`/topics/`topic``
         # Corresponds to the JSON property `notificationPubsubTopic`
         # @return [String]
         attr_accessor :notification_pubsub_topic
@@ -1019,6 +1048,25 @@ module Google
           @user_id = args[:user_id] if args.key?(:user_id)
         end
       end
+      
+      # Information about a user.
+      class UserInfo
+        include Google::Apis::Core::Hashable
+      
+        # E-mail address of the user.
+        # Corresponds to the JSON property `email`
+        # @return [String]
+        attr_accessor :email
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @email = args[:email] if args.key?(:email)
+        end
+      end
     end
   end
 end

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.10.0"
+      GEM_VERSION = "0.14.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.4.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20210418"
+      REVISION = "20210822"
     end
   end
 end

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

@@ -58,6 +58,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class EnrollDataSourcesRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ListDataSourcesResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -154,6 +160,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class UserInfo
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class CheckValidCredsRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -228,6 +240,13 @@ module Google
         end
       end
       
+      class EnrollDataSourcesRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :data_source_ids, as: 'dataSourceIds'
+        end
+      end
+      
       class ListDataSourcesResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -357,6 +376,8 @@ module Google
           property :name, as: 'name'
           property :next_run_time, as: 'nextRunTime'
           property :notification_pubsub_topic, as: 'notificationPubsubTopic'
+          property :owner_info, as: 'ownerInfo', class: Google::Apis::BigquerydatatransferV1::UserInfo, decorator: Google::Apis::BigquerydatatransferV1::UserInfo::Representation
+      
           hash :params, as: 'params'
           property :schedule, as: 'schedule'
           property :schedule_options, as: 'scheduleOptions', class: Google::Apis::BigquerydatatransferV1::ScheduleOptions, decorator: Google::Apis::BigquerydatatransferV1::ScheduleOptions::Representation
@@ -398,6 +419,13 @@ module Google
           property :user_id, :numeric_string => true, as: 'userId'
         end
       end
+      
+      class UserInfo
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :email, as: 'email'
+        end
+      end
     end
   end
 end

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

@@ -50,6 +50,44 @@ module Google
           @batch_path = 'batch'
         end
         
+        # 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).
+        # @param [String] name
+        #   The name of the project resource in the form: `projects/`project_id``
+        # @param [Google::Apis::BigquerydatatransferV1::EnrollDataSourcesRequest] enroll_data_sources_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::BigquerydatatransferV1::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::BigquerydatatransferV1::Empty]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def enroll_project_data_sources(name, enroll_data_sources_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:enrollDataSources', options)
+          command.request_representation = Google::Apis::BigquerydatatransferV1::EnrollDataSourcesRequest::Representation
+          command.request_object = enroll_data_sources_request_object
+          command.response_representation = Google::Apis::BigquerydatatransferV1::Empty::Representation
+          command.response_class = Google::Apis::BigquerydatatransferV1::Empty
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Returns true if valid credentials exist for the given data source and
         # requesting user. Some data sources doesn't support service account, so we need
         # to talk to them on behalf of the end user. This API just checks whether we
@@ -164,6 +202,44 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # 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).
+        # @param [String] name
+        #   The name of the project resource in the form: `projects/`project_id``
+        # @param [Google::Apis::BigquerydatatransferV1::EnrollDataSourcesRequest] enroll_data_sources_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::BigquerydatatransferV1::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::BigquerydatatransferV1::Empty]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def enroll_location_data_sources(name, enroll_data_sources_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:enrollDataSources', options)
+          command.request_representation = Google::Apis::BigquerydatatransferV1::EnrollDataSourcesRequest::Representation
+          command.request_object = enroll_data_sources_request_object
+          command.response_representation = Google::Apis::BigquerydatatransferV1::Empty::Representation
+          command.response_class = Google::Apis::BigquerydatatransferV1::Empty
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Gets information about a location.
         # @param [String] name
         #   Resource name for the location.
@@ -478,7 +554,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns information about all data transfers in the project.
+        # Returns information about all transfer configs owned by a project in the
+        # specified location.
         # @param [String] parent
         #   Required. The BigQuery project id for which data sources should be returned: `
         #   projects/`project_id`` or `projects/`project_id`/locations/`location_id``
@@ -948,7 +1025,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns information about all data transfers in the project.
+        # Returns information about all transfer configs owned by a project in the
+        # specified location.
         # @param [String] parent
         #   Required. The BigQuery project id for which data sources should be returned: `
         #   projects/`project_id`` or `projects/`project_id`/locations/`location_id``

data/lib/google/apis/bigquerydatatransfer_v1.rb

@@ -30,13 +30,13 @@ module Google
       # This is NOT the gem version.
       VERSION = 'V1'
 
-      # View and manage your data in Google BigQuery
+      # View and manage your data in Google BigQuery and see the email address for your Google Account
       AUTH_BIGQUERY = 'https://www.googleapis.com/auth/bigquery'
 
-      # See, edit, configure, and delete your Google Cloud Platform data
+      # See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account.
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
 
-      # View your data across Google Cloud Platform services
+      # View your data across Google Cloud services and see the email address of your Google Account
       AUTH_CLOUD_PLATFORM_READ_ONLY = 'https://www.googleapis.com/auth/cloud-platform.read-only'
     end
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-bigquerydatatransfer_v1
 version: !ruby/object:Gem::Version
-  version: 0.10.0
+  version: 0.14.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-07-05 00:00:00.000000000 Z
+date: 2021-10-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -57,9 +57,9 @@ licenses:
 - Apache-2.0
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
-  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-bigquerydatatransfer_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-bigquerydatatransfer_v1/v0.10.0
-  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-bigquerydatatransfer_v1
+  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.14.0
+  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-bigquerydatatransfer_v1
 post_install_message: 
 rdoc_options: []
 require_paths: