google-cloud-channel 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cd6d2c47463996bfaa6867fe6957d4bfca94860ec493f66c9a0c326bd882ae5e
-  data.tar.gz: 1c2b9b7fe67402712546075a738062686ffaca588f7cb52f73b17929c0ace823
+  metadata.gz: 8bf1e03ac4e18a64b54dfaaf6490b4b3b06f5da933cd9cea34ce3017f99876f2
+  data.tar.gz: 73b671a07910592f30c77ccda520e00cfcbd43466a2960404a7194de5379d629
 SHA512:
-  metadata.gz: 5a0d435bc2985885bdbeadb7eb47d25e1e82a448878d08cde1f89083d11ffd118f8c351b8da5bf41e247bdead0e56edaa9ab9b80468fb911cba2282e8210f679
-  data.tar.gz: 3820cffff9b0a3779fad7dd0417c48edf7ff23e788e83e2d7d96b03e4f0c33d8b01f2b942e32b95f6be225253873445f0e61ea6a37888155ba4942c7122b8a2c
+  metadata.gz: 594b8979f5b68460faae440b0866c12bffad3ae94ee9a6e00904f8f72c00b783d47d00b142d397cba15f203985aef3bcb6c8ad6033100e1e46d0c8277a8da7a0
+  data.tar.gz: 075b542ac44bd62279838042dc147b81bde7c04e6644832e6082f9aad558b3533e5372a880a5b33a269aad77ec1669b59bef0a7c4de82eaf3229365b8543cd8c

data/README.md

@@ -34,32 +34,6 @@ In order to use this library, you first need to go through the following steps:
 1. [Enable the API.](https://console.cloud.google.com/apis/library/cloudchannel.googleapis.com)
 1. {file:AUTHENTICATION.md Set up authentication.}
 
-## Enabling Logging
-
-To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
-The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib/libdoc/logger/rdoc/Logger.html) as shown below,
-or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
-that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
-and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
-
-Configuring a Ruby stdlib logger:
-
-```ruby
-require "logger"
-
-module MyLogger
-  LOGGER = Logger.new $stderr, level: Logger::WARN
-  def logger
-    LOGGER
-  end
-end
-
-# Define a gRPC module-level logger method before grpc/logconfig.rb loads.
-module GRPC
-  extend MyLogger
-end
-```
-
 ## Supported Ruby Versions
 
 This library is supported on Ruby 2.6+.

data/lib/google/cloud/channel/version.rb

@@ -20,7 +20,7 @@
 module Google
   module Cloud
     module Channel
-      VERSION = "1.2.0"
+      VERSION = "1.3.0"
     end
   end
 end

data/lib/google/cloud/channel.rb

@@ -49,11 +49,13 @@ module Google
       #
       # By default, this returns an instance of
       # [Google::Cloud::Channel::V1::CloudChannelReportsService::Client](https://googleapis.dev/ruby/google-cloud-channel-v1/latest/Google/Cloud/Channel/V1/CloudChannelReportsService/Client.html)
-      # for version V1 of the API.
-      # However, you can specify specify a different API version by passing it in the
+      # for a gRPC client for version V1 of the API.
+      # However, you can specify a different API version by passing it in the
       # `version` parameter. If the CloudChannelReportsService service is
       # supported by that API version, and the corresponding gem is available, the
       # appropriate versioned client will be returned.
+      # You can also specify a different transport by passing `:rest` or `:grpc` in
+      # the `transport` parameter.
       #
       # ## About CloudChannelReportsService
       #
@@ -64,17 +66,19 @@ module Google
       #
       # @param version [::String, ::Symbol] The API version to connect to. Optional.
       #   Defaults to `:v1`.
-      # @return [CloudChannelReportsService::Client] A client object for the specified version.
+      # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
+      # @return [::Object] A client object for the specified version.
       #
