feat(cloudchannel): update the API

#### cloudchannel:v1 The following keys were added: - resources.accounts.resources.reportJobs.deprecated - resources.accounts.resources.reportJobs.methods.fetchReportResults.deprecated - resources.accounts.resources.reports.deprecated - resources.accounts.resources.reports.methods.list.deprecated - resources.accounts.resources.reports.methods.run.deprecated - schemas.GoogleCloudChannelV1Column.deprecated - schemas.GoogleCloudChannelV1DateRange.deprecated - schemas.GoogleCloudChannelV1FetchReportResultsRequest.deprecated - schemas.GoogleCloudChannelV1FetchReportResultsResponse.deprecated - schemas.GoogleCloudChannelV1ListReportsResponse.deprecated - schemas.GoogleCloudChannelV1Report.deprecated - schemas.GoogleCloudChannelV1ReportJob.deprecated - schemas.GoogleCloudChannelV1ReportResultsMetadata.deprecated - schemas.GoogleCloudChannelV1ReportStatus.deprecated - schemas.GoogleCloudChannelV1ReportValue.deprecated - schemas.GoogleCloudChannelV1Row.deprecated - schemas.GoogleCloudChannelV1RunReportJobRequest.deprecated - schemas.GoogleCloudChannelV1RunReportJobResponse.deprecated - schemas.GoogleCloudChannelV1alpha1Column.deprecated - schemas.GoogleCloudChannelV1alpha1DateRange.deprecated - schemas.GoogleCloudChannelV1alpha1Report.deprecated - schemas.GoogleCloudChannelV1alpha1ReportJob.deprecated - schemas.GoogleCloudChannelV1alpha1ReportResultsMetadata.deprecated - schemas.GoogleCloudChannelV1alpha1ReportStatus.deprecated - schemas.GoogleCloudChannelV1alpha1RunReportJobResponse.deprecated The following keys were changed: - resources.accounts.resources.reportJobs.methods.fetchReportResults.description - resources.accounts.resources.reports.methods.list.description - resources.accounts.resources.reports.methods.run.description
googleapis · Jan 3, 2024 · aecac6b · aecac6b
1 parent ddf4c10
commit aecac6b
Show file tree

Hide file tree

Showing 2 changed files with 32 additions and 7 deletions.
diff --git a/discovery/cloudchannel-v1.json b/discovery/cloudchannel-v1.json
@@ -1773,9 +1773,11 @@
           }
         },
         "reportJobs": {
+          "deprecated": true,
           "methods": {
             "fetchReportResults": {
-              "description": "Retrieves data generated by CloudChannelReportsService.RunReportJob.",
+              "deprecated": true,
+              "description": "Retrieves data generated by CloudChannelReportsService.RunReportJob. Deprecated: Please use [Export Channel Services data to BigQuery](https://cloud.google.com/channel/docs/rebilling/export-data-to-bigquery) instead.",
               "flatPath": "v1/accounts/{accountsId}/reportJobs/{reportJobsId}:fetchReportResults",
               "httpMethod": "POST",
               "id": "cloudchannel.accounts.reportJobs.fetchReportResults",
@@ -1805,9 +1807,11 @@
           }
         },
         "reports": {
+          "deprecated": true,
           "methods": {
             "list": {
-              "description": "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": true,
+              "description": "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.",
               "flatPath": "v1/accounts/{accountsId}/reports",
               "httpMethod": "GET",
               "id": "cloudchannel.accounts.reports.list",
@@ -1848,7 +1852,8 @@
               ]
             },
             "run": {
-              "description": "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.",
+              "deprecated": true,
+              "description": "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. Deprecated: Please use [Export Channel Services data to BigQuery](https://cloud.google.com/channel/docs/rebilling/export-data-to-bigquery) instead.",
               "flatPath": "v1/accounts/{accountsId}/reports/{reportsId}:run",
               "httpMethod": "POST",
               "id": "cloudchannel.accounts.reports.run",
@@ -2178,7 +2183,7 @@
       }
     }
   },
