google-cloud-bigquery-data_transfer 0.2.3 → 0.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 657a3f3f47798f10e04643f1b87cfee8fcb1eb32b9ad0f60de1692efb20b12c6
-  data.tar.gz: 78517e940938cee138dd28078d96f0989f19890a6a4156e570d2741bf21c3fbc
+  metadata.gz: dc8f0001f8d494c4c0caa52faa1365faf4eac9f526284a1ce5dad1d371714cbb
+  data.tar.gz: 65389fd9f60a871f1f1e89d703d425d3d8ed732bd2d561be2da56cf803d98389
 SHA512:
-  metadata.gz: 61e1693d79ad694f24b4bf79b911ee6175947e2fdf69812354ae4011309168430634949839be8aa71224b60ffbe5ecc313839ce0bf5edfb05734fdc35d9ff450
-  data.tar.gz: 1de3b9a686d0a7d445e92b9da24268d3ec51e845b4a26c835f0618af25c7b83d5f0d6a2a08cd9815cf9d8bc9927109aeecad8dc45f0644129cdaecf257a77310
+  metadata.gz: 0147e39b896cd0d646b661480303fbae70d2b6de5b39b1509a167712155b139cff4b44cf339d11a0c242bc5d8f625b219dedeae78d3c03b33822e26fa1a49d7f
+  data.tar.gz: 8061c0b0292be433bc6455327c0c9c9fec477dc9f21c850ad1c50586c25de1a2b3efbbaed7642fb434937fc9d002c0c34a48f125c65cfbff95b24b2c7f15a074

data/.yardopts

@@ -7,3 +7,5 @@
 ./lib/**/*.rb
 -
 README.md
+AUTHENTICATION.md
+LICENSE

data/AUTHENTICATION.md

