google-cloud-bigquery-data_transfer-v1 0.6.0 → 0.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0d3f6c8c15ca8faff1299d946c2a6ca716bc17b770eb2412765a3074d9089b7f
-  data.tar.gz: 393a5f7da248e86dc0b85174295c300838faaeaba5f06cd6221fea22cd2c556a
+  metadata.gz: 9cedc5fbb9cbf2090b2c5bc7b219f925dfe86bf2d8f99ae70d7bc216fa2bb2e9
+  data.tar.gz: bb56f3091662f249247c42d0142271a8360781fe77c8aa582f41e24a318ad992
 SHA512:
-  metadata.gz: e745340a4b582f05927a65c8717b936831cc58f436ce61b5bfba2bfc4e4a928174da082f1c407f59bbbbb07accab236492403ee3e97cf4c1fdfbb1580dc882c4
-  data.tar.gz: bf8fab631237c803b71212bf01f0375a8e078dc592d0eb49ed9ea3f5d2fdb11e363db67ec3804e8f8cc06e091ecc8bab2f60eeb90d5a93441a9927d1c89d1dfb
+  metadata.gz: deb680d8ef213d6ac7265a649560aa1ba1c2165da809d0edd7bff7526393c6be8accba24a4a4ba7c1498289f2589fd352fa786b926d0056302ec4b556a1421ce
+  data.tar.gz: 21bff486fc31a8bb701224cf0245d73299e3b6e6023bcf1f900312ee393a011615ce64fb342f5aaeae9d2120de102068f44887e1c34430b524d90bc099509085

data/AUTHENTICATION.md

@@ -114,7 +114,7 @@ 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`
+2. Authenticate using OAuth 2.0 `$ gcloud auth application-default login`
 3. Write code as if already authenticated.
 
 **NOTE:** This is _not_ recommended for running in production. The Cloud SDK

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

@@ -309,7 +309,7 @@ module Google
               #   @param parent [::String]
               #     Required. The BigQuery project id for which data sources should be returned.
               #     Must be in the form: `projects/{project_id}` or
-              #     `projects/{project_id}/locations/{location_id}
+              #     `projects/{project_id}/locations/{location_id}`
               #   @param page_token [::String]
               #     Pagination token, which can be used to request a specific page
               #     of `ListDataSourcesRequest` list results. For multiple-page
@@ -417,34 +417,45 @@ module Google
               #     Required. Data transfer configuration to create.
               #   @param authorization_code [::String]
               #     Optional OAuth2 authorization code to use with this transfer configuration.
-              #     This is required if new credentials are needed, as indicated by
-              #     `CheckValidCreds`.
-              #     In order to obtain authorization_code, please make a
-              #     request to
-              #     https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?client_id=<datatransferapiclientid>&scope=<data_source_scopes>&redirect_uri=<redirect_uri>
-              #
-              #     * client_id should be OAuth client_id of BigQuery DTS API for the given
-              #       data source returned by ListDataSources method.
-              #     * data_source_scopes are the scopes returned by ListDataSources method.
-              #     * redirect_uri is an optional parameter. If not specified, then
-              #       authorization code is posted to the opener of authorization flow window.
-              #       Otherwise it will be sent to the redirect uri. A special value of
-              #       urn:ietf:wg:oauth:2.0:oob means that authorization code should be
-              #       returned in the title bar of the browser, with the page text prompting
-              #       the user to copy the code and paste it in the application.
+              #     This is required only if `transferConfig.dataSourceId` is 'youtube_channel'
+              #     and new credentials are needed, as indicated by `CheckValidCreds`. In order
+              #     to obtain authorization_code, make a request to the following URL:
+              #     <pre class="prettyprint" suppresswarning="true">
+              #     https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?redirect_uri=urn:ietf:wg:oauth:2.0:oob&response_type=authorization_code&client_id=<var>client_id</var>&scope=<var>data_source_scopes</var>
+              #     </pre>
+              #     * The <var>client_id</var> is the OAuth client_id of the a data source as
+              #     returned by ListDataSources method.
+              #     * <var>data_source_scopes</var> 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 version_info [::String]
-              #     Optional version info. If users want to find a very recent access token,
-              #     that is, immediately after approving access, users have to set the
-              #     version_info claim in the token request. To obtain the version_info, users
-              #     must use the "none+gsession" response type. which be return a
-              #     version_info back in the authorization response which be be put in a JWT
-              #     claim in the token request.
+              #     Optional version info. This is required only if
+              #     `transferConfig.dataSourceId` is not 'youtube_channel' and new credentials
+              #     are needed, as indicated by `CheckValidCreds`. In order to obtain version
+              #     info, make a request to the following URL:
+              #     <pre class="prettyprint" suppresswarning="true">
+              #     https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?redirect_uri=urn:ietf:wg:oauth:2.0:oob&response_type=version_info&client_id=<var>client_id</var>&scope=<var>data_source_scopes</var>
+              #     </pre>
+              #     * The <var>client_id</var> is the OAuth client_id of the a data source as
+              #     returned by ListDataSources method.
+              #     * <var>data_source_scopes</var> 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 service_account_name [::String]
-              #     Optional service account name. If this field is set, transfer config will
-              #     be created with this service account credentials. It requires that
-              #     requesting user calling this API has permissions to act as this service
+              #     Optional service account name. If this field is set, the transfer config
+              #     will be created with this service account's credentials. It requires that
+              #     the requesting user calling this API has permissions to act as this service
               #     account.
               #
