google-apis-cloudchannel_v1 0.28.0 → 0.30.0

data/lib/google/apis/cloudchannel_v1/service.rb

@@ -2275,6 +2275,133 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Retrieves data generated by CloudChannelReportsService.RunReportJob.
+        # @param [String] report_job
+        #   Required. The report job created by CloudChannelReportsService.RunReportJob.
+        #   Report_job uses the format: accounts/`account_id`/reportJobs/`report_job_id`
+        # @param [Google::Apis::CloudchannelV1::GoogleCloudChannelV1FetchReportResultsRequest] google_cloud_channel_v1_fetch_report_results_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudchannelV1::GoogleCloudChannelV1FetchReportResultsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudchannelV1::GoogleCloudChannelV1FetchReportResultsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def fetch_account_report_job_report_results(report_job, google_cloud_channel_v1_fetch_report_results_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+reportJob}:fetchReportResults', options)
+          command.request_representation = Google::Apis::CloudchannelV1::GoogleCloudChannelV1FetchReportResultsRequest::Representation
+          command.request_object = google_cloud_channel_v1_fetch_report_results_request_object
+          command.response_representation = Google::Apis::CloudchannelV1::GoogleCloudChannelV1FetchReportResultsResponse::Representation
+          command.response_class = Google::Apis::CloudchannelV1::GoogleCloudChannelV1FetchReportResultsResponse
+          command.params['reportJob'] = report_job unless report_job.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # 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.
+        # @param [String] parent
+        #   Required. The resource name of the partner account to list available reports
+        #   for. Parent uses the format: accounts/`account_id`
+        # @param [String] language_code
+        #   Optional. The BCP-47 language code, such as "en-US". If specified, the
+        #   response is localized to the corresponding language code if the original data
+        #   sources support it. Default is "en-US".
+        # @param [Fixnum] page_size
+        #   Optional. Requested page size of the report. The server might return fewer
+        #   results than requested. If unspecified, returns 20 reports. The maximum value
+        #   is 100.
+        # @param [String] page_token
+        #   Optional. A token that specifies a page of results beyond the first page.
+        #   Obtained through ListReportsResponse.next_page_token of the previous
+        #   CloudChannelReportsService.ListReports call.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudchannelV1::GoogleCloudChannelV1ListReportsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudchannelV1::GoogleCloudChannelV1ListReportsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_account_reports(parent, language_code: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+parent}/reports', options)
+          command.response_representation = Google::Apis::CloudchannelV1::GoogleCloudChannelV1ListReportsResponse::Representation
+          command.response_class = Google::Apis::CloudchannelV1::GoogleCloudChannelV1ListReportsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['languageCode'] = language_code unless language_code.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Begins generation of data for a given report. The report identifier is a UID (
+        # for example, `613bf59q`). Possible error codes: * PERMISSION_DENIED: The user
+        # doesn't have access to this report. * INVALID_ARGUMENT: Required request
+        # parameters are missing or invalid. * NOT_FOUND: The report identifier was not
+        # found. * INTERNAL: Any non-user error related to a technical issue in the
+        # backend. Contact Cloud Channel support. * UNKNOWN: Any non-user error related
+        # to a technical issue in the backend. Contact Cloud Channel support. Return
+        # value: The ID of a long-running operation. To get the results of the operation,
+        # call the GetOperation method of CloudChannelOperationsService. The Operation
+        # metadata contains an instance of OperationMetadata. To get the results of
+        # report generation, call CloudChannelReportsService.FetchReportResults with the
+        # RunReportJobResponse.report_job.
+        # @param [String] name
+        #   Required. The report's resource name. Specifies the account and report used to
+        #   generate report data. The report_id identifier is a UID (for example, `
+        #   613bf59q`). Name uses the format: accounts/`account_id`/reports/`report_id`
+        # @param [Google::Apis::CloudchannelV1::GoogleCloudChannelV1RunReportJobRequest] google_cloud_channel_v1_run_report_job_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudchannelV1::GoogleLongrunningOperation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudchannelV1::GoogleLongrunningOperation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def run_account_report(name, google_cloud_channel_v1_run_report_job_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:run', options)
+          command.request_representation = Google::Apis::CloudchannelV1::GoogleCloudChannelV1RunReportJobRequest::Representation
+          command.request_object = google_cloud_channel_v1_run_report_job_request_object
+          command.response_representation = Google::Apis::CloudchannelV1::GoogleLongrunningOperation::Representation
+          command.response_class = Google::Apis::CloudchannelV1::GoogleLongrunningOperation
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Starts asynchronous cancellation on a long-running operation. The server makes
         # a best effort to cancel the operation, but success is not guaranteed. If the
         # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.

data/lib/google/apis/cloudchannel_v1.rb

@@ -33,6 +33,9 @@ module Google
 
       # Manage users on your domain
       AUTH_APPS_ORDER = 'https://www.googleapis.com/auth/apps.order'
+
+      # View usage reports for your G Suite domain
+      AUTH_APPS_REPORTS_USAGE_READONLY = 'https://www.googleapis.com/auth/apps.reports.usage.readonly'
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-cloudchannel_v1
 version: !ruby/object:Gem::Version
-  version: 0.28.0
+  version: 0.30.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-10-31 00:00:00.000000000 Z
+date: 2023-01-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudchannel_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-cloudchannel_v1/v0.28.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-cloudchannel_v1/v0.30.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudchannel_v1
 post_install_message: 
 rdoc_options: []