@@ -0,0 +1,199 @@
+# Authentication
+
+In general, the google-cloud-bigquery-data_transfer library uses [Service
+Account](https://cloud.google.com/iam/docs/creating-managing-service-accounts)
+credentials to connect to Google Cloud services. When running within [Google
+Cloud Platform environments](#google-cloud-platform-environments)
+the credentials will be discovered automatically. When running on other
+environments, the Service Account credentials can be specified by providing the
+path to the [JSON
+keyfile](https://cloud.google.com/iam/docs/managing-service-account-keys) for
+the account (or the JSON itself) in [environment
+variables](#environment-variables). Additionally, Cloud SDK credentials can also
+be discovered automatically, but this is only recommended during development.
+
+## Quickstart
+
+1. [Create a service account and credentials](#creating-a-service-account).
+2. Set the [environment variable](#environment-variables).
+
+```sh
+export DATA_TRANSFER_CREDENTIALS=/path/to/json`
+```
+
+3. Initialize the client.
+
+```ruby
+require "google/cloud/bigquery/data_transfer"
+
+client = Google::Cloud::Bigquery::DataTransfer.new
+```
+
+## Project and Credential Lookup
+
+The google-cloud-bigquery-data_transfer library aims to make authentication
+as simple as possible, and provides several mechanisms to configure your system
+without providing **Project ID** and **Service Account Credentials** directly in
+code.
+
+**Project ID** is discovered in the following order:
+
+1. Specify project ID in method arguments
+2. Specify project ID in configuration
+3. Discover project ID in environment variables
+4. Discover GCE project ID
+5. Discover project ID in credentials JSON
+
+**Credentials** are discovered in the following order:
+
+1. Specify credentials in method arguments
+2. Specify credentials in configuration
+3. Discover credentials path in environment variables
+4. Discover credentials JSON in environment variables
+5. Discover credentials file in the Cloud SDK's path
+6. Discover GCE credentials
+
+### Google Cloud Platform environments
+
+While running on Google Cloud Platform environments such as Google Compute
+Engine, Google App Engine and Google Kubernetes Engine, no extra work is needed.
+The **Project ID** and **Credentials** and are discovered automatically. Code
+should be written as if already authenticated. Just be sure when you [set up the
+GCE instance][gce-how-to], you add the correct scopes for the APIs you want to
+access. For example:
+
+  * **All APIs**
+    * `https://www.googleapis.com/auth/cloud-platform`
+    * `https://www.googleapis.com/auth/cloud-platform.read-only`
+  * **BigQuery**
+    * `https://www.googleapis.com/auth/bigquery`
+    * `https://www.googleapis.com/auth/bigquery.insertdata`
+  * **Compute Engine**
+    * `https://www.googleapis.com/auth/compute`
+  * **Datastore**
+    * `https://www.googleapis.com/auth/datastore`
+    * `https://www.googleapis.com/auth/userinfo.email`
+  * **DNS**
+    * `https://www.googleapis.com/auth/ndev.clouddns.readwrite`
+  * **Pub/Sub**
+    * `https://www.googleapis.com/auth/pubsub`
+  * **Storage**
+    * `https://www.googleapis.com/auth/devstorage.full_control`
+    * `https://www.googleapis.com/auth/devstorage.read_only`
+    * `https://www.googleapis.com/auth/devstorage.read_write`
+
+### Environment Variables
+
+The **Project ID** and **Credentials JSON** can be placed in environment
+variables instead of declaring them directly in code. Each service has its own
+environment variable, allowing for different service accounts to be used for
+different services. (See the READMEs for the individual service gems for
+details.) The path to the **Credentials JSON** file can be stored in the
+environment variable, or the **Credentials JSON** itself can be stored for
+environments such as Docker containers where writing files is difficult or not
+encouraged.
+
+The environment variables that google-cloud-bigquery-data_transfer checks for project ID are:
+
+1. `DATA_TRANSFER_PROJECT`
+2. `GOOGLE_CLOUD_PROJECT`
+
+The environment variables that google-cloud-bigquery-data_transfer checks for credentials are configured on {Google::Cloud::Bigquery::DataTransfer::V1::Credentials}:
+
+1. `DATA_TRANSFER_CREDENTIALS` - Path to JSON file, or JSON contents
+2. `DATA_TRANSFER_KEYFILE` - Path to JSON file, or JSON contents
+3. `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
+4. `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
+5. `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
+
+```ruby
+require "google/cloud/bigquery/data_transfer"
+
+ENV["DATA_TRANSFER_PROJECT"]     = "my-project-id"
+ENV["DATA_TRANSFER_CREDENTIALS"] = "path/to/keyfile.json"
+
+client = Google::Cloud::Bigquery::DataTransfer.new
+```
+
+### Configuration
+
+The **Project ID** and **Credentials JSON** can be configured instead of placing them in environment variables or providing them as arguments.
+
+```ruby
+require "google/cloud/bigquery/data_transfer"
+
+Google::Cloud::Bigquery::DataTransfer.configure do |config|
+  config.project_id  = "my-project-id"
+  config.credentials = "path/to/keyfile.json"
+end
+
+client = Google::Cloud::Bigquery::DataTransfer.new
+```
+
+### Cloud SDK
+
+This option allows for an easy way to authenticate during development. If
+credentials are not provided in code or in environment variables, then Cloud SDK
+credentials are discovered.
+
+To configure your system for this, simply:
+
+1. [Download and install the Cloud SDK](https://cloud.google.com/sdk)
+2. Authenticate using OAuth 2.0 `$ gcloud auth login`
+3. Write code as if already authenticated.
+
+**NOTE:** This is _not_ recommended for running in production. The Cloud SDK
+*should* only be used during development.
+
+[gce-how-to]: https://cloud.google.com/compute/docs/authentication#using
+[dev-console]: https://console.cloud.google.com/project
+
+[enable-apis]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/enable-apis.png
+
+[create-new-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account.png
+[create-new-service-account-existing-keys]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account-existing-keys.png
+[reuse-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/reuse-service-account.png
+
+## Creating a Service Account
+
+Google Cloud requires a **Project ID** and **Service Account Credentials** to
+connect to the APIs. You will use the **Project ID** and **JSON key file** to
+connect to most services with google-cloud-bigquery-data_transfer.
+
+If you are not running this client within [Google Cloud Platform
+environments](#google-cloud-platform-environments), you need a Google
+Developers service account.
+
+1. Visit the [Google Developers Console][dev-console].
+1. Create a new project or click on an existing project.
+1. Activate the slide-out navigation tray and select **API Manager**. From
+   here, you will enable the APIs that your application requires.
+
+   ![Enable the APIs that your application requires][enable-apis]
+
+   *Note: You may need to enable billing in order to use these services.*
+
+1. Select **Credentials** from the side navigation.
+
+   You should see a screen like one of the following.
+
+   ![Create a new service account][create-new-service-account]
+
+   ![Create a new service account With Existing Keys][create-new-service-account-existing-keys]
+
+   Find the "Add credentials" drop down and select "Service account" to be
+   guided through downloading a new JSON key file.
+
+   If you want to re-use an existing service account, you can easily generate a
+   new key file. Just select the account you wish to re-use, and click "Generate
+   new JSON key":
+
+   ![Re-use an existing service account][reuse-service-account]
+
+   The key file you download will be used by this library to authenticate API
+   requests and should be stored in a secure location.
+
+## Troubleshooting
+
+If you're having trouble authenticating you can ask for help by following the
+{file:TROUBLESHOOTING.md Troubleshooting Guide}.

data/README.md

@@ -25,16 +25,16 @@ $ gem install google-cloud-bigquery-data_transfer
 ```rb
 require "google/cloud/bigquery/data_transfer"
 
-data_transfer_service_client = Google::Cloud::Bigquery::DataTransfer.new
+data_transfer_client = Google::Cloud::Bigquery::DataTransfer.new
 formatted_parent = Google::Cloud::Bigquery::DataTransfer::V1::DataTransferServiceClient.project_path(project_id)
 
 # Iterate over all results.
-data_transfer_service_client.list_data_sources(formatted_parent).each do |element|
+data_transfer_client.list_data_sources(formatted_parent).each do |element|
   # Process element.
 end
 
 # Or iterate over results one page at a time.
-data_transfer_service_client.list_data_sources(formatted_parent).each_page do |page|
+data_transfer_client.list_data_sources(formatted_parent).each_page do |page|
   # Process each page at a time.
   page.each do |element|
     # Process element.

data/lib/google/cloud/bigquery/data_transfer.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# 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.
@@ -48,16 +48,16 @@ module Google
       # ```rb
       # require "google/cloud/bigquery/data_transfer"
       #
-      # data_transfer_service_client = Google::Cloud::Bigquery::DataTransfer.new
+      # data_transfer_client = Google::Cloud::Bigquery::DataTransfer.new
       # formatted_parent = Google::Cloud::Bigquery::DataTransfer::V1::DataTransferServiceClient.project_path(project_id)
       #
       # # Iterate over all results.
-      # data_transfer_service_client.list_data_sources(formatted_parent).each do |element|
+      # data_transfer_client.list_data_sources(formatted_parent).each do |element|
       #   # Process element.
       # end
       #
       # # Or iterate over results one page at a time.
-      # data_transfer_service_client.list_data_sources(formatted_parent).each_page do |page|
+      # data_transfer_client.list_data_sources(formatted_parent).each_page do |page|
       #   # Process each page at a time.
       #   page.each do |element|
       #     # Process element.
@@ -112,9 +112,9 @@ module Google
 
         ##
         # The Google BigQuery Data Transfer Service API enables BigQuery users to
-        # configure the transfer of their data from other Google Products into BigQuery.
-        # This service contains methods that are end user exposed. It backs up the
-        # frontend.
+        # configure the transfer of their data from other Google Products into
+        # BigQuery. This service contains methods that are end user exposed. It backs
+        # up the frontend.
         #
         # @param version [Symbol, String]
         #   The major version of the service to be used. By default :v1

data/lib/google/cloud/bigquery/data_transfer/v1.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# 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.
@@ -48,16 +48,16 @@ module Google
         # ```rb
         # require "google/cloud/bigquery/data_transfer"
         #
-        # data_transfer_service_client = Google::Cloud::Bigquery::DataTransfer.new(version: :v1)
+        # data_transfer_client = Google::Cloud::Bigquery::DataTransfer.new(version: :v1)
         # formatted_parent = Google::Cloud::Bigquery::DataTransfer::V1::DataTransferServiceClient.project_path(project_id)
         #
         # # Iterate over all results.
-        # data_transfer_service_client.list_data_sources(formatted_parent).each do |element|
+        # data_transfer_client.list_data_sources(formatted_parent).each do |element|
         #   # Process element.
         # end
         #
         # # Or iterate over results one page at a time.
-        # data_transfer_service_client.list_data_sources(formatted_parent).each_page do |page|
+        # data_transfer_client.list_data_sources(formatted_parent).each_page do |page|
         #   # Process each page at a time.
         #   page.each do |element|
         #     # Process element.
@@ -104,9 +104,9 @@ module Google
 
           ##
           # The Google BigQuery Data Transfer Service API enables BigQuery users to
-          # configure the transfer of their data from other Google Products into BigQuery.
-          # This service contains methods that are end user exposed. It backs up the
-          # frontend.
+          # configure the transfer of their data from other Google Products into
+          # BigQuery. This service contains methods that are end user exposed. It backs
+          # up the frontend.
           #
           # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
           #   Provides the means for authenticating requests made by the client. This parameter can

data/lib/google/cloud/bigquery/data_transfer/v1/credentials.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# 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.

data/lib/google/cloud/bigquery/data_transfer/v1/data_transfer_service_client.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# 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.
@@ -34,9 +34,9 @@ module Google
       module DataTransfer
         module V1
           # The Google BigQuery Data Transfer Service API enables BigQuery users to
-          # configure the transfer of their data from other Google Products into BigQuery.
-          # This service contains methods that are end user exposed. It backs up the
-          # frontend.
+          # configure the transfer of their data from other Google Products into
+          # BigQuery. This service contains methods that are end user exposed. It backs
+          # up the frontend.
           #
           # @!attribute [r] data_transfer_service_stub
           #   @return [Google::Cloud::Bigquery::Datatransfer::V1::DataTransferService::Stub]
@@ -83,23 +83,17 @@ module Google
             ].freeze
 
 
-            PROJECT_DATA_SOURCE_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
-              "projects/{project}/dataSources/{data_source}"
-            )
-
-            private_constant :PROJECT_DATA_SOURCE_PATH_TEMPLATE
-
             PROJECT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
               "projects/{project}"
             )
 
             private_constant :PROJECT_PATH_TEMPLATE
 
-            PROJECT_TRANSFER_CONFIG_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
-              "projects/{project}/transferConfigs/{transfer_config}"
+            PROJECT_DATA_SOURCE_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
+              "projects/{project}/dataSources/{data_source}"
             )
 
-            private_constant :PROJECT_TRANSFER_CONFIG_PATH_TEMPLATE
+            private_constant :PROJECT_DATA_SOURCE_PATH_TEMPLATE
 
             PROJECT_RUN_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
               "projects/{project}/transferConfigs/{transfer_config}/runs/{run}"
@@ -107,16 +101,11 @@ module Google
 
             private_constant :PROJECT_RUN_PATH_TEMPLATE
 
-            # Returns a fully-qualified project_data_source resource name string.
-            # @param project [String]
-            # @param data_source [String]
-            # @return [String]
-            def self.project_data_source_path project, data_source
-              PROJECT_DATA_SOURCE_PATH_TEMPLATE.render(
-                :"project" => project,
-                :"data_source" => data_source
-              )
-            end
+            PROJECT_TRANSFER_CONFIG_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
+              "projects/{project}/transferConfigs/{transfer_config}"
+            )
+
+            private_constant :PROJECT_TRANSFER_CONFIG_PATH_TEMPLATE
 
             # Returns a fully-qualified project resource name string.
             # @param project [String]
@@ -127,14 +116,14 @@ module Google
               )
             end
 