+              #     Note that not all data sources support service account credentials when
+              #     creating a transfer config. For the latest list of data sources, read about
+              #     [using service
+              #     accounts](https://cloud.google.com/bigquery-transfer/docs/use-service-accounts).
+              #
               # @yield [response, operation] Access the result along with the RPC operation
               # @yieldparam response [::Google::Cloud::Bigquery::DataTransfer::V1::TransferConfig]
               # @yieldparam operation [::GRPC::ActiveCall::Operation]
@@ -532,37 +543,47 @@ module Google
               #     Required. Data transfer configuration to create.
               #   @param authorization_code [::String]
               #     Optional OAuth2 authorization code to use with this transfer configuration.
-              #     If it is provided, the transfer configuration will be associated with the
-              #     authorizing user.
-              #     In order to obtain authorization_code, please make a
-              #     request to
-              #     https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?client_id=<datatransferapiclientid>&scope=<data_source_scopes>&redirect_uri=<redirect_uri>
-              #
-              #     * client_id should be OAuth client_id of BigQuery DTS API for the given
-              #       data source returned by ListDataSources method.
-              #     * data_source_scopes are the scopes returned by ListDataSources method.
-              #     * redirect_uri is an optional parameter. If not specified, then
-              #       authorization code is posted to the opener of authorization flow window.
-              #       Otherwise it will be sent to the redirect uri. A special value of
-              #       urn:ietf:wg:oauth:2.0:oob means that authorization code should be
-              #       returned in the title bar of the browser, with the page text prompting
-              #       the user to copy the code and paste it in the application.
+              #     This is required only if `transferConfig.dataSourceId` is 'youtube_channel'
+              #     and new credentials are needed, as indicated by `CheckValidCreds`. In order
+              #     to obtain authorization_code, make a request to the following URL:
+              #     <pre class="prettyprint" suppresswarning="true">
+              #     https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?redirect_uri=urn:ietf:wg:oauth:2.0:oob&response_type=authorization_code&client_id=<var>client_id</var>&scope=<var>data_source_scopes</var>
+              #     </pre>
+              #     * The <var>client_id</var> is the OAuth client_id of the a data source as
+              #     returned by ListDataSources method.
+              #     * <var>data_source_scopes</var> 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 update_mask [::Google::Protobuf::FieldMask, ::Hash]
               #     Required. Required list of fields to be updated in this request.
               #   @param version_info [::String]
-              #     Optional version info. If users want to find a very recent access token,
-              #     that is, immediately after approving access, users have to set the
-              #     version_info claim in the token request. To obtain the version_info, users
-              #     must use the "none+gsession" response type. which be return a
-              #     version_info back in the authorization response which be be put in a JWT
-              #     claim in the token request.
+              #     Optional version info. This is required only if
+              #     `transferConfig.dataSourceId` is not 'youtube_channel' and new credentials
+              #     are needed, as indicated by `CheckValidCreds`. In order to obtain version
+              #     info, make a request to the following URL:
+              #     <pre class="prettyprint" suppresswarning="true">
+              #     https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?redirect_uri=urn:ietf:wg:oauth:2.0:oob&response_type=version_info&client_id=<var>client_id</var>&scope=<var>data_source_scopes</var>
+              #     </pre>
+              #     * The <var>client_id</var> is the OAuth client_id of the a data source as
+              #     returned by ListDataSources method.
+              #     * <var>data_source_scopes</var> 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 service_account_name [::String]
-              #     Optional service account name. If this field is set and
-              #     "service_account_name" is set in update_mask, transfer config will be
-              #     updated to use this service account credentials. It requires that
-              #     requesting user calling this API has permissions to act as this service
+              #     Optional service account name. If this field is set, the transfer config
+              #     will be created with this service account's credentials. It requires that
+              #     the requesting user calling this API has permissions to act as this service
               #     account.
               #
