feat(gkebackup): update the API

#### gkebackup:v1

The following keys were added:
- schemas.Backup.properties.troubleshootingInfo.$ref
- schemas.Backup.properties.troubleshootingInfo.description
- schemas.Backup.properties.troubleshootingInfo.readOnly
- schemas.Restore.properties.troubleshootingInfo.$ref
- schemas.Restore.properties.troubleshootingInfo.description
- schemas.Restore.properties.troubleshootingInfo.readOnly
- schemas.TroubleshootingInfo.description
- schemas.TroubleshootingInfo.id
- schemas.TroubleshootingInfo.properties.stateReasonCode.description
- schemas.TroubleshootingInfo.properties.stateReasonCode.readOnly
- schemas.TroubleshootingInfo.properties.stateReasonCode.type
- schemas.TroubleshootingInfo.properties.stateReasonUri.description
- schemas.TroubleshootingInfo.properties.stateReasonUri.readOnly
- schemas.TroubleshootingInfo.properties.stateReasonUri.type
- schemas.TroubleshootingInfo.type

Author: yoshi-automation

discovery/gkebackup-v1.json

@@ -2227,7 +2227,7 @@
       }
     }
   },
-  "revision": "20250528",
+  "revision": "20250723",
   "rootUrl": "https://gkebackup.googleapis.com/",
   "schemas": {
     "AuditConfig": {
@@ -2447,6 +2447,11 @@
           "readOnly": true,
           "type": "string"
         },
+        "troubleshootingInfo": {
+          "$ref": "TroubleshootingInfo",
+          "description": "Output only. Information about the troubleshooting steps which will provide debugging information to the end users.",
+          "readOnly": true
+        },
         "uid": {
           "description": "Output only. Server generated global unique identifier of [UUID4](https://en.wikipedia.org/wiki/Universally_unique_identifier)",
           "readOnly": true,
@@ -3779,6 +3784,11 @@
           "readOnly": true,
           "type": "string"
         },
+        "troubleshootingInfo": {
+          "$ref": "TroubleshootingInfo",
+          "description": "Output only. Information about the troubleshooting steps which will provide debugging information to the end users.",
+          "readOnly": true
+        },
         "uid": {
           "description": "Output only. Server generated global unique identifier of [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier) format.",
           "readOnly": true,
@@ -4357,6 +4367,23 @@
       },
       "type": "object"
     },
+    "TroubleshootingInfo": {
+      "description": "Stores information about troubleshooting doc for debugging a particular state of an operation (eg - backup/restore). This will be used by the end user to debug their operation failure scenario easily.",
+      "id": "TroubleshootingInfo",
+      "properties": {
+        "stateReasonCode": {
+          "description": "Output only. Unique code for each backup/restore operation failure message which helps user identify the failure.",
+          "readOnly": true,
+          "type": "string"
+        },
+        "stateReasonUri": {
+          "description": "Output only. URL for the troubleshooting doc which will help the user fix the failing backup/restore operation.",
+          "readOnly": true,
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "VolumeBackup": {
       "description": "Represents the backup of a specific persistent volume as a component of a Backup - both the record of the operation and a pointer to the underlying storage-specific artifacts.",
       "id": "VolumeBackup",

src/apis/gkebackup/v1.ts

@@ -266,6 +266,10 @@ export namespace gkebackup_v1 {
      * Output only. Human-readable description of why the backup is in the current `state`. This field is only meant for human readability and should not be used programmatically as this field is not guaranteed to be consistent.
      */
     stateReason?: string | null;
+    /**
+     * Output only. Information about the troubleshooting steps which will provide debugging information to the end users.
+     */
+    troubleshootingInfo?: Schema$TroubleshootingInfo;
     /**
      * Output only. Server generated global unique identifier of [UUID4](https://en.wikipedia.org/wiki/Universally_unique_identifier)
      */
@@ -1205,6 +1209,10 @@ export namespace gkebackup_v1 {
      * Output only. Human-readable description of why the Restore is in its current state. This field is only meant for human readability and should not be used programmatically as this field is not guaranteed to be consistent.
      */
     stateReason?: string | null;
+    /**
+     * Output only. Information about the troubleshooting steps which will provide debugging information to the end users.
+     */
+    troubleshootingInfo?: Schema$TroubleshootingInfo;
     /**
      * Output only. Server generated global unique identifier of [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier) format.
      */
@@ -1598,6 +1606,19 @@ export namespace gkebackup_v1 {
      */
     value?: string | null;
   }
+  /**
+   * Stores information about troubleshooting doc for debugging a particular state of an operation (eg - backup/restore). This will be used by the end user to debug their operation failure scenario easily.
+   */
+  export interface Schema$TroubleshootingInfo {
+    /**
+     * Output only. Unique code for each backup/restore operation failure message which helps user identify the failure.
+     */
+    stateReasonCode?: string | null;
+    /**
+     * Output only. URL for the troubleshooting doc which will help the user fix the failing backup/restore operation.
+     */
+    stateReasonUri?: string | null;
+  }
   /**
    * Represents the backup of a specific persistent volume as a component of a Backup - both the record of the operation and a pointer to the underlying storage-specific artifacts.
    */
@@ -4721,6 +4742,7 @@ export namespace gkebackup_v1 {
      *       //   "sizeBytes": "my_sizeBytes",
      *       //   "state": "my_state",
      *       //   "stateReason": "my_stateReason",
+     *       //   "troubleshootingInfo": {},
      *       //   "uid": "my_uid",
      *       //   "updateTime": "my_updateTime",
      *       //   "volumeCount": 0
@@ -5052,6 +5074,7 @@ export namespace gkebackup_v1 {
      *   //   "sizeBytes": "my_sizeBytes",
      *   //   "state": "my_state",
      *   //   "stateReason": "my_stateReason",
+     *   //   "troubleshootingInfo": {},
      *   //   "uid": "my_uid",
      *   //   "updateTime": "my_updateTime",
      *   //   "volumeCount": 0
@@ -5667,6 +5690,7 @@ export namespace gkebackup_v1 {
      *       //   "sizeBytes": "my_sizeBytes",
      *       //   "state": "my_state",
      *       //   "stateReason": "my_stateReason",
+     *       //   "troubleshootingInfo": {},
      *       //   "uid": "my_uid",
      *       //   "updateTime": "my_updateTime",
      *       //   "volumeCount": 0
@@ -10257,6 +10281,7 @@ export namespace gkebackup_v1 {
      *       //   "restoreConfig": {},
      *       //   "state": "my_state",
      *       //   "stateReason": "my_stateReason",
+     *       //   "troubleshootingInfo": {},
      *       //   "uid": "my_uid",
      *       //   "updateTime": "my_updateTime",
      *       //   "volumeDataRestorePolicyOverrides": [],
@@ -10576,6 +10601,7 @@ export namespace gkebackup_v1 {
      *   //   "restoreConfig": {},
      *   //   "state": "my_state",
      *   //   "stateReason": "my_stateReason",
+     *   //   "troubleshootingInfo": {},
      *   //   "uid": "my_uid",
      *   //   "updateTime": "my_updateTime",
      *   //   "volumeDataRestorePolicyOverrides": [],
@@ -11027,6 +11053,7 @@ export namespace gkebackup_v1 {
      *       //   "restoreConfig": {},
      *       //   "state": "my_state",
      *       //   "stateReason": "my_stateReason",
+     *       //   "troubleshootingInfo": {},
      *       //   "uid": "my_uid",
      *       //   "updateTime": "my_updateTime",
      *       //   "volumeDataRestorePolicyOverrides": [],