-      def self.cloud_channel_reports_service version: :v1, &block
+      def self.cloud_channel_reports_service version: :v1, transport: :grpc, &block
         require "google/cloud/channel/#{version.to_s.downcase}"
 
         package_name = Google::Cloud::Channel
                        .constants
                        .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
                        .first
-        package_module = Google::Cloud::Channel.const_get package_name
-        package_module.const_get(:CloudChannelReportsService).const_get(:Client).new(&block)
+        service_module = Google::Cloud::Channel.const_get(package_name).const_get(:CloudChannelReportsService)
+        service_module = service_module.const_get(:Rest) if transport == :rest
+        service_module.const_get(:Client).new(&block)
       end
 
       ##
@@ -82,11 +86,13 @@ module Google
       #
       # By default, this returns an instance of
       # [Google::Cloud::Channel::V1::CloudChannelService::Client](https://googleapis.dev/ruby/google-cloud-channel-v1/latest/Google/Cloud/Channel/V1/CloudChannelService/Client.html)
-      # for version V1 of the API.
-      # However, you can specify specify a different API version by passing it in the
+      # for a gRPC client for version V1 of the API.
+      # However, you can specify a different API version by passing it in the
       # `version` parameter. If the CloudChannelService service is
       # supported by that API version, and the corresponding gem is available, the
       # appropriate versioned client will be returned.
+      # You can also specify a different transport by passing `:rest` or `:grpc` in
+      # the `transport` parameter.
       #
       # ## About CloudChannelService
       #
@@ -100,29 +106,32 @@ module Google
       # 3. Resellers and distributors can manage customer entitlements.
       #
       # CloudChannelService exposes the following resources:
-      # - Customers: An entity—usually an enterprise—managed by a reseller or
-      # distributor.
+      # - Customers: An entity-usually an
+      # enterprise-managed by a reseller or distributor.
       #
-      # - Entitlements: An entity that provides a customer with the means to use
-      # a service. Entitlements are created or updated as a result of a successful
-      # fulfillment.
+      # - Entitlements: An entity that
+      # provides a customer with the means to use a service. Entitlements are created
+      # or updated as a result of a successful fulfillment.
       #
-      # - ChannelPartnerLinks: An entity that identifies links between
-      # distributors and their indirect resellers in a channel.
+      # - ChannelPartnerLinks: An
+      # entity that identifies links between distributors and their indirect
+      # resellers in a channel.
       #
       # @param version [::String, ::Symbol] The API version to connect to. Optional.
       #   Defaults to `:v1`.
-      # @return [CloudChannelService::Client] A client object for the specified version.
+      # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
+      # @return [::Object] A client object for the specified version.
       #
-      def self.cloud_channel_service version: :v1, &block
+      def self.cloud_channel_service version: :v1, transport: :grpc, &block
         require "google/cloud/channel/#{version.to_s.downcase}"
 
         package_name = Google::Cloud::Channel
                        .constants
                        .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
                        .first
-        package_module = Google::Cloud::Channel.const_get package_name
-        package_module.const_get(:CloudChannelService).const_get(:Client).new(&block)
+        service_module = Google::Cloud::Channel.const_get(package_name).const_get(:CloudChannelService)
+        service_module = service_module.const_get(:Rest) if transport == :rest
+        service_module.const_get(:Client).new(&block)
       end
 
       ##
@@ -142,7 +151,7 @@ module Google
       # * `timeout` (*type:* `Numeric`) -
       #   Default timeout in seconds.
       # * `metadata` (*type:* `Hash{Symbol=>String}`) -
-      #   Additional gRPC headers to be sent with the call.
+      #   Additional headers to be sent with the call.
       # * `retry_policy` (*type:* `Hash`) -
       #   The retry policy. The value is a hash with the following keys:
       #     * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-channel
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-10-24 00:00:00.000000000 Z
+date: 2023-03-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-channel-v1
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.13'
+        version: '0.16'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.13'
+        version: '0.16'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -190,7 +190,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.14
+rubygems_version: 3.4.2
 signing_key: 
 specification_version: 4
 summary: API Client library for the Cloud Channel API