+              #     Note that not all data sources support service account credentials when
+              #     creating a transfer config. For the latest list of data sources, read about
+              #     [using service
+              #     accounts](https://cloud.google.com/bigquery-transfer/docs/use-service-accounts).
+              #
               # @yield [response, operation] Access the result along with the RPC operation
               # @yieldparam response [::Google::Cloud::Bigquery::DataTransfer::V1::TransferConfig]
               # @yieldparam operation [::GRPC::ActiveCall::Operation]
@@ -822,7 +843,7 @@ module Google
               #   the default parameter values, pass an empty Hash as a request object (see above).
               #
               #   @param parent [::String]
-              #     Required. The BigQuery project id for which data sources
+              #     Required. The BigQuery project id for which transfer configs
               #     should be returned: `projects/{project_id}` or
               #     `projects/{project_id}/locations/{location_id}`
               #   @param data_source_ids [::Array<::String>]
@@ -1578,10 +1599,12 @@ module Google
               ##
               # Enroll data sources in a user project. This allows users to create transfer
               # configurations for these data sources. They will also appear in the
-              # ListDataSources RPC and as such, will appear in the BigQuery UI
-              # 'https://bigquery.cloud.google.com' (and the documents can be found at
-              # https://cloud.google.com/bigquery/bigquery-web-ui and
-              # https://cloud.google.com/bigquery/docs/working-with-transfers).
+              # ListDataSources RPC and as such, will appear in the
+              # [BigQuery UI](https://console.cloud.google.com/bigquery), and the documents
+              # can be found in the public guide for
+              # [BigQuery Web UI](https://cloud.google.com/bigquery/bigquery-web-ui) and
+              # [Data Transfer
+              # Service](https://cloud.google.com/bigquery/docs/working-with-transfers).
               #
               # @overload enroll_data_sources(request, options = nil)
               #   Pass arguments to `enroll_data_sources` via a request object, either of type
@@ -1599,8 +1622,7 @@ module Google
               #   the default parameter values, pass an empty Hash as a request object (see above).
               #
               #   @param name [::String]
-              #     The name of the project resource in the form:
-              #     `projects/{project_id}`
+              #     The name of the project resource in the form: `projects/{project_id}`
               #   @param data_source_ids [::Array<::String>]
               #     Data sources that are enrolled. It is required to provide at least one
               #     data source id.

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

@@ -22,7 +22,7 @@ module Google
     module Bigquery
       module DataTransfer
         module V1
-          VERSION = "0.6.0"
+          VERSION = "0.6.1"
         end
       end
     end

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

@@ -75,10 +75,12 @@ module Google
               rpc :CheckValidCreds, ::Google::Cloud::Bigquery::DataTransfer::V1::CheckValidCredsRequest, ::Google::Cloud::Bigquery::DataTransfer::V1::CheckValidCredsResponse
               # 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).
+              # ListDataSources RPC and as such, will appear in the
+              # [BigQuery UI](https://console.cloud.google.com/bigquery), and the documents
+              # can be found in the public guide for
+              # [BigQuery Web UI](https://cloud.google.com/bigquery/bigquery-web-ui) and
+              # [Data Transfer
+              # Service](https://cloud.google.com/bigquery/docs/working-with-transfers).
               rpc :EnrollDataSources, ::Google::Cloud::Bigquery::DataTransfer::V1::EnrollDataSourcesRequest, ::Google::Protobuf::Empty
             end
 

data/proto_docs/google/api/client.rb

