google-cloud-bigquery-data_transfer 0.2.5 → 0.3.0

data/lib/google/cloud/bigquery/datatransfer/v1/datasource_services_pb.rb

@@ -0,0 +1,103 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: google/cloud/bigquery/datatransfer/v1/datasource.proto for package 'google.cloud.bigquery.datatransfer.v1'
+# Original file comments:
+# Copyright 2019 Google LLC.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+#
+
+
+require 'grpc'
+require 'google/cloud/bigquery/datatransfer/v1/datasource_pb'
+
+module Google
+  module Cloud
+    module Bigquery
+      module Datatransfer
+        module V1
+          module DataSourceService
+            # The Google BigQuery Data Transfer API allows BigQuery users to
+            # configure transfer of their data from other Google Products into BigQuery.
+            # This service exposes methods that should be used by data source backend.
+            class Service
+
+              include GRPC::GenericService
+
+              self.marshal_class_method = :encode
+              self.unmarshal_class_method = :decode
+              self.service_name = 'google.cloud.bigquery.datatransfer.v1.DataSourceService'
+
+              # Update a transfer run. If successful, resets
+              # data_source.update_deadline_seconds timer.
+              rpc :UpdateTransferRun, UpdateTransferRunRequest, TransferRun
+              # Log messages for a transfer run. If successful (at least 1 message), resets
+              # data_source.update_deadline_seconds timer.
+              rpc :LogTransferRunMessages, LogTransferRunMessagesRequest, Google::Protobuf::Empty
+              # Notify the Data Transfer Service that data is ready for loading.
+              # The Data Transfer Service will start and monitor multiple BigQuery Load
+              # jobs for a transfer run. Monitored jobs will be automatically retried
+              # and produce log messages when starting and finishing a job.
+              # Can be called multiple times for the same transfer run.
+              rpc :StartBigQueryJobs, StartBigQueryJobsRequest, Google::Protobuf::Empty
+              # Notify the Data Transfer Service that the data source is done processing
+              # the run. No more status updates or requests to start/monitor jobs will be
+              # accepted. The run will be finalized by the Data Transfer Service when all
+              # monitored jobs are completed.
+              # Does not need to be called if the run is set to FAILED.
+              rpc :FinishRun, FinishRunRequest, Google::Protobuf::Empty
+              # Creates a data source definition.  Calling this method will automatically
+              # use your credentials to create the following Google Cloud resources in
+              # YOUR Google Cloud project.
+              # 1. OAuth client
+              # 2. Pub/Sub Topics and Subscriptions in each supported_location_ids. e.g.,
+              # projects/\\{project_id}/{topics|subscriptions}/bigquerydatatransfer.\\{data_source_id}.\\{location_id}.run
+              # The field data_source.client_id should be left empty in the input request,
+              # as the API will create a new OAuth client on behalf of the caller. On the
+              # other hand data_source.scopes usually need to be set when there are OAuth
+              # scopes that need to be granted by end users.
+              # 3. We need a longer deadline due to the 60 seconds SLO from Pub/Sub admin
+              # Operations. This also applies to update and delete data source definition.
+              rpc :CreateDataSourceDefinition, CreateDataSourceDefinitionRequest, DataSourceDefinition
+              # Updates an existing data source definition. If changing
+              # supported_location_ids, triggers same effects as mentioned in "Create a
+              # data source definition."
+              rpc :UpdateDataSourceDefinition, UpdateDataSourceDefinitionRequest, DataSourceDefinition
+              # Deletes a data source definition, all of the transfer configs associated
+              # with this data source definition (if any) must be deleted first by the user
+              # in ALL regions, in order to delete the data source definition.
+              # This method is primarily meant for deleting data sources created during
+              # testing stage.
+              # If the data source is referenced by transfer configs in the region
+              # specified in the request URL, the method will fail immediately. If in the
+              # current region (e.g., US) it's not used by any transfer configs, but in
+              # another region (e.g., EU) it is, then although the method will succeed in
+              # region US, but it will fail when the deletion operation is replicated to
+              # region EU. And eventually, the system will replicate the data source
+              # definition back from EU to US, in order to bring all regions to
+              # consistency. The final effect is that the data source appears to be
+              # 'undeleted' in the US region.
+              rpc :DeleteDataSourceDefinition, DeleteDataSourceDefinitionRequest, Google::Protobuf::Empty
+              # Retrieves an existing data source definition.
+              rpc :GetDataSourceDefinition, GetDataSourceDefinitionRequest, DataSourceDefinition
+              # Lists supported data source definitions.
+              rpc :ListDataSourceDefinitions, ListDataSourceDefinitionsRequest, ListDataSourceDefinitionsResponse
+            end
+
+            Stub = Service.rpc_stub_class
+          end
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/bigquery/datatransfer/v1/datatransfer_pb.rb

