feat(documentai): update the API

#### documentai:v1beta3

The following keys were added:
- schemas.CloudAiDocumentaiLabHifiaToolsValidationValidatorInputValidationRule.description
- schemas.CloudAiDocumentaiLabHifiaToolsValidationValidatorInputValidationRule.properties.ruleId.description
- schemas.CloudAiDocumentaiLabHifiaToolsValidationValidatorInputValidationRule.properties.ruleId.type

The following keys were changed:
- resources.projects.resources.locations.methods.list.parameters.extraLocationTypes.description
- schemas.CloudAiDocumentaiLabHifiaToolsValidationValidatorInput.description

#### documentai:v1

The following keys were added:
- schemas.CloudAiDocumentaiLabHifiaToolsValidationValidatorInputValidationRule.description
- schemas.CloudAiDocumentaiLabHifiaToolsValidationValidatorInputValidationRule.properties.ruleId.description
- schemas.CloudAiDocumentaiLabHifiaToolsValidationValidatorInputValidationRule.properties.ruleId.type

The following keys were changed:
- resources.projects.resources.locations.methods.list.parameters.extraLocationTypes.description
- schemas.CloudAiDocumentaiLabHifiaToolsValidationValidatorInput.description

Author: yoshi-automation

discovery/documentai-v1.json

@@ -198,7 +198,7 @@
               ],
               "parameters": {
                 "extraLocationTypes": {
-                  "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.",
+                  "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.",
                   "location": "query",
                   "repeated": true,
                   "type": "string"
@@ -1392,11 +1392,11 @@
       }
     }
   },