@@ -0,0 +1,318 @@
+# frozen_string_literal: true
+
+# Copyright 2022 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
+#
+#     https://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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Api
+    # Required information for every language.
+    # @!attribute [rw] reference_docs_uri
+    #   @return [::String]
+    #     Link to automatically generated reference documentation.  Example:
+    #     https://cloud.google.com/nodejs/docs/reference/asset/latest
+    # @!attribute [rw] destinations
+    #   @return [::Array<::Google::Api::ClientLibraryDestination>]
+    #     The destination where API teams want this client library to be published.
+    class CommonLanguageSettings
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # Details about how and where to publish client libraries.
+    # @!attribute [rw] version
+    #   @return [::String]
+    #     Version of the API to apply these settings to.
+    # @!attribute [rw] launch_stage
+    #   @return [::Google::Api::LaunchStage]
+    #     Launch stage of this version of the API.
+    # @!attribute [rw] rest_numeric_enums
+    #   @return [::Boolean]
+    #     When using transport=rest, the client request will encode enums as
+    #     numbers rather than strings.
+    # @!attribute [rw] java_settings
+    #   @return [::Google::Api::JavaSettings]
+    #     Settings for legacy Java features, supported in the Service YAML.
+    # @!attribute [rw] cpp_settings
+    #   @return [::Google::Api::CppSettings]
+    #     Settings for C++ client libraries.
+    # @!attribute [rw] php_settings
+    #   @return [::Google::Api::PhpSettings]
+    #     Settings for PHP client libraries.
+    # @!attribute [rw] python_settings
+    #   @return [::Google::Api::PythonSettings]
+    #     Settings for Python client libraries.
+    # @!attribute [rw] node_settings
+    #   @return [::Google::Api::NodeSettings]
+    #     Settings for Node client libraries.
+    # @!attribute [rw] dotnet_settings
+    #   @return [::Google::Api::DotnetSettings]
+    #     Settings for .NET client libraries.
+    # @!attribute [rw] ruby_settings
+    #   @return [::Google::Api::RubySettings]
+    #     Settings for Ruby client libraries.
+    # @!attribute [rw] go_settings
+    #   @return [::Google::Api::GoSettings]
+    #     Settings for Go client libraries.
+    class ClientLibrarySettings
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # This message configures the settings for publishing [Google Cloud Client
+    # libraries](https://cloud.google.com/apis/docs/cloud-client-libraries)
+    # generated from the service config.
+    # @!attribute [rw] method_settings
+    #   @return [::Array<::Google::Api::MethodSettings>]
+    #     A list of API method settings, e.g. the behavior for methods that use the
+    #     long-running operation pattern.
+    # @!attribute [rw] new_issue_uri
+    #   @return [::String]
+    #     Link to a place that API users can report issues.  Example:
+    #     https://issuetracker.google.com/issues/new?component=190865&template=1161103
+    # @!attribute [rw] documentation_uri
+    #   @return [::String]
+    #     Link to product home page.  Example:
+    #     https://cloud.google.com/asset-inventory/docs/overview
+    # @!attribute [rw] api_short_name
+    #   @return [::String]
+    #     Used as a tracking tag when collecting data about the APIs developer
+    #     relations artifacts like docs, packages delivered to package managers,
+    #     etc.  Example: "speech".
+    # @!attribute [rw] github_label
+    #   @return [::String]
+    #     GitHub label to apply to issues and pull requests opened for this API.
+    # @!attribute [rw] codeowner_github_teams
+    #   @return [::Array<::String>]
+    #     GitHub teams to be added to CODEOWNERS in the directory in GitHub
+    #     containing source code for the client libraries for this API.
+    # @!attribute [rw] doc_tag_prefix
+    #   @return [::String]
+    #     A prefix used in sample code when demarking regions to be included in
+    #     documentation.
+    # @!attribute [rw] organization
+    #   @return [::Google::Api::ClientLibraryOrganization]
+    #     For whom the client library is being published.
+    # @!attribute [rw] library_settings
+    #   @return [::Array<::Google::Api::ClientLibrarySettings>]
+    #     Client library settings.  If the same version string appears multiple
+    #     times in this list, then the last one wins.  Settings from earlier
+    #     settings with the same version string are discarded.
+    class Publishing
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # Settings for Java client libraries.
+    # @!attribute [rw] library_package
+    #   @return [::String]
+    #     The package name to use in Java. Clobbers the java_package option
+    #     set in the protobuf. This should be used **only** by APIs
+    #     who have already set the language_settings.java.package_name" field
+    #     in gapic.yaml. API teams should use the protobuf java_package option
+    #     where possible.
+    #
+    #     Example of a YAML configuration::
+    #
+    #      publishing:
+    #        java_settings:
+    #          library_package: com.google.cloud.pubsub.v1
+    # @!attribute [rw] service_class_names
+    #   @return [::Google::Protobuf::Map{::String => ::String}]
+    #     Configure the Java class name to use instead of the service's for its
+    #     corresponding generated GAPIC client. Keys are fully-qualified
+    #     service names as they appear in the protobuf (including the full
+    #     the language_settings.java.interface_names" field in gapic.yaml. API
+    #     teams should otherwise use the service name as it appears in the
+    #     protobuf.
+    #
+    #     Example of a YAML configuration::
+    #
+    #      publishing:
+    #        java_settings:
+    #          service_class_names:
+    #            - google.pubsub.v1.Publisher: TopicAdmin
+    #            - google.pubsub.v1.Subscriber: SubscriptionAdmin
+    # @!attribute [rw] common
+    #   @return [::Google::Api::CommonLanguageSettings]
+    #     Some settings.
+    class JavaSettings
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # @!attribute [rw] key
+      #   @return [::String]
+      # @!attribute [rw] value
+      #   @return [::String]
+      class ServiceClassNamesEntry
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
+    end
+
+    # Settings for C++ client libraries.
+    # @!attribute [rw] common
+    #   @return [::Google::Api::CommonLanguageSettings]
+    #     Some settings.
+    class CppSettings
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # Settings for Php client libraries.
+    # @!attribute [rw] common
+    #   @return [::Google::Api::CommonLanguageSettings]
+    #     Some settings.
+    class PhpSettings
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # Settings for Python client libraries.
+    # @!attribute [rw] common
+    #   @return [::Google::Api::CommonLanguageSettings]
+    #     Some settings.
+    class PythonSettings
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # Settings for Node client libraries.
+    # @!attribute [rw] common
+    #   @return [::Google::Api::CommonLanguageSettings]
+    #     Some settings.
+    class NodeSettings
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # Settings for Dotnet client libraries.
+    # @!attribute [rw] common
+    #   @return [::Google::Api::CommonLanguageSettings]
+    #     Some settings.
+    class DotnetSettings
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # Settings for Ruby client libraries.
+    # @!attribute [rw] common
+    #   @return [::Google::Api::CommonLanguageSettings]
+    #     Some settings.
+    class RubySettings
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # Settings for Go client libraries.
+    # @!attribute [rw] common
+    #   @return [::Google::Api::CommonLanguageSettings]
+    #     Some settings.
+    class GoSettings
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # Describes the generator configuration for a method.
+    # @!attribute [rw] selector
+    #   @return [::String]
+    #     The fully qualified name of the method, for which the options below apply.
+    #     This is used to find the method to apply the options.
+    # @!attribute [rw] long_running
+    #   @return [::Google::Api::MethodSettings::LongRunning]
+    #     Describes settings to use for long-running operations when generating
+    #     API methods for RPCs. Complements RPCs that use the annotations in
+    #     google/longrunning/operations.proto.
+    #
+    #     Example of a YAML configuration::
+    #
+    #      publishing:
+    #        method_behavior:
+    #          - selector: CreateAdDomain
+    #            long_running:
+    #              initial_poll_delay:
+    #                seconds: 60 # 1 minute
+    #              poll_delay_multiplier: 1.5
+    #              max_poll_delay:
+    #                seconds: 360 # 6 minutes
+    #              total_poll_timeout:
+    #                 seconds: 54000 # 90 minutes
+    class MethodSettings
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # Describes settings to use when generating API methods that use the
+      # long-running operation pattern.
+      # All default values below are from those used in the client library
+      # generators (e.g.
+      # [Java](https://github.com/googleapis/gapic-generator-java/blob/04c2faa191a9b5a10b92392fe8482279c4404803/src/main/java/com/google/api/generator/gapic/composer/common/RetrySettingsComposer.java)).
+      # @!attribute [rw] initial_poll_delay
+      #   @return [::Google::Protobuf::Duration]
+      #     Initial delay after which the first poll request will be made.
+      #     Default value: 5 seconds.
+      # @!attribute [rw] poll_delay_multiplier
+      #   @return [::Float]
+      #     Multiplier to gradually increase delay between subsequent polls until it
+      #     reaches max_poll_delay.
+      #     Default value: 1.5.
+      # @!attribute [rw] max_poll_delay
+      #   @return [::Google::Protobuf::Duration]
+      #     Maximum time between two subsequent poll requests.
+      #     Default value: 45 seconds.
+      # @!attribute [rw] total_poll_timeout
+      #   @return [::Google::Protobuf::Duration]
+      #     Total polling timeout.
+      #     Default value: 5 minutes.
+      class LongRunning
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
+    end
+
+    # The organization for which the client libraries are being published.
+    # Affects the url where generated docs are published, etc.
+    module ClientLibraryOrganization
+      # Not useful.
+      CLIENT_LIBRARY_ORGANIZATION_UNSPECIFIED = 0
+
+      # Google Cloud Platform Org.
+      CLOUD = 1
+
+      # Ads (Advertising) Org.
+      ADS = 2
+
+      # Photos Org.
+      PHOTOS = 3
+
+      # Street View Org.
+      STREET_VIEW = 4
+    end
+
+    # To where should client libraries be published?
+    module ClientLibraryDestination
+      # Client libraries will neither be generated nor published to package
+      # managers.
+      CLIENT_LIBRARY_DESTINATION_UNSPECIFIED = 0
+
+      # Generate the client library in a repo under github.com/googleapis,
+      # but don't publish it to package managers.
+      GITHUB = 10
+
+      # Publish the library to package managers like nuget.org and npmjs.com.
+      PACKAGE_MANAGER = 20
+    end
+  end
+end

