google-cloud-channel 1.1.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 84b86ac51c18f568e2b4820451cbb96406a90c6d36889b658b97a3803e85d46b
-  data.tar.gz: 12c84dc266321963479b18eb60842f10e57d767ac059d00d80a0d35c20f4734b
+  metadata.gz: 8bf1e03ac4e18a64b54dfaaf6490b4b3b06f5da933cd9cea34ce3017f99876f2
+  data.tar.gz: 73b671a07910592f30c77ccda520e00cfcbd43466a2960404a7194de5379d629
 SHA512:
-  metadata.gz: a032b9ab80ba4c98b77cbcd01d43382fa762be8cdf5fa3787d6effd1a7dbb1383634f086568ee1ffca72deaa0c411790494c8c6bd3962f36ebd16f653f64d2f4
-  data.tar.gz: 872eaba01dd9d2b35eaf76dd78a2c38949d8a5a3920ce46733bdf151af4ae5e883531a978545575d654722b34838718e3eb39bbef981664879d2f2fc2346bdde
+  metadata.gz: 594b8979f5b68460faae440b0866c12bffad3ae94ee9a6e00904f8f72c00b783d47d00b142d397cba15f203985aef3bcb6c8ad6033100e1e46d0c8277a8da7a0
+  data.tar.gz: 075b542ac44bd62279838042dc147b81bde7c04e6644832e6082f9aad558b3533e5372a880a5b33a269aad77ec1669b59bef0a7c4de82eaf3229365b8543cd8c

data/AUTHENTICATION.md

@@ -27,7 +27,7 @@ export CHANNEL_CREDENTIALS=path/to/keyfile.json
 ```ruby
 require "google/cloud/channel"
 
-client = Google::Cloud::Channel.cloud_channel_service
+client = Google::Cloud::Channel.cloud_channel_reports_service
 ```
 
 ## Credential Lookup
@@ -64,7 +64,7 @@ containers where writing files is difficult or not encouraged.
 
 The environment variables that google-cloud-channel
 checks for credentials are configured on the service Credentials class (such as
-`::Google::Cloud::Channel::V1::CloudChannelService::Credentials`):
+`::Google::Cloud::Channel::V1::CloudChannelReportsService::Credentials`):
 
 * `CHANNEL_CREDENTIALS` - Path to JSON file, or JSON contents
 * `CHANNEL_KEYFILE` - Path to JSON file, or JSON contents
@@ -77,7 +77,7 @@ require "google/cloud/channel"
 
 ENV["CHANNEL_CREDENTIALS"] = "path/to/keyfile.json"
 
-client = Google::Cloud::Channel.cloud_channel_service
+client = Google::Cloud::Channel.cloud_channel_reports_service
 ```
 
 ### Configuration
@@ -88,7 +88,7 @@ it in an environment variable. Either on an individual client initialization:
 ```ruby
 require "google/cloud/channel"
 
-client = Google::Cloud::Channel.cloud_channel_service do |config|
+client = Google::Cloud::Channel.cloud_channel_reports_service do |config|
   config.credentials = "path/to/keyfile.json"
 end
 ```
@@ -102,7 +102,7 @@ Google::Cloud::Channel.configure do |config|
   config.credentials = "path/to/keyfile.json"
 end
 
-client = Google::Cloud::Channel.cloud_channel_service
+client = Google::Cloud::Channel.cloud_channel_reports_service
 ```
 
 ### Cloud SDK
@@ -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/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.1.0"
+      VERSION = "1.3.0"
     end
   end
 end

data/lib/google/cloud/channel.rb

@@ -44,16 +44,55 @@ end
 module Google
   module Cloud
     module Channel
+      ##
+      # 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 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.)
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1`.
+      # @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, 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
+        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
+      # 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
       #
@@ -67,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
 
       ##
@@ -109,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.1.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-07-02 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.5'
+        version: '0.16'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.5'
+        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