@@ -11,6 +11,7 @@ require 'google/protobuf/empty_pb'
 require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/timestamp_pb'
 require 'google/protobuf/wrappers_pb'
+require 'google/api/client_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.cloud.bigquery.datatransfer.v1.DataSourceParameter" do
     optional :param_id, :string, 1
@@ -28,6 +29,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :validation_help_url, :string, 13
     optional :immutable, :bool, 14
     optional :recurse, :bool, 15
+    optional :deprecated, :bool, 20
   end
   add_enum "google.cloud.bigquery.datatransfer.v1.DataSourceParameter.Type" do
     value :TYPE_UNSPECIFIED, 0
@@ -84,11 +86,13 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :parent, :string, 1
     optional :transfer_config, :message, 2, "google.cloud.bigquery.datatransfer.v1.TransferConfig"
     optional :authorization_code, :string, 3
+    optional :version_info, :string, 5
   end
   add_message "google.cloud.bigquery.datatransfer.v1.UpdateTransferConfigRequest" do
     optional :transfer_config, :message, 1, "google.cloud.bigquery.datatransfer.v1.TransferConfig"
     optional :authorization_code, :string, 3
     optional :update_mask, :message, 4, "google.protobuf.FieldMask"
+    optional :version_info, :string, 5
   end
   add_message "google.cloud.bigquery.datatransfer.v1.GetTransferConfigRequest" do
     optional :name, :string, 1
@@ -151,6 +155,20 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.cloud.bigquery.datatransfer.v1.ScheduleTransferRunsResponse" do
     repeated :runs, :message, 1, "google.cloud.bigquery.datatransfer.v1.TransferRun"
   end
+  add_message "google.cloud.bigquery.datatransfer.v1.StartManualTransferRunsRequest" do
+    optional :parent, :string, 1
+    oneof :time do
+      optional :requested_time_range, :message, 3, "google.cloud.bigquery.datatransfer.v1.StartManualTransferRunsRequest.TimeRange"
+      optional :requested_run_time, :message, 4, "google.protobuf.Timestamp"
+    end
+  end
+  add_message "google.cloud.bigquery.datatransfer.v1.StartManualTransferRunsRequest.TimeRange" do
+    optional :start_time, :message, 1, "google.protobuf.Timestamp"
+    optional :end_time, :message, 2, "google.protobuf.Timestamp"
+  end
+  add_message "google.cloud.bigquery.datatransfer.v1.StartManualTransferRunsResponse" do
+    repeated :runs, :message, 1, "google.cloud.bigquery.datatransfer.v1.TransferRun"
+  end
 end
 
 module Google
@@ -183,6 +201,9 @@ module Google
           CheckValidCredsResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.datatransfer.v1.CheckValidCredsResponse").msgclass
           ScheduleTransferRunsRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.datatransfer.v1.ScheduleTransferRunsRequest").msgclass
           ScheduleTransferRunsResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.datatransfer.v1.ScheduleTransferRunsResponse").msgclass
+          StartManualTransferRunsRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.datatransfer.v1.StartManualTransferRunsRequest").msgclass
+          StartManualTransferRunsRequest::TimeRange = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.datatransfer.v1.StartManualTransferRunsRequest.TimeRange").msgclass
+          StartManualTransferRunsResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.datatransfer.v1.StartManualTransferRunsResponse").msgclass
         end
       end
     end

data/lib/google/cloud/bigquery/datatransfer/v1/datatransfer_services_pb.rb

@@ -1,7 +1,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # Source: google/cloud/bigquery/datatransfer/v1/datatransfer.proto for package 'google.cloud.bigquery.datatransfer.v1'
 # Original file comments:
-# Copyright 2018 Google Inc.
+# Copyright 2019 Google LLC.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -15,6 +15,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
+#
 
 
 require 'grpc'
@@ -60,7 +61,13 @@ module Google
               # For each date - or whatever granularity the data source supports - in the
               # range, one transfer run is created.
               # Note that runs are created per UTC time in the time range.