data/proto_docs/google/api/launch_stage.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+# Copyright 2022 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
+#
+#     https://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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Api
+    # The launch stage as defined by [Google Cloud Platform
+    # Launch Stages](https://cloud.google.com/terms/launch-stages).
+    module LaunchStage
+      # Do not use this default value.
+      LAUNCH_STAGE_UNSPECIFIED = 0
+
+      # The feature is not yet implemented. Users can not use it.
+      UNIMPLEMENTED = 6
+
+      # Prelaunch features are hidden from users and are only visible internally.
+      PRELAUNCH = 7
+
+      # Early Access features are limited to a closed group of testers. To use
+      # these features, you must sign up in advance and sign a Trusted Tester
+      # agreement (which includes confidentiality provisions). These features may
+      # be unstable, changed in backward-incompatible ways, and are not
+      # guaranteed to be released.
+      EARLY_ACCESS = 1
+
+      # Alpha is a limited availability test for releases before they are cleared
+      # for widespread use. By Alpha, all significant design issues are resolved
+      # and we are in the process of verifying functionality. Alpha customers
+      # need to apply for access, agree to applicable terms, and have their
+      # projects allowlisted. Alpha releases don't have to be feature complete,
+      # no SLAs are provided, and there are no technical support obligations, but
+      # they will be far enough along that customers can actually use them in
+      # test environments or for limited-use tests -- just like they would in
+      # normal production cases.
+      ALPHA = 2
+
+      # Beta is the point at which we are ready to open a release for any
+      # customer to use. There are no SLA or technical support obligations in a
+      # Beta release. Products will be complete from a feature perspective, but
+      # may have some open outstanding issues. Beta releases are suitable for
+      # limited production use cases.
+      BETA = 3
+
+      # GA features are open to all developers and are considered stable and
+      # fully qualified for production use.
+      GA = 4
+
+      # Deprecated features are scheduled to be shut down and removed. For more
+      # information, see the "Deprecation Policy" section of our [Terms of
+      # Service](https://cloud.google.com/terms/)
+      # and the [Google Cloud Platform Subject to the Deprecation
+      # Policy](https://cloud.google.com/terms/deprecation) documentation.
+      DEPRECATED = 5
+    end
+  end
+end