-            # Returns a fully-qualified project_transfer_config resource name string.
+            # Returns a fully-qualified project_data_source resource name string.
             # @param project [String]
-            # @param transfer_config [String]
+            # @param data_source [String]
             # @return [String]
-            def self.project_transfer_config_path project, transfer_config
-              PROJECT_TRANSFER_CONFIG_PATH_TEMPLATE.render(
+            def self.project_data_source_path project, data_source
+              PROJECT_DATA_SOURCE_PATH_TEMPLATE.render(
                 :"project" => project,
-                :"transfer_config" => transfer_config
+                :"data_source" => data_source
               )
             end
 
@@ -151,6 +140,17 @@ module Google
               )
             end
 
+            # Returns a fully-qualified project_transfer_config resource name string.
+            # @param project [String]
+            # @param transfer_config [String]
+            # @return [String]
+            def self.project_transfer_config_path project, transfer_config
+              PROJECT_TRANSFER_CONFIG_PATH_TEMPLATE.render(
+                :"project" => project,
+                :"transfer_config" => transfer_config
+              )
+            end
+
             # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
             #   Provides the means for authenticating requests made by the client. This parameter can
             #   be many types.
@@ -379,9 +379,9 @@ module Google
             # @example
             #   require "google/cloud/bigquery/data_transfer"
             #
