google-cloud-channel-v1 0.21.0 → 0.22.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3aa8fc5349ce7d0cfccf288e1191130183a587f46a17fb2a3b5ae9529d4f2ed0
-  data.tar.gz: 76292b004a004dec6d17510c206830e5bd4e2e1b70798bf9c27c511618361454
+  metadata.gz: 3b80a4dcdca9f823d4e0b883c1763ac190fc1f13e1c7a703d362a11542eba207
+  data.tar.gz: 3bf12e8c63942f31368c226fd3d23b952f6f1a72096e0e3dd98b3ca02ca933db
 SHA512:
-  metadata.gz: 5c806102daf252edd3dc447a4fac8a969a4a6903f7292abd13794c23dd1cbff5ab6df2ee4f51e9c77e579f518b36734d129fa1f4f47d49363c85618b6375f634
-  data.tar.gz: 0cca47f4f897f9cd3b4b4e4fb1c9dee96bc5c617524449c4a0d0b7136659d3a2dd9d418c7d5d6a2fd6403062e8d91abd4a505d90dd7c0cdc78344340c565accf
+  metadata.gz: e6098f15c53368da8a68caa30efbc0c04bbb1b7cd1b4e03668fd4cf0bb4fed0180cc5eff56d635ff9ad9654ecabe64f2ea46d1f9331b924c47bed2b28665b2dc
+  data.tar.gz: 8e1dc2c27e8207c0584376399de949a9f4f6b4d8200c6bd771361fff0bb5b7995d285192281d007f59718b6806c7bc408d4ba231fc9515ac584af7d17293abcc

data/lib/google/cloud/channel/v1/billing_accounts_pb.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/channel/v1/billing_accounts.proto
+
+require 'google/protobuf'
+
+require 'google/api/field_behavior_pb'
+require 'google/api/resource_pb'
+require 'google/protobuf/timestamp_pb'
+
+
+descriptor_data = "\n.google/cloud/channel/v1/billing_accounts.proto\x12\x17google.cloud.channel.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\x8c\x02\n\x0e\x42illingAccount\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x03\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x34\n\x0b\x63reate_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12\x1a\n\rcurrency_code\x18\x04 \x01(\tB\x03\xe0\x41\x03\x12\x18\n\x0bregion_code\x18\x05 \x01(\tB\x03\xe0\x41\x03:e\xea\x41\x62\n*cloudchannel.googleapis.com/BillingAccount\x12\x34\x61\x63\x63ounts/{account}/billingAccounts/{billing_account}Bl\n\x1b\x63om.google.cloud.channel.v1B\x14\x42illingAccountsProtoP\x01Z5cloud.google.com/go/channel/apiv1/channelpb;channelpbb\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError => e
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+    ["google.protobuf.Timestamp", "google/protobuf/timestamp.proto"],
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
+    end
+  end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
+end
+
+module Google
+  module Cloud
+    module Channel
+      module V1
+        BillingAccount = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.BillingAccount").msgclass
+      end
+    end
+  end
+end

data/lib/google/cloud/channel/v1/cloud_channel_reports_service/client.rb

@@ -31,6 +31,11 @@ module Google
           # distributors retrieve and combine a variety of data in Cloud Channel for
           # 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.
+          #
           class Client
             include Paths
 
@@ -43,6 +48,8 @@ module Google
             # See {::Google::Cloud::Channel::V1::CloudChannelReportsService::Client::Configuration}
             # for a description of the configuration fields.
             #
+            # @deprecated This service is deprecated and may be removed in the next major version update.
+            #
             # @example
             #
             #   # Modify the configuration for all CloudChannelReportsService clients
@@ -146,7 +153,8 @@ module Google
                 credentials:  credentials,
                 endpoint:     @config.endpoint,
                 channel_args: @config.channel_args,
-                interceptors: @config.interceptors
+                interceptors: @config.interceptors,
+                channel_pool_config: @config.channel_pool
               )
             end
 
@@ -186,6 +194,12 @@ module Google
             # with the
             # {::Google::Cloud::Channel::V1::RunReportJobResponse#report_job RunReportJobResponse.report_job}.
             #
