docs(google-cloud-channel-v1): Deprecation note for RunReportJob in…

… service `CloudChannelReportsService` (#23698)

docs(google-cloud-channel-v1): Deprecation note for method `FetchReportResults` in service `CloudChannelReportsService`
docs(google-cloud-channel-v1): Deprecation note for method `ListReports` in service `CloudChannelReportsService`

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

@@ -37,6 +37,11 @@ module V1
  # 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"

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

@@ -31,6 +31,11 @@ module CloudChannelReportsService
  # 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 @@ class Client
  # 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
@@ -187,6 +194,12 @@ def initialize
  # 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.
@@ -303,6 +316,12 @@ def run_report_job request, options = nil
  # 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.
@@ -414,6 +433,12 @@ def fetch_report_results request, options = nil
  # 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.

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

@@ -36,6 +36,11 @@ module V1
  # 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"

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

@@ -33,6 +33,11 @@ module Rest
  # 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 @@ class Client
  # 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 @@ def initialize
  # 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.
@@ -286,6 +297,10 @@ def run_report_job request, options = nil
  # 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.
@@ -390,6 +405,10 @@ def fetch_report_results request, options = nil
  # 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.