-  "revision": "20251020",
+  "revision": "20251030",
   "rootUrl": "https://documentai.googleapis.com/",
   "schemas": {
     "CloudAiDocumentaiLabHifiaToolsValidationValidatorInput": {
-      "description": "Definition of the validation rules. Those are the input to the validator logic and they are used to validate a document.",
+      "description": "Definition of the validation rules. Those are the input to the validator logic and they are used to validate a document. Next ID: 3",
       "id": "CloudAiDocumentaiLabHifiaToolsValidationValidatorInput",
       "properties": {
         "validationRules": {
@@ -1409,6 +1409,7 @@
       "type": "object"
     },
     "CloudAiDocumentaiLabHifiaToolsValidationValidatorInputValidationRule": {
+      "description": "Next ID: 9",
       "id": "CloudAiDocumentaiLabHifiaToolsValidationValidatorInputValidationRule",
       "properties": {
         "childAlignmentRule": {
@@ -1433,6 +1434,10 @@
         "name": {
           "description": "Name of the validation rule.",
           "type": "string"
+        },
+        "ruleId": {
+          "description": "Unique identifier of the rule. Optional.",
+          "type": "string"
         }
       },
       "type": "object"

discovery/documentai-v1beta3.json

@@ -169,7 +169,7 @@
               ],
               "parameters": {
                 "extraLocationTypes": {
-                  "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.",
+                  "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.",
                   "location": "query",
                   "repeated": true,
                   "type": "string"
@@ -1634,11 +1634,11 @@
       }
     }
   },
-  "revision": "20251020",
+  "revision": "20251030",
   "rootUrl": "https://documentai.googleapis.com/",
   "schemas": {
     "CloudAiDocumentaiLabHifiaToolsValidationValidatorInput": {
-      "description": "Definition of the validation rules. Those are the input to the validator logic and they are used to validate a document.",
+      "description": "Definition of the validation rules. Those are the input to the validator logic and they are used to validate a document. Next ID: 3",
       "id": "CloudAiDocumentaiLabHifiaToolsValidationValidatorInput",
       "properties": {
         "validationRules": {
@@ -1651,6 +1651,7 @@
       "type": "object"
     },
     "CloudAiDocumentaiLabHifiaToolsValidationValidatorInputValidationRule": {
+      "description": "Next ID: 9",
       "id": "CloudAiDocumentaiLabHifiaToolsValidationValidatorInputValidationRule",
       "properties": {
         "childAlignmentRule": {
@@ -1675,6 +1676,10 @@
         "name": {
           "description": "Name of the validation rule.",
           "type": "string"
+        },
+        "ruleId": {
+          "description": "Unique identifier of the rule. Optional.",
+          "type": "string"
         }
       },
       "type": "object"

src/apis/documentai/v1.ts

@@ -127,11 +127,14 @@ export namespace documentai_v1 {
   }
 
   /**
-   * Definition of the validation rules. Those are the input to the validator logic and they are used to validate a document.
+   * Definition of the validation rules. Those are the input to the validator logic and they are used to validate a document. Next ID: 3
    */
   export interface Schema$CloudAiDocumentaiLabHifiaToolsValidationValidatorInput {
     validationRules?: Schema$CloudAiDocumentaiLabHifiaToolsValidationValidatorInputValidationRule[];
   }
+  /**
+   * Next ID: 9
+   */
   export interface Schema$CloudAiDocumentaiLabHifiaToolsValidationValidatorInputValidationRule {
     childAlignmentRule?: Schema$CloudAiDocumentaiLabHifiaToolsValidationValidatorInputValidationRuleChildAlignmentRule;
     /**
@@ -146,6 +149,10 @@ export namespace documentai_v1 {
      * Name of the validation rule.
      */
     name?: string | null;
+    /**
+     * Unique identifier of the rule. Optional.
+     */
+    ruleId?: string | null;
   }
   /**
    * A rule for checking field alignment. Horizontal alignment checks if fields are on the same row by comparing y-coordinates of bounding box centers, while vertical alignment checks if fields are on the same column by comparing x-coordinates of bounding box centers.
@@ -5821,7 +5828,7 @@ export namespace documentai_v1 {
      *
      *   // Do the magic
      *   const res = await documentai.projects.locations.list({
-     *     // Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.
+     *     // Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.
      *     extraLocationTypes: 'placeholder-value',
      *     // A filter to narrow down results to a preferred subset. The filtering language accepts strings like `"displayName=tokyo"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).
      *     filter: 'placeholder-value',
@@ -5964,7 +5971,7 @@ export namespace documentai_v1 {
   export interface Params$Resource$Projects$Locations$List
     extends StandardParameters {
     /**
-     * Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.
+     * Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.
      */
     extraLocationTypes?: string[];
     /**

src/apis/documentai/v1beta3.ts

@@ -125,11 +125,14 @@ export namespace documentai_v1beta3 {
   }
 
   /**
-   * Definition of the validation rules. Those are the input to the validator logic and they are used to validate a document.
+   * Definition of the validation rules. Those are the input to the validator logic and they are used to validate a document. Next ID: 3
    */
   export interface Schema$CloudAiDocumentaiLabHifiaToolsValidationValidatorInput {
     validationRules?: Schema$CloudAiDocumentaiLabHifiaToolsValidationValidatorInputValidationRule[];
   }
+  /**
+   * Next ID: 9
+   */
   export interface Schema$CloudAiDocumentaiLabHifiaToolsValidationValidatorInputValidationRule {
     childAlignmentRule?: Schema$CloudAiDocumentaiLabHifiaToolsValidationValidatorInputValidationRuleChildAlignmentRule;
     /**
@@ -144,6 +147,10 @@ export namespace documentai_v1beta3 {
      * Name of the validation rule.
      */
     name?: string | null;
+    /**
+     * Unique identifier of the rule. Optional.
+     */
+    ruleId?: string | null;
   }
   /**
    * A rule for checking field alignment. Horizontal alignment checks if fields are on the same row by comparing y-coordinates of bounding box centers, while vertical alignment checks if fields are on the same column by comparing x-coordinates of bounding box centers.
@@ -5658,7 +5665,7 @@ export namespace documentai_v1beta3 {
      *
      *   // Do the magic
      *   const res = await documentai.projects.locations.list({
-     *     // Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.
+     *     // Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.
      *     extraLocationTypes: 'placeholder-value',
      *     // A filter to narrow down results to a preferred subset. The filtering language accepts strings like `"displayName=tokyo"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).
      *     filter: 'placeholder-value',
@@ -5801,7 +5808,7 @@ export namespace documentai_v1beta3 {
   export interface Params$Resource$Projects$Locations$List
     extends StandardParameters {
     /**
-     * Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.
+     * Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.
      */
     extraLocationTypes?: string[];
     /**