-  "revision": "20230920",
+  "revision": "20231220",
   "rootUrl": "https://cloudchannel.googleapis.com/",
   "schemas": {
     "GoogleCloudChannelV1ActivateEntitlementRequest": {
@@ -2550,6 +2555,7 @@
       "type": "object"
     },
     "GoogleCloudChannelV1Column": {
+      "deprecated": true,
       "description": "The definition of a report column. Specifies the data properties in the corresponding position of the report rows.",
       "id": "GoogleCloudChannelV1Column",
       "properties": {
@@ -2860,6 +2866,7 @@
       "type": "object"
     },
     "GoogleCloudChannelV1DateRange": {
+      "deprecated": true,
       "description": "A representation of usage or invoice date ranges.",
       "id": "GoogleCloudChannelV1DateRange",
       "properties": {
@@ -3226,6 +3233,7 @@
       "type": "object"
     },
     "GoogleCloudChannelV1FetchReportResultsRequest": {
+      "deprecated": true,
       "description": "Request message for CloudChannelReportsService.FetchReportResults.",
       "id": "GoogleCloudChannelV1FetchReportResultsRequest",
       "properties": {
@@ -3249,6 +3257,7 @@
       "type": "object"
     },
     "GoogleCloudChannelV1FetchReportResultsResponse": {
+      "deprecated": true,
       "description": "Response message for CloudChannelReportsService.FetchReportResults. Contains a tabular representation of the report results.",
       "id": "GoogleCloudChannelV1FetchReportResultsResponse",
       "properties": {
@@ -3482,6 +3491,7 @@
       "type": "object"
     },
     "GoogleCloudChannelV1ListReportsResponse": {
+      "deprecated": true,
       "description": "Response message for CloudChannelReportsService.ListReports.",
       "id": "GoogleCloudChannelV1ListReportsResponse",
       "properties": {
@@ -4265,6 +4275,7 @@
       "type": "object"
     },
     "GoogleCloudChannelV1Report": {
+      "deprecated": true,
       "description": "The ID and description of a report that was used to generate report data. For example, \"Google Cloud Daily Spend\", \"Google Workspace License Activity\", etc.",
       "id": "GoogleCloudChannelV1Report",
       "properties": {
@@ -4291,6 +4302,7 @@
       "type": "object"
     },
     "GoogleCloudChannelV1ReportJob": {
+      "deprecated": true,
       "description": "The result of a RunReportJob operation. Contains the name to use in FetchReportResultsRequest.report_job and the status of the operation.",
       "id": "GoogleCloudChannelV1ReportJob",
       "properties": {
@@ -4306,6 +4318,7 @@
       "type": "object"
     },
     "GoogleCloudChannelV1ReportResultsMetadata": {
+      "deprecated": true,
       "description": "The features describing the data. Returned by CloudChannelReportsService.RunReportJob and CloudChannelReportsService.FetchReportResults.",
       "id": "GoogleCloudChannelV1ReportResultsMetadata",
       "properties": {
@@ -4330,6 +4343,7 @@
       "type": "object"
     },
     "GoogleCloudChannelV1ReportStatus": {
+      "deprecated": true,
       "description": "Status of a report generation process.",
       "id": "GoogleCloudChannelV1ReportStatus",
       "properties": {
@@ -4365,6 +4379,7 @@
       "type": "object"
     },
     "GoogleCloudChannelV1ReportValue": {
+      "deprecated": true,
       "description": "A single report value.",
       "id": "GoogleCloudChannelV1ReportValue",
       "properties": {
@@ -4482,6 +4497,7 @@
       "type": "object"
     },
     "GoogleCloudChannelV1Row": {
+      "deprecated": true,
       "description": "A row of report values.",
       "id": "GoogleCloudChannelV1Row",
       "properties": {
@@ -4500,6 +4516,7 @@
       "type": "object"
     },
     "GoogleCloudChannelV1RunReportJobRequest": {
+      "deprecated": true,
       "description": "Request message for CloudChannelReportsService.RunReportJob.",
       "id": "GoogleCloudChannelV1RunReportJobRequest",
       "properties": {
@@ -4519,6 +4536,7 @@
       "type": "object"
     },
     "GoogleCloudChannelV1RunReportJobResponse": {
+      "deprecated": true,
       "description": "Response message for CloudChannelReportsService.RunReportJob.",
       "id": "GoogleCloudChannelV1RunReportJobResponse",
       "properties": {
@@ -4877,6 +4895,7 @@
       "type": "object"
     },
     "GoogleCloudChannelV1alpha1Column": {
+      "deprecated": true,
       "description": "The definition of a report column. Specifies the data properties in the corresponding position of the report rows.",
       "id": "GoogleCloudChannelV1alpha1Column",
       "properties": {
@@ -4962,6 +4981,7 @@
       "type": "object"
     },
     "GoogleCloudChannelV1alpha1DateRange": {
+      "deprecated": true,
       "description": "A representation of usage or invoice date ranges.",
       "id": "GoogleCloudChannelV1alpha1DateRange",
       "properties": {
@@ -5346,6 +5366,7 @@
       "type": "object"
     },
     "GoogleCloudChannelV1alpha1Report": {
+      "deprecated": true,
       "description": "The ID and description of a report that was used to generate report data. For example, \"Google Cloud Daily Spend\", \"Google Workspace License Activity\", etc.",
       "id": "GoogleCloudChannelV1alpha1Report",
       "properties": {
@@ -5372,6 +5393,7 @@
       "type": "object"
     },
     "GoogleCloudChannelV1alpha1ReportJob": {
+      "deprecated": true,
       "description": "The result of a RunReportJob operation. Contains the name to use in FetchReportResultsRequest.report_job and the status of the operation.",
       "id": "GoogleCloudChannelV1alpha1ReportJob",
       "properties": {
@@ -5387,6 +5409,7 @@
       "type": "object"
     },
     "GoogleCloudChannelV1alpha1ReportResultsMetadata": {
+      "deprecated": true,
       "description": "The features describing the data. Returned by CloudChannelReportsService.RunReportJob and CloudChannelReportsService.FetchReportResults.",
       "id": "GoogleCloudChannelV1alpha1ReportResultsMetadata",
       "properties": {
@@ -5411,6 +5434,7 @@
       "type": "object"
     },
     "GoogleCloudChannelV1alpha1ReportStatus": {
+      "deprecated": true,
       "description": "Status of a report generation process.",
       "id": "GoogleCloudChannelV1alpha1ReportStatus",
       "properties": {
@@ -5446,6 +5470,7 @@
       "type": "object"
     },
     "GoogleCloudChannelV1alpha1RunReportJobResponse": {
+      "deprecated": true,
       "description": "Response message for CloudChannelReportsService.RunReportJob.",
       "id": "GoogleCloudChannelV1alpha1RunReportJobResponse",
       "properties": {

diff --git a/src/apis/cloudchannel/v1.ts b/src/apis/cloudchannel/v1.ts
@@ -8163,7 +8163,7 @@ export namespace cloudchannel_v1 {
     }
 
     /**
-     * Retrieves data generated by CloudChannelReportsService.RunReportJob.
+     * Retrieves data generated by CloudChannelReportsService.RunReportJob. Deprecated: Please use [Export Channel Services data to BigQuery](https://cloud.google.com/channel/docs/rebilling/export-data-to-bigquery) instead.
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -8279,7 +8279,7 @@ export namespace cloudchannel_v1 {
     }
 
     /**
-     * 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.
+     * 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.
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -8375,7 +8375,7 @@ export namespace cloudchannel_v1 {
     }
 
     /**
-     * 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.
+     * 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. Deprecated: Please use [Export Channel Services data to BigQuery](https://cloud.google.com/channel/docs/rebilling/export-data-to-bigquery) instead.
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.