-            #   data_transfer_service_client = Google::Cloud::Bigquery::DataTransfer.new(version: :v1)
+            #   data_transfer_client = Google::Cloud::Bigquery::DataTransfer.new(version: :v1)
             #   formatted_name = Google::Cloud::Bigquery::DataTransfer::V1::DataTransferServiceClient.project_data_source_path("[PROJECT]", "[DATA_SOURCE]")
-            #   response = data_transfer_service_client.get_data_source(formatted_name)
+            #   response = data_transfer_client.get_data_source(formatted_name)
 
             def get_data_source \
                 name,
@@ -421,16 +421,16 @@ module Google
             # @example
             #   require "google/cloud/bigquery/data_transfer"
             #
-            #   data_transfer_service_client = Google::Cloud::Bigquery::DataTransfer.new(version: :v1)
+            #   data_transfer_client = Google::Cloud::Bigquery::DataTransfer.new(version: :v1)
             #   formatted_parent = Google::Cloud::Bigquery::DataTransfer::V1::DataTransferServiceClient.project_path("[PROJECT]")
             #
             #   # Iterate over all results.
-            #   data_transfer_service_client.list_data_sources(formatted_parent).each do |element|
+            #   data_transfer_client.list_data_sources(formatted_parent).each do |element|
             #     # Process element.
             #   end
             #
             #   # Or iterate over results one page at a time.
-            #   data_transfer_service_client.list_data_sources(formatted_parent).each_page do |page|
+            #   data_transfer_client.list_data_sources(formatted_parent).each_page do |page|
             #     # Process each page at a time.
             #     page.each do |element|
             #       # Process element.
@@ -489,12 +489,12 @@ module Google
             # @example
             #   require "google/cloud/bigquery/data_transfer"
             #
