google-cloud-channel 1.2.0 → 1.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cd6d2c47463996bfaa6867fe6957d4bfca94860ec493f66c9a0c326bd882ae5e
-  data.tar.gz: 1c2b9b7fe67402712546075a738062686ffaca588f7cb52f73b17929c0ace823
+  metadata.gz: 39c427a4d14a5412b71080f316996de1966dbd9e532dc85d45089bdb9f7648de
+  data.tar.gz: 9bbe98c8cd256cdd64ccfdf6c86e83d480cf6490e8b87dac3e0838bf735a9e73
 SHA512:
-  metadata.gz: 5a0d435bc2985885bdbeadb7eb47d25e1e82a448878d08cde1f89083d11ffd118f8c351b8da5bf41e247bdead0e56edaa9ab9b80468fb911cba2282e8210f679
-  data.tar.gz: 3820cffff9b0a3779fad7dd0417c48edf7ff23e788e83e2d7d96b03e4f0c33d8b01f2b942e32b95f6be225253873445f0e61ea6a37888155ba4942c7122b8a2c
+  metadata.gz: 1976c9dccb416c96b7e8a8db78a92d0cf945a718c70598c772d3d7845ba1b0154bdb8f2b1e785a76f62c9369c81747de310fdab86e65411193c44eaa7573799c
+  data.tar.gz: 6a5be1491e7a6a4db011c9e73ffacb3c35800de01e0d372d573b3dbddd399a7360ed43e481676d6795faafe2d0c72af2c6d05edad7976b558e8be49a8ff22b64

data/README.md

@@ -16,7 +16,7 @@ for this library, google-cloud-channel, to see the convenience methods for
 constructing client objects. Reference documentation for the client objects
 themselves can be found in the client library documentation for the versioned
 client gems:
-[google-cloud-channel-v1](https://googleapis.dev/ruby/google-cloud-channel-v1/latest).
+[google-cloud-channel-v1](https://cloud.google.com/ruby/docs/reference/google-cloud-channel-v1/latest).
 
 See also the [Product Documentation](https://cloud.google.com/channel)
 for more usage information.
@@ -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.1"
     end
   end
 end

data/lib/google/cloud/channel.rb

@@ -48,45 +48,55 @@ module Google
       # Create a new client object for CloudChannelReportsService.
       #
       # 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
+      # [Google::Cloud::Channel::V1::CloudChannelReportsService::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-channel-v1/latest/Google-Cloud-Channel-V1-CloudChannelReportsService-Client)
+      # 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
       #
       # CloudChannelReportsService lets Google Cloud resellers and
       # distributors retrieve and combine a variety of data in Cloud Channel for
-      # multiple products (Google Cloud Platform (GCP), Google Voice, and
-      # Google Workspace.)
+      # multiple products (Google Cloud, Google Voice, and Google Workspace.)
+      #
+      # Deprecated: This service is being deprecated. Please use [Export Channel
+      # Services data to
+      # BigQuery](https://cloud.google.com/channel/docs/rebilling/export-data-to-bigquery)
+      # instead.
       #
       # @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
 
       ##
       # Create a new client object for CloudChannelService.
       #
       # 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
+      # [Google::Cloud::Channel::V1::CloudChannelService::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-channel-v1/latest/Google-Cloud-Channel-V1-CloudChannelService-Client)
+      # 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 +110,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 +155,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.1
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-10-24 00:00:00.000000000 Z
+date: 2024-01-03 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.5.3
 signing_key: 
 specification_version: 4
 summary: API Client library for the Cloud Channel API