data/proto_docs/google/cloud/bigquery/datatransfer/v1/datatransfer.rb

@@ -52,7 +52,7 @@ module Google
           #     For integer and double values specifies minimum allowed value.
           # @!attribute [rw] max_value
           #   @return [::Google::Protobuf::DoubleValue]
-          #     For integer and double values specifies maxminum allowed value.
+          #     For integer and double values specifies maximum allowed value.
           # @!attribute [rw] fields
           #   @return [::Array<::Google::Cloud::Bigquery::DataTransfer::V1::DataSourceParameter>]
           #     Deprecated. This field has no effect.
@@ -226,7 +226,7 @@ module Google
           #   @return [::String]
           #     Required. The BigQuery project id for which data sources should be returned.
           #     Must be in the form: `projects/{project_id}` or
-          #     `projects/{project_id}/locations/{location_id}
+          #     `projects/{project_id}/locations/{location_id}`
           # @!attribute [rw] page_token
           #   @return [::String]
           #     Pagination token, which can be used to request a specific page
@@ -258,9 +258,9 @@ module Google
           end
 
           # A request to create a data transfer configuration. If new credentials are
-          # needed for this transfer configuration, an authorization code must be
-          # provided. If an authorization code is provided, the transfer configuration
-          # will be associated with the user id corresponding to the authorization code.
+          # needed for this transfer configuration, authorization info must be provided.
+          # If authorization info is provided, the transfer configuration will be
+          # associated with the user id corresponding to the authorization info.
           # Otherwise, the transfer configuration will be associated with the calling
           # user.
           # @!attribute [rw] parent
@@ -275,81 +275,102 @@ module Google
           # @!attribute [rw] authorization_code
           #   @return [::String]
           #     Optional OAuth2 authorization code to use with this transfer configuration.
-          #     This is required if new credentials are needed, as indicated by
-          #     `CheckValidCreds`.
-          #     In order to obtain authorization_code, please make a
-          #     request to
-          #     https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?client_id=<datatransferapiclientid>&scope=<data_source_scopes>&redirect_uri=<redirect_uri>
+          #     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:
+          #     <pre class="prettyprint" suppresswarning="true">
+          #     https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?redirect_uri=urn:ietf:wg:oauth:2.0:oob&response_type=authorization_code&client_id=<var>client_id</var>&scope=<var>data_source_scopes</var>
+          #     </pre>
+          #     * The <var>client_id</var> is the OAuth client_id of the a data source as
+          #     returned by ListDataSources method.
+          #     * <var>data_source_scopes</var> are the scopes returned by ListDataSources
+          #     method.
           #