-            #   data_transfer_service_client = Google::Cloud::Bigquery::DataTransfer.new(version: :v1)
+            #   data_transfer_client = Google::Cloud::Bigquery::DataTransfer.new(version: :v1)
             #   formatted_parent = Google::Cloud::Bigquery::DataTransfer::V1::DataTransferServiceClient.project_path("[PROJECT]")
             #
             #   # TODO: Initialize `transfer_config`:
             #   transfer_config = {}
-            #   response = data_transfer_service_client.create_transfer_config(formatted_parent, transfer_config)
+            #   response = data_transfer_client.create_transfer_config(formatted_parent, transfer_config)
 
             def create_transfer_config \
                 parent,
@@ -550,14 +550,14 @@ module Google
             # @example
             #   require "google/cloud/bigquery/data_transfer"
             #
-            #   data_transfer_service_client = Google::Cloud::Bigquery::DataTransfer.new(version: :v1)
+            #   data_transfer_client = Google::Cloud::Bigquery::DataTransfer.new(version: :v1)
             #
             #   # TODO: Initialize `transfer_config`:
             #   transfer_config = {}
             #
             #   # TODO: Initialize `update_mask`:
             #   update_mask = {}
-            #   response = data_transfer_service_client.update_transfer_config(transfer_config, update_mask)
+            #   response = data_transfer_client.update_transfer_config(transfer_config, update_mask)
 
             def update_transfer_config \
                 transfer_config,
@@ -590,9 +590,9 @@ module Google
             # @example
             #   require "google/cloud/bigquery/data_transfer"
             #
-            #   data_transfer_service_client = Google::Cloud::Bigquery::DataTransfer.new(version: :v1)
+            #   data_transfer_client = Google::Cloud::Bigquery::DataTransfer.new(version: :v1)
             #   formatted_name = Google::Cloud::Bigquery::DataTransfer::V1::DataTransferServiceClient.project_transfer_config_path("[PROJECT]", "[TRANSFER_CONFIG]")
-            #   data_transfer_service_client.delete_transfer_config(formatted_name)
+            #   data_transfer_client.delete_transfer_config(formatted_name)
 
             def delete_transfer_config \
                 name,
@@ -622,9 +622,9 @@ module Google
             # @example
             #   require "google/cloud/bigquery/data_transfer"
             #
-            #   data_transfer_service_client = Google::Cloud::Bigquery::DataTransfer.new(version: :v1)
+            #   data_transfer_client = Google::Cloud::Bigquery::DataTransfer.new(version: :v1)
             #   formatted_name = Google::Cloud::Bigquery::DataTransfer::V1::DataTransferServiceClient.project_transfer_config_path("[PROJECT]", "[TRANSFER_CONFIG]")
-            #   response = data_transfer_service_client.get_transfer_config(formatted_name)
+            #   response = data_transfer_client.get_transfer_config(formatted_name)
 
             def get_transfer_config \
                 name,
@@ -665,16 +665,16 @@ module Google
             # @example
             #   require "google/cloud/bigquery/data_transfer"
             #
-            #   data_transfer_service_client = Google::Cloud::Bigquery::DataTransfer.new(version: :v1)
+            #   data_transfer_client = Google::Cloud::Bigquery::DataTransfer.new(version: :v1)
             #   formatted_parent = Google::Cloud::Bigquery::DataTransfer::V1::DataTransferServiceClient.project_path("[PROJECT]")
             #
             #   # Iterate over all results.
-            #   data_transfer_service_client.list_transfer_configs(formatted_parent).each do |element|
+            #   data_transfer_client.list_transfer_configs(formatted_parent).each do |element|
             #     # Process element.
             #   end
             #
             #   # Or iterate over results one page at a time.
-            #   data_transfer_service_client.list_transfer_configs(formatted_parent).each_page do |page|
+            #   data_transfer_client.list_transfer_configs(formatted_parent).each_page do |page|
             #     # Process each page at a time.
             #     page.each do |element|
             #       # Process element.
@@ -725,7 +725,7 @@ module Google
             # @example
             #   require "google/cloud/bigquery/data_transfer"
             #
-            #   data_transfer_service_client = Google::Cloud::Bigquery::DataTransfer.new(version: :v1)
+            #   data_transfer_client = Google::Cloud::Bigquery::DataTransfer.new(version: :v1)
             #   formatted_parent = Google::Cloud::Bigquery::DataTransfer::V1::DataTransferServiceClient.project_transfer_config_path("[PROJECT]", "[TRANSFER_CONFIG]")
             #
             #   # TODO: Initialize `start_time`:
@@ -733,7 +733,7 @@ module Google
             #
             #   # TODO: Initialize `end_time`:
             #   end_time = {}
-            #   response = data_transfer_service_client.schedule_transfer_runs(formatted_parent, start_time, end_time)
+            #   response = data_transfer_client.schedule_transfer_runs(formatted_parent, start_time, end_time)
 
             def schedule_transfer_runs \
                 parent,