+              # DEPRECATED: use StartManualTransferRuns instead.
               rpc :ScheduleTransferRuns, ScheduleTransferRunsRequest, ScheduleTransferRunsResponse
+              # Start manual transfer runs to be executed now with schedule_time equal to
+              # current time. The transfer runs can be created for a time range where the
+              # run_time is between start_time (inclusive) and end_time (exclusive), or for
+              # a specific run_time.
+              rpc :StartManualTransferRuns, StartManualTransferRunsRequest, StartManualTransferRunsResponse
               # Returns information about the particular transfer run.
               rpc :GetTransferRun, GetTransferRunRequest, TransferRun
               # Deletes the specified transfer run.

data/lib/google/cloud/bigquery/datatransfer/v1/transfer_pb.rb

@@ -9,6 +9,11 @@ require 'google/protobuf/struct_pb'
 require 'google/protobuf/timestamp_pb'
 require 'google/rpc/status_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_message "google.cloud.bigquery.datatransfer.v1.ScheduleOptions" do
+    optional :disable_auto_scheduling, :bool, 3
+    optional :start_time, :message, 1, "google.protobuf.Timestamp"
+    optional :end_time, :message, 2, "google.protobuf.Timestamp"
+  end
   add_message "google.cloud.bigquery.datatransfer.v1.TransferConfig" do
     optional :name, :string, 1
     optional :destination_dataset_id, :string, 2
@@ -16,6 +21,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :data_source_id, :string, 5
     optional :params, :message, 9, "google.protobuf.Struct"
     optional :schedule, :string, 7
+    optional :schedule_options, :message, 24, "google.cloud.bigquery.datatransfer.v1.ScheduleOptions"
     optional :data_refresh_window_days, :int32, 12
     optional :disabled, :bool, 13
     optional :update_time, :message, 4, "google.protobuf.Timestamp"
@@ -70,6 +76,7 @@ module Google
     module Bigquery
       module Datatransfer
         module V1
+          ScheduleOptions = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.datatransfer.v1.ScheduleOptions").msgclass
           TransferConfig = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.datatransfer.v1.TransferConfig").msgclass
           TransferRun = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.datatransfer.v1.TransferRun").msgclass
           TransferMessage = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.datatransfer.v1.TransferMessage").msgclass

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-bigquery-data_transfer
 version: !ruby/object:Gem::Version
-  version: 0.2.5
+  version: 0.3.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-06-13 00:00:00.000000000 Z
+date: 2019-08-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-gax
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: '1.7'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: '1.7'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -115,6 +115,7 @@ files:
 - lib/google/cloud/bigquery/data_transfer/v1/data_transfer_services_pb.rb
 - lib/google/cloud/bigquery/data_transfer/v1/doc/google/cloud/bigquery/data_transfer/v1/data_transfer.rb
 - lib/google/cloud/bigquery/data_transfer/v1/doc/google/cloud/bigquery/data_transfer/v1/transfer.rb
+- lib/google/cloud/bigquery/data_transfer/v1/doc/google/cloud/bigquery/datatransfer/v1/datasource.rb
 - lib/google/cloud/bigquery/data_transfer/v1/doc/google/cloud/bigquery/datatransfer/v1/datatransfer.rb
 - lib/google/cloud/bigquery/data_transfer/v1/doc/google/cloud/bigquery/datatransfer/v1/transfer.rb
 - lib/google/cloud/bigquery/data_transfer/v1/doc/google/protobuf/any.rb
@@ -127,6 +128,8 @@ files:
 - lib/google/cloud/bigquery/data_transfer/v1/doc/google/rpc/status.rb
 - lib/google/cloud/bigquery/data_transfer/v1/transfer_pb.rb
 - lib/google/cloud/bigquery/data_transfer/version.rb
+- lib/google/cloud/bigquery/datatransfer/v1/datasource_pb.rb
+- lib/google/cloud/bigquery/datatransfer/v1/datasource_services_pb.rb
 - lib/google/cloud/bigquery/datatransfer/v1/datatransfer_pb.rb
 - lib/google/cloud/bigquery/datatransfer/v1/datatransfer_services_pb.rb
 - lib/google/cloud/bigquery/datatransfer/v1/transfer_pb.rb
@@ -149,7 +152,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.0.4
 signing_key: 
 specification_version: 4
 summary: API Client library for BigQuery Data Transfer API