-          #     * client_id should be OAuth client_id of BigQuery DTS API for the given
-          #       data source returned by ListDataSources method.
-          #     * data_source_scopes are the scopes returned by ListDataSources method.
-          #     * redirect_uri is an optional parameter. If not specified, then
-          #       authorization code is posted to the opener of authorization flow window.
-          #       Otherwise it will be sent to the redirect uri. A special value of
-          #       urn:ietf:wg:oauth:2.0:oob means that authorization code should be
-          #       returned in the title bar of the browser, with the page text prompting
-          #       the user to copy the code and paste it in the application.
+          #     Note that this should not be set when `service_account_name` is used to
+          #     create the transfer config.
           # @!attribute [rw] version_info
           #   @return [::String]
-          #     Optional version info. If users want to find a very recent access token,
-          #     that is, immediately after approving access, users have to set the
-          #     version_info claim in the token request. To obtain the version_info, users
-          #     must use the "none+gsession" response type. which be return a
-          #     version_info back in the authorization response which be be put in a JWT
-          #     claim in the token request.
+          #     Optional version info. This is required only if
+          #     `transferConfig.dataSourceId` is not 'youtube_channel' and new credentials
+          #     are needed, as indicated by `CheckValidCreds`. In order to obtain version
+          #     info, make a request to the following URL:
+          #     <pre class="prettyprint" suppresswarning="true">
+          #     https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?redirect_uri=urn:ietf:wg:oauth:2.0:oob&response_type=version_info&client_id=<var>client_id</var>&scope=<var>data_source_scopes</var>
+          #     </pre>
+          #     * The <var>client_id</var> is the OAuth client_id of the a data source as
+          #     returned by ListDataSources method.
+          #     * <var>data_source_scopes</var> 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.
           # @!attribute [rw] service_account_name
           #   @return [::String]
-          #     Optional service account name. If this field is set, transfer config will
-          #     be created with this service account credentials. It requires that
-          #     requesting user calling this API has permissions to act as this service
+          #     Optional service account name. If this field is set, the transfer config
+          #     will be created with this service account's credentials. It requires that
+          #     the requesting user calling this API has permissions to act as this service
           #     account.
+          #
+          #     Note that not all data sources support service account credentials when
+          #     creating a transfer config. For the latest list of data sources, read about
+          #     [using service
+          #     accounts](https://cloud.google.com/bigquery-transfer/docs/use-service-accounts).
           class CreateTransferConfigRequest
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
           # A request to update a transfer configuration. To update the user id of the
-          # transfer configuration, an authorization code needs to be provided.
+          # transfer configuration, authorization info needs to be provided.
           # @!attribute [rw] transfer_config
           #   @return [::Google::Cloud::Bigquery::DataTransfer::V1::TransferConfig]
           #     Required. Data transfer configuration to create.
           # @!attribute [rw] authorization_code
           #   @return [::String]
           #     Optional OAuth2 authorization code to use with this transfer configuration.
-          #     If it is provided, the transfer configuration will be associated with the
-          #     authorizing user.
-          #     In order to obtain authorization_code, please make a
-          #     request to
-          #     https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?client_id=<datatransferapiclientid>&scope=<data_source_scopes>&redirect_uri=<redirect_uri>
+          #     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:
+          #     <pre class="prettyprint" suppresswarning="true">
+          #     https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?redirect_uri=urn:ietf:wg:oauth:2.0:oob&response_type=authorization_code&client_id=<var>client_id</var>&scope=<var>data_source_scopes</var>
+          #     </pre>
+          #     * The <var>client_id</var> is the OAuth client_id of the a data source as
+          #     returned by ListDataSources method.
+          #     * <var>data_source_scopes</var> are the scopes returned by ListDataSources
+          #     method.
           #
-          #     * client_id should be OAuth client_id of BigQuery DTS API for the given
-          #       data source returned by ListDataSources method.
-          #     * data_source_scopes are the scopes returned by ListDataSources method.
-          #     * redirect_uri is an optional parameter. If not specified, then
-          #       authorization code is posted to the opener of authorization flow window.
-          #       Otherwise it will be sent to the redirect uri. A special value of
-          #       urn:ietf:wg:oauth:2.0:oob means that authorization code should be
-          #       returned in the title bar of the browser, with the page text prompting
-          #       the user to copy the code and paste it in the application.
+          #     Note that this should not be set when `service_account_name` is used to
+          #     update the transfer config.
           # @!attribute [rw] update_mask
           #   @return [::Google::Protobuf::FieldMask]
           #     Required. Required list of fields to be updated in this request.
           # @!attribute [rw] version_info
           #   @return [::String]