+            # Deprecated: Please use [Export Channel Services data to
+            # BigQuery](https://cloud.google.com/channel/docs/rebilling/export-data-to-bigquery)
+            # instead.
+            #
+            # @deprecated This method is deprecated and may be removed in the next major version update.
+            #
             # @overload run_report_job(request, options = nil)
             #   Pass arguments to `run_report_job` via a request object, either of type
             #   {::Google::Cloud::Channel::V1::RunReportJobRequest} or an equivalent Hash.
@@ -302,6 +316,12 @@ module Google
             # Retrieves data generated by
             # {::Google::Cloud::Channel::V1::CloudChannelReportsService::Client#run_report_job CloudChannelReportsService.RunReportJob}.
             #
+            # Deprecated: Please use [Export Channel Services data to
+            # BigQuery](https://cloud.google.com/channel/docs/rebilling/export-data-to-bigquery)
+            # instead.
+            #
+            # @deprecated This method is deprecated and may be removed in the next major version update.
+            #
             # @overload fetch_report_results(request, options = nil)
             #   Pass arguments to `fetch_report_results` via a request object, either of type
             #   {::Google::Cloud::Channel::V1::FetchReportResultsRequest} or an equivalent Hash.
@@ -413,6 +433,12 @@ module Google
             # Lists the reports that RunReportJob can run. These reports include an ID,
             # a description, and the list of columns that will be in the result.
             #
+            # Deprecated: Please use [Export Channel Services data to
+            # BigQuery](https://cloud.google.com/channel/docs/rebilling/export-data-to-bigquery)
+            # instead.
+            #
+            # @deprecated This method is deprecated and may be removed in the next major version update.
+            #
             # @overload list_reports(request, options = nil)
             #   Pass arguments to `list_reports` via a request object, either of type
             #   {::Google::Cloud::Channel::V1::ListReportsRequest} or an equivalent Hash.
@@ -636,6 +662,14 @@ module Google
                 end
               end
 
+              ##
+              # Configuration for the channel pool
+              # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
+              #
+              def channel_pool
+                @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
+              end
+
               ##
               # Configuration RPC class for the CloudChannelReportsService API.
               #

data/lib/google/cloud/channel/v1/cloud_channel_reports_service/operations.rb

@@ -93,7 +93,8 @@ module Google
                 credentials:  credentials,
                 endpoint:     @config.endpoint,
                 channel_args: @config.channel_args,
-                interceptors: @config.interceptors
+                interceptors: @config.interceptors,
+                channel_pool_config: @config.channel_pool
               )
 
               # Used by an LRO wrapper for some methods of this service
@@ -701,6 +702,14 @@ module Google
                 end
               end
 
+              ##
+              # Configuration for the channel pool
+              # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
+              #
+              def channel_pool
+                @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
+              end
+
               ##
               # Configuration RPC class for the Operations API.
               #

data/lib/google/cloud/channel/v1/cloud_channel_reports_service/rest/client.rb

@@ -33,6 +33,11 @@ module Google
             # distributors retrieve and combine a variety of data in Cloud Channel for
             # 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.
+            #
             class Client
               include Paths
 
@@ -45,6 +50,8 @@ module Google
               # See {::Google::Cloud::Channel::V1::CloudChannelReportsService::Rest::Client::Configuration}
               # for a description of the configuration fields.
               #
+              # @deprecated This service is deprecated and may be removed in the next major version update.
+              #
               # @example
               #
               #   # Modify the configuration for all CloudChannelReportsService clients
@@ -177,6 +184,10 @@ module Google
               # with the
               # {::Google::Cloud::Channel::V1::RunReportJobResponse#report_job RunReportJobResponse.report_job}.
               #
+              # Deprecated: Please use [Export Channel Services data to
+              # BigQuery](https://cloud.google.com/channel/docs/rebilling/export-data-to-bigquery)
+              # instead.
+              #
               # @overload run_report_job(request, options = nil)
               #   Pass arguments to `run_report_job` via a request object, either of type
               #   {::Google::Cloud::Channel::V1::RunReportJobRequest} or an equivalent Hash.