@@ -766,9 +766,9 @@ module Google
             # @example
             #   require "google/cloud/bigquery/data_transfer"
             #
-            #   data_transfer_service_client = Google::Cloud::Bigquery::DataTransfer.new(version: :v1)
+            #   data_transfer_client = Google::Cloud::Bigquery::DataTransfer.new(version: :v1)
             #   formatted_name = Google::Cloud::Bigquery::DataTransfer::V1::DataTransferServiceClient.project_run_path("[PROJECT]", "[TRANSFER_CONFIG]", "[RUN]")
-            #   response = data_transfer_service_client.get_transfer_run(formatted_name)
+            #   response = data_transfer_client.get_transfer_run(formatted_name)
 
             def get_transfer_run \
                 name,
@@ -796,9 +796,9 @@ module Google
             # @example
             #   require "google/cloud/bigquery/data_transfer"
             #
-            #   data_transfer_service_client = Google::Cloud::Bigquery::DataTransfer.new(version: :v1)
+            #   data_transfer_client = Google::Cloud::Bigquery::DataTransfer.new(version: :v1)
             #   formatted_name = Google::Cloud::Bigquery::DataTransfer::V1::DataTransferServiceClient.project_run_path("[PROJECT]", "[TRANSFER_CONFIG]", "[RUN]")
-            #   data_transfer_service_client.delete_transfer_run(formatted_name)
+            #   data_transfer_client.delete_transfer_run(formatted_name)
 
             def delete_transfer_run \
                 name,
@@ -843,16 +843,16 @@ module Google
             # @example
             #   require "google/cloud/bigquery/data_transfer"
             #
-            #   data_transfer_service_client = Google::Cloud::Bigquery::DataTransfer.new(version: :v1)
+            #   data_transfer_client = Google::Cloud::Bigquery::DataTransfer.new(version: :v1)
             #   formatted_parent = Google::Cloud::Bigquery::DataTransfer::V1::DataTransferServiceClient.project_transfer_config_path("[PROJECT]", "[TRANSFER_CONFIG]")
             #
             #   # Iterate over all results.
-            #   data_transfer_service_client.list_transfer_runs(formatted_parent).each do |element|
+            #   data_transfer_client.list_transfer_runs(formatted_parent).each do |element|
             #     # Process element.
             #   end
             #
             #   # Or iterate over results one page at a time.
-            #   data_transfer_service_client.list_transfer_runs(formatted_parent).each_page do |page|
+            #   data_transfer_client.list_transfer_runs(formatted_parent).each_page do |page|
             #     # Process each page at a time.
             #     page.each do |element|
             #       # Process element.
@@ -905,16 +905,16 @@ module Google
             # @example
             #   require "google/cloud/bigquery/data_transfer"
             #
-            #   data_transfer_service_client = Google::Cloud::Bigquery::DataTransfer.new(version: :v1)
+            #   data_transfer_client = Google::Cloud::Bigquery::DataTransfer.new(version: :v1)
             #   formatted_parent = Google::Cloud::Bigquery::DataTransfer::V1::DataTransferServiceClient.project_run_path("[PROJECT]", "[TRANSFER_CONFIG]", "[RUN]")
             #
             #   # Iterate over all results.
-            #   data_transfer_service_client.list_transfer_logs(formatted_parent).each do |element|
+            #   data_transfer_client.list_transfer_logs(formatted_parent).each do |element|
             #     # Process element.
             #   end
             #
             #   # Or iterate over results one page at a time.
-            #   data_transfer_service_client.list_transfer_logs(formatted_parent).each_page do |page|
+            #   data_transfer_client.list_transfer_logs(formatted_parent).each_page do |page|
             #     # Process each page at a time.
             #     page.each do |element|
             #       # Process element.
@@ -957,9 +957,9 @@ module Google
             # @example
             #   require "google/cloud/bigquery/data_transfer"
             #
-            #   data_transfer_service_client = Google::Cloud::Bigquery::DataTransfer.new(version: :v1)
+            #   data_transfer_client = Google::Cloud::Bigquery::DataTransfer.new(version: :v1)
             #   formatted_name = Google::Cloud::Bigquery::DataTransfer::V1::DataTransferServiceClient.project_data_source_path("[PROJECT]", "[DATA_SOURCE]")
-            #   response = data_transfer_service_client.check_valid_creds(formatted_name)
+            #   response = data_transfer_client.check_valid_creds(formatted_name)
 
             def check_valid_creds \
                 name,

data/lib/google/cloud/bigquery/data_transfer/v1/doc/google/cloud/bigquery/datatransfer/v1/datatransfer.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# 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.

data/lib/google/cloud/bigquery/data_transfer/v1/doc/google/cloud/bigquery/datatransfer/v1/transfer.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# 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.
@@ -174,19 +174,6 @@ module Google
             end
           end
 