-          #     Optional version info. If users want to find a very recent access token,
-          #     that is, immediately after approving access, users have to set the
-          #     version_info claim in the token request. To obtain the version_info, users
-          #     must use the "none+gsession" response type. which be return a
-          #     version_info back in the authorization response which be be put in a JWT
-          #     claim in the token request.
+          #     Optional version info. This is required only if
+          #     `transferConfig.dataSourceId` is not 'youtube_channel' and new credentials
+          #     are needed, as indicated by `CheckValidCreds`. In order to obtain version
+          #     info, make a request to the following URL:
+          #     <pre class="prettyprint" suppresswarning="true">
+          #     https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?redirect_uri=urn:ietf:wg:oauth:2.0:oob&response_type=version_info&client_id=<var>client_id</var>&scope=<var>data_source_scopes</var>
+          #     </pre>
+          #     * The <var>client_id</var> is the OAuth client_id of the a data source as
+          #     returned by ListDataSources method.
+          #     * <var>data_source_scopes</var> 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.
           # @!attribute [rw] service_account_name
           #   @return [::String]
-          #     Optional service account name. If this field is set and
-          #     "service_account_name" is set in update_mask, transfer config will be
-          #     updated to use this service account credentials. It requires that
-          #     requesting user calling this API has permissions to act as this service
+          #     Optional service account name. If this field is set, the transfer config
+          #     will be created with this service account's credentials. It requires that
+          #     the requesting user calling this API has permissions to act as this service
           #     account.
+          #
+          #     Note that not all data sources support service account credentials when
+          #     creating a transfer config. For the latest list of data sources, read about
+          #     [using service
+          #     accounts](https://cloud.google.com/bigquery-transfer/docs/use-service-accounts).
           class UpdateTransferConfigRequest
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -403,7 +424,7 @@ module Google
           # A request to list data transfers configured for a BigQuery project.
           # @!attribute [rw] parent
           #   @return [::String]
-          #     Required. The BigQuery project id for which data sources
+          #     Required. The BigQuery project id for which transfer configs
           #     should be returned: `projects/{project_id}` or
           #     `projects/{project_id}/locations/{location_id}`
           # @!attribute [rw] data_source_ids
@@ -634,8 +655,7 @@ module Google
           # BigQuery UI's `Transfer` tab.
           # @!attribute [rw] name
           #   @return [::String]
-          #     The name of the project resource in the form:
-          #     `projects/{project_id}`
+          #     The name of the project resource in the form: `projects/{project_id}`
           # @!attribute [rw] data_source_ids
           #   @return [::Array<::String>]
           #     Data sources that are enrolled. It is required to provide at least one

data/proto_docs/google/cloud/bigquery/datatransfer/v1/transfer.rb

@@ -88,7 +88,9 @@ module Google
           #     User specified display name for the data transfer.
           # @!attribute [rw] data_source_id
           #   @return [::String]
-          #     Data source id. Cannot be changed once data transfer is created.
+          #     Data source ID. This cannot be changed once data transfer is created. The
+          #     full list of available data source IDs can be returned through an API call:
+          #     https://cloud.google.com/bigquery-transfer/docs/reference/datatransfer/rest/v1/projects.locations.dataSources/list
           # @!attribute [rw] params
           #   @return [::Google::Protobuf::Struct]
           #     Parameters specific to each data source. For more information see the

data/proto_docs/google/protobuf/empty.rb

@@ -26,8 +26,6 @@ module Google
     #     service Foo {
     #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
     #     }
-    #
-    # The JSON representation for `Empty` is empty JSON object `{}`.
     class Empty
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-bigquery-data_transfer-v1
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.6.1
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-07-01 00:00:00.000000000 Z
+date: 2022-11-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.10'
+        version: '0.12'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.10'
+        version: '0.12'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -181,7 +181,9 @@ files:
 - lib/google/cloud/bigquery/datatransfer/v1/datatransfer_services_pb.rb
 - lib/google/cloud/bigquery/datatransfer/v1/transfer_pb.rb
 - proto_docs/README.md
+- proto_docs/google/api/client.rb
 - proto_docs/google/api/field_behavior.rb
+- proto_docs/google/api/launch_stage.rb
 - proto_docs/google/api/resource.rb
 - proto_docs/google/cloud/bigquery/datatransfer/v1/datatransfer.rb
 - proto_docs/google/cloud/bigquery/datatransfer/v1/transfer.rb