@@ -223,6 +234,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/channel/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Channel::V1::CloudChannelReportsService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Channel::V1::RunReportJobRequest.new
+              #
+              #   # Call the run_report_job method.
+              #   result = client.run_report_job request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def run_report_job request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -263,6 +297,10 @@ module Google
               # Retrieves data generated by
               # {::Google::Cloud::Channel::V1::CloudChannelReportsService::Rest::Client#run_report_job CloudChannelReportsService.RunReportJob}.
               #
+              # Deprecated: Please use [Export Channel Services data to
+              # BigQuery](https://cloud.google.com/channel/docs/rebilling/export-data-to-bigquery)
+              # instead.
+              #
               # @overload fetch_report_results(request, options = nil)
               #   Pass arguments to `fetch_report_results` via a request object, either of type
               #   {::Google::Cloud::Channel::V1::FetchReportResultsRequest} or an equivalent Hash.
@@ -307,6 +345,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Channel::V1::Row>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/channel/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Channel::V1::CloudChannelReportsService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Channel::V1::FetchReportResultsRequest.new
+              #
+              #   # Call the fetch_report_results method.
+              #   result = client.fetch_report_results request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::Channel::V1::Row.
+              #     p item
+              #   end
+              #
               def fetch_report_results request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -347,6 +405,10 @@ module Google
               # Lists the reports that RunReportJob can run. These reports include an ID,
               # a description, and the list of columns that will be in the result.
               #
+              # Deprecated: Please use [Export Channel Services data to
+              # BigQuery](https://cloud.google.com/channel/docs/rebilling/export-data-to-bigquery)
+              # instead.
+              #
               # @overload list_reports(request, options = nil)
               #   Pass arguments to `list_reports` via a request object, either of type
               #   {::Google::Cloud::Channel::V1::ListReportsRequest} or an equivalent Hash.
@@ -388,6 +450,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Channel::V1::Report>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/channel/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Channel::V1::CloudChannelReportsService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Channel::V1::ListReportsRequest.new
+              #
+              #   # Call the list_reports method.
+              #   result = client.list_reports request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::Channel::V1::Report.
+              #     p item
+              #   end
+              #
               def list_reports request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 

data/lib/google/cloud/channel/v1/cloud_channel_reports_service/rest/operations.rb

@@ -136,6 +136,26 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/longrunning"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Longrunning::Operations::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Longrunning::ListOperationsRequest.new
+              #
+              #   # Call the list_operations method.
+              #   result = client.list_operations request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Longrunning::Operation.
+              #     p item
+              #   end
+              #
               def list_operations request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -201,6 +221,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/longrunning"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Longrunning::Operations::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Longrunning::GetOperationRequest.new
+              #
+              #   # Call the get_operation method.
+              #   result = client.get_operation request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def get_operation request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -267,6 +310,22 @@ module Google
               # @return [::Google::Protobuf::Empty]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/longrunning"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Longrunning::Operations::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Longrunning::DeleteOperationRequest.new
+              #
+              #   # Call the delete_operation method.
+              #   result = client.delete_operation request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def delete_operation request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -338,6 +397,22 @@ module Google
               # @return [::Google::Protobuf::Empty]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/longrunning"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Longrunning::Operations::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Longrunning::CancelOperationRequest.new
+              #
+              #   # Call the cancel_operation method.
+              #   result = client.cancel_operation request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def cancel_operation request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 

data/lib/google/cloud/channel/v1/cloud_channel_reports_service/rest.rb

@@ -36,6 +36,11 @@ module Google
         # distributors retrieve and combine a variety of data in Cloud Channel for
         # 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.
+        #
         # To load this service and instantiate a REST client:
         #
         #     require "google/cloud/channel/v1/cloud_channel_reports_service/rest"

data/lib/google/cloud/channel/v1/cloud_channel_reports_service.rb

@@ -37,6 +37,11 @@ module Google
         # distributors retrieve and combine a variety of data in Cloud Channel for
         # 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.
+        #
         # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/channel/v1/cloud_channel_reports_service"