-          # DEPRECATED. Represents data transfer type.
-          module TransferType
-            # Invalid or Unknown transfer type placeholder.
-            TRANSFER_TYPE_UNSPECIFIED = 0
-
-            # Batch data transfer.
-            BATCH = 1
-
-            # Streaming data transfer. Streaming data source currently doesn't
-            # support multiple transfer configs per project.
-            STREAMING = 2
-          end
-
           # Represents data transfer run state.
           module TransferState
             # State placeholder.
@@ -208,6 +195,19 @@ module Google
             # Data transfer is cancelled.
             CANCELLED = 6
           end
+
+          # DEPRECATED. Represents data transfer type.
+          module TransferType
+            # Invalid or Unknown transfer type placeholder.
+            TRANSFER_TYPE_UNSPECIFIED = 0
+
+            # Batch data transfer.
+            BATCH = 1
+
+            # Streaming data transfer. Streaming data source currently doesn't
+            # support multiple transfer configs per project.
+            STREAMING = 2
+          end
         end
       end
     end

data/lib/google/cloud/bigquery/data_transfer/v1/doc/google/protobuf/any.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# 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.
@@ -97,7 +97,8 @@ module Google
     # @!attribute [rw] type_url
     #   @return [String]
     #     A URL/resource name that uniquely identifies the type of the serialized
-    #     protocol buffer message. The last segment of the URL's path must represent
+    #     protocol buffer message. This string must contain at least
+    #     one "/" character. The last segment of the URL's path must represent
     #     the fully qualified name of the type (as in
     #     `path/google.protobuf.Duration`). The name should be in a canonical form
     #     (e.g., leading "." is not accepted).

data/lib/google/cloud/bigquery/data_transfer/v1/doc/google/protobuf/duration.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# 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.

data/lib/google/cloud/bigquery/data_transfer/v1/doc/google/protobuf/empty.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# 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.

data/lib/google/cloud/bigquery/data_transfer/v1/doc/google/protobuf/field_mask.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# 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.
@@ -83,57 +83,49 @@ module Google
     # describe the updated values, the API ignores the values of all
     # fields not covered by the mask.
     #
-    # If a repeated field is specified for an update operation, the existing
-    # repeated values in the target resource will be overwritten by the new values.
-    # Note that a repeated field is only allowed in the last position of a `paths`
-    # string.
+    # If a repeated field is specified for an update operation, new values will
+    # be appended to the existing repeated field in the target resource. Note that
+    # a repeated field is only allowed in the last position of a `paths` string.
     #
     # If a sub-message is specified in the last position of the field mask for an
-    # update operation, then the existing sub-message in the target resource is
-    # overwritten. Given the target message:
+    # update operation, then new value will be merged into the existing sub-message
+    # in the target resource.
+    #
+    # For example, given the target message:
     #
     #     f {
     #       b {
-    #         d : 1
-    #         x : 2
+    #         d: 1
+    #         x: 2
     #       }
-    #       c : 1
+    #       c: [1]
     #     }
     #
     # And an update message:
     #
     #     f {
     #       b {
-    #         d : 10
+    #         d: 10
     #       }
+    #       c: [2]
     #     }
     #
     # then if the field mask is:
     #
-    #  paths: "f.b"
+    #  paths: ["f.b", "f.c"]
     #
     # then the result will be:
     #
     #     f {
     #       b {
-    #         d : 10
+    #         d: 10
+    #         x: 2
     #       }
-    #       c : 1
+    #       c: [1, 2]
     #     }
     #
-    # However, if the update mask was:
-    #
-    #  paths: "f.b.d"
-    #
-    # then the result would be:
-    #
-    #     f {
-    #       b {
-    #         d : 10
-    #         x : 2
-    #       }
-    #       c : 1
-    #     }
+    # An implementation may provide options to override this default behavior for
+    # repeated and message fields.
     #
     # In order to reset a field's value to the default, the field must
     # be in the mask and set to the default value in the provided resource.

data/lib/google/cloud/bigquery/data_transfer/v1/doc/google/protobuf/struct.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# 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.

data/lib/google/cloud/bigquery/data_transfer/v1/doc/google/protobuf/timestamp.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# 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,17 +15,19 @@
 
 module Google
   module Protobuf
-    # A Timestamp represents a point in time independent of any time zone
-    # or calendar, represented as seconds and fractions of seconds at
-    # nanosecond resolution in UTC Epoch time. It is encoded using the
-    # Proleptic Gregorian Calendar which extends the Gregorian calendar
-    # backwards to year one. It is encoded assuming all minutes are 60
-    # seconds long, i.e. leap seconds are "smeared" so that no leap second
-    # table is needed for interpretation. Range is from
-    # 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z.
-    # By restricting to that range, we ensure that we can convert to
-    # and from  RFC 3339 date strings.
-    # See [https://www.ietf.org/rfc/rfc3339.txt](https://www.ietf.org/rfc/rfc3339.txt).
+    # A Timestamp represents a point in time independent of any time zone or local
+    # calendar, encoded as a count of seconds and fractions of seconds at
+    # nanosecond resolution. The count is relative to an epoch at UTC midnight on
+    # January 1, 1970, in the proleptic Gregorian calendar which extends the
+    # Gregorian calendar backwards to year one.
+    #
+    # All minutes are 60 seconds long. Leap seconds are "smeared" so that no leap
+    # second table is needed for interpretation, using a [24-hour linear
+    # smear](https://developers.google.com/time/smear).
+    #
+    # The range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. By
+    # restricting to that range, we ensure that we can convert to and from [RFC
+    # 3339](https://www.ietf.org/rfc/rfc3339.txt) date strings.
     #
     # = Examples
     #
@@ -86,12 +88,12 @@ module Google
     # 01:30 UTC on January 15, 2017.
     #
     # In JavaScript, one can convert a Date object to this format using the
-    # standard [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString]
+    # standard [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString)
     # method. In Python, a standard `datetime.datetime` object can be converted
     # to this format using [`strftime`](https://docs.python.org/2/library/time.html#time.strftime)
     # with the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one
     # can use the Joda Time's [`ISODateTimeFormat.dateTime()`](
-    # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime--
+    # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime%2D%2D
     # ) to obtain a formatter capable of generating timestamps in this format.
     # @!attribute [rw] seconds
     #   @return [Integer]

data/lib/google/cloud/bigquery/data_transfer/v1/doc/google/rpc/status.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# 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,24 +15,25 @@
 
 module Google
   module Rpc
-    # 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). The error model is designed to be:
+    # 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). The error model is designed to be:
     #
     # * Simple to use and understand for most users
     # * Flexible enough to meet unexpected needs
     #
     # = Overview
     #
-    # The `Status` message contains three pieces of data: error code, error message,
-    # and error details. The error code should be an enum value of
-    # {Google::Rpc::Code}, but it may accept additional error codes if needed.  The
-    # error message should be a developer-facing English message that helps
-    # developers *understand* and *resolve* the error. If a localized user-facing
-    # error message is needed, put the localized message in the error details or
-    # localize it in the client. The optional error details may contain arbitrary
-    # information about the error. There is a predefined set of error detail types
-    # in the package `google.rpc` that can be used for common error conditions.
+    # The `Status` message contains three pieces of data: error code, error
+    # message, and error details. The error code should be an enum value of
+    # {Google::Rpc::Code}, but it may accept additional error codes
+    # if needed.  The error message should be a developer-facing English message
+    # that helps developers *understand* and *resolve* the error. If a localized
+    # user-facing error message is needed, put the localized message in the error
+    # details or localize it in the client. The optional error details may contain
+    # arbitrary information about the error. There is a predefined set of error
+    # detail types in the package `google.rpc` that can be used for common error
+    # conditions.
     #
     # = Language mapping
     #
@@ -69,12 +70,14 @@ module Google
     #   be used directly after any stripping needed for security/privacy reasons.
     # @!attribute [rw] code
     #   @return [Integer]
-    #     The status code, which should be an enum value of {Google::Rpc::Code}.
+    #     The status code, which should be an enum value of
+    #     {Google::Rpc::Code}.
     # @!attribute [rw] message
     #   @return [String]
     #     A developer-facing error message, which should be in English. Any
     #     user-facing error message should be localized and sent in the
-    #     {Google::Rpc::Status#details} field, or localized by the client.
+    #     {Google::Rpc::Status#details} field, or localized
+    #     by the client.
     # @!attribute [rw] details
     #   @return [Array<Google::Protobuf::Any>]
     #     A list of messages that carry the error details.  There is a common set of

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

@@ -27,9 +27,9 @@ module Google
         module V1
           module DataTransferService
             # The Google BigQuery Data Transfer Service API enables BigQuery users to
-            # configure the transfer of their data from other Google Products into BigQuery.
-            # This service contains methods that are end user exposed. It backs up the
-            # frontend.
+            # configure the transfer of their data from other Google Products into
+            # BigQuery. This service contains methods that are end user exposed. It backs
+            # up the frontend.
             class Service
 
               include GRPC::GenericService

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-bigquery-data_transfer
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.2.4
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-09-20 00:00:00.000000000 Z
+date: 2019-04-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-gax
@@ -58,14 +58,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.50.0
+        version: 0.64.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.50.0
+        version: 0.64.0
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -102,6 +102,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".yardopts"
+- AUTHENTICATION.md
 - LICENSE
 - README.md
 - lib/google/cloud/bigquery/data_transfer.rb
@@ -147,8 +148,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.7
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: API Client library for BigQuery Data Transfer API