chore: Update discovery artifacts (#1346)

## Discovery Artifact Change Summary:
datacatalogv1beta1[ [More details]](c26eace)

chore(classroom): update the api
feat(datacatalog): update the api
chore(metastore): update the api
chore(tpu): update the api
chore(docs): Add new discovery artifacts and reference documents

docs/dyn/bigtableadmin_v2.projects.locations.html

@@ -126,7 +126,7 @@ <h3>Method Details</h3>
 Args:
   name: string, The resource that owns the locations collection, if applicable. (required)
   filter: string, A filter to narrow down results to a preferred subset. The filtering language accepts strings like &quot;displayName=tokyo&quot;, and is documented in more detail in [AIP-160](https://google.aip.dev/160).
-  pageSize: integer, The maximum number of results to return. If not set, the service selects a default.
+  pageSize: integer, The maximum number of results to return. If not set, the service will select a default.
   pageToken: string, A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.
   x__xgafv: string, V1 error format.
     Allowed values

docs/dyn/datacatalog_v1beta1.entries.html

@@ -156,6 +156,17 @@ <h3>Method Details</h3>
     &quot;updateTime&quot;: &quot;A String&quot;, # The last-modified time of the resource within the given system.
   },
   &quot;type&quot;: &quot;A String&quot;, # The type of the entry. Only used for Entries with types in the EntryType enum.
+  &quot;usageSignal&quot;: { # The set of all usage signals that we store in Data Catalog. # Output only. Statistics on the usage level of the resource.
+    &quot;updateTime&quot;: &quot;A String&quot;, # The timestamp of the end of the usage statistics duration.
+    &quot;usageWithinTimeRange&quot;: { # Usage statistics over each of the pre-defined time ranges, supported strings for time ranges are {&quot;24H&quot;, &quot;7D&quot;, &quot;30D&quot;}.
+      &quot;a_key&quot;: { # Detailed counts on the entry&#x27;s usage. Caveats: - Only BigQuery tables have usage stats - The usage stats only inlude BigQuery query jobs - The usage stats might be underestimated, e.g. wildcard table references are not yet counted in usage computation https://cloud.google.com/bigquery/docs/querying-wildcard-tables
+        &quot;totalCancellations&quot;: 3.14, # The number of times that the underlying entry was attempted to be used but was cancelled by the user.
+        &quot;totalCompletions&quot;: 3.14, # The number of times that the underlying entry was successfully used.
+        &quot;totalExecutionTimeForCompletionsMillis&quot;: 3.14, # Total time spent (in milliseconds) during uses the resulted in completions.
+        &quot;totalFailures&quot;: 3.14, # The number of times that the underlying entry was attempted to be used but failed.
+      },
+    },
+  },
   &quot;userSpecifiedSystem&quot;: &quot;A String&quot;, # This field indicates the entry&#x27;s source system that Data Catalog does not integrate with. `user_specified_system` strings must begin with a letter or underscore and can only contain letters, numbers, and underscores; are case insensitive; must be at least 1 character and at most 64 characters long.
   &quot;userSpecifiedType&quot;: &quot;A String&quot;, # Entry type if it does not fit any of the input-allowed values listed in `EntryType` enum above. When creating an entry, users should check the enum values first, if nothing matches the entry to be created, then provide a custom value, for example &quot;my_special_type&quot;. `user_specified_type` strings must begin with a letter or underscore and can only contain letters, numbers, and underscores; are case insensitive; must be at least 1 character and at most 64 characters long. Currently, only FILESET enum value is allowed. All other entries created through Data Catalog must use `user_specified_type`.
 }</pre>

docs/dyn/dlp_v2.organizations.deidentifyTemplates.html

@@ -383,7 +383,7 @@ <h3>Method Details</h3>
                 &quot;logicalOperator&quot;: &quot;A String&quot;, # The operator to apply to the result of conditions. Default and currently only supported value is `AND`.
               },
             },
-            &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to. When you have columns that reference their position within a list, omit the index from the FieldId. FieldId name matching ignores the index. For example, instead of &quot;contact.nums[0].type&quot;, use &quot;contact.nums.type&quot;.
+            &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to.
               { # General identifier of a data field in a storage service.
                 &quot;name&quot;: &quot;A String&quot;, # Name describing the field.
               },
@@ -1178,7 +1178,7 @@ <h3>Method Details</h3>
               &quot;logicalOperator&quot;: &quot;A String&quot;, # The operator to apply to the result of conditions. Default and currently only supported value is `AND`.
             },
           },
-          &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to. When you have columns that reference their position within a list, omit the index from the FieldId. FieldId name matching ignores the index. For example, instead of &quot;contact.nums[0].type&quot;, use &quot;contact.nums.type&quot;.
+          &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to.
             { # General identifier of a data field in a storage service.
               &quot;name&quot;: &quot;A String&quot;, # Name describing the field.
             },
@@ -1995,7 +1995,7 @@ <h3>Method Details</h3>
               &quot;logicalOperator&quot;: &quot;A String&quot;, # The operator to apply to the result of conditions. Default and currently only supported value is `AND`.
             },
           },
-          &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to. When you have columns that reference their position within a list, omit the index from the FieldId. FieldId name matching ignores the index. For example, instead of &quot;contact.nums[0].type&quot;, use &quot;contact.nums.type&quot;.
+          &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to.
             { # General identifier of a data field in a storage service.
               &quot;name&quot;: &quot;A String&quot;, # Name describing the field.
             },
@@ -2800,7 +2800,7 @@ <h3>Method Details</h3>
                   &quot;logicalOperator&quot;: &quot;A String&quot;, # The operator to apply to the result of conditions. Default and currently only supported value is `AND`.
                 },
               },
-              &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to. When you have columns that reference their position within a list, omit the index from the FieldId. FieldId name matching ignores the index. For example, instead of &quot;contact.nums[0].type&quot;, use &quot;contact.nums.type&quot;.
+              &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to.
                 { # General identifier of a data field in a storage service.
                   &quot;name&quot;: &quot;A String&quot;, # Name describing the field.
                 },
@@ -3612,7 +3612,7 @@ <h3>Method Details</h3>
                 &quot;logicalOperator&quot;: &quot;A String&quot;, # The operator to apply to the result of conditions. Default and currently only supported value is `AND`.
               },
             },
-            &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to. When you have columns that reference their position within a list, omit the index from the FieldId. FieldId name matching ignores the index. For example, instead of &quot;contact.nums[0].type&quot;, use &quot;contact.nums.type&quot;.
+            &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to.
               { # General identifier of a data field in a storage service.
                 &quot;name&quot;: &quot;A String&quot;, # Name describing the field.
               },
@@ -4406,7 +4406,7 @@ <h3>Method Details</h3>
               &quot;logicalOperator&quot;: &quot;A String&quot;, # The operator to apply to the result of conditions. Default and currently only supported value is `AND`.
             },
           },
-          &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to. When you have columns that reference their position within a list, omit the index from the FieldId. FieldId name matching ignores the index. For example, instead of &quot;contact.nums[0].type&quot;, use &quot;contact.nums.type&quot;.
+          &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to.
             { # General identifier of a data field in a storage service.
               &quot;name&quot;: &quot;A String&quot;, # Name describing the field.
             },

docs/dyn/dlp_v2.organizations.locations.deidentifyTemplates.html

@@ -383,7 +383,7 @@ <h3>Method Details</h3>
                 &quot;logicalOperator&quot;: &quot;A String&quot;, # The operator to apply to the result of conditions. Default and currently only supported value is `AND`.
               },
             },
-            &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to. When you have columns that reference their position within a list, omit the index from the FieldId. FieldId name matching ignores the index. For example, instead of &quot;contact.nums[0].type&quot;, use &quot;contact.nums.type&quot;.
+            &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to.
               { # General identifier of a data field in a storage service.
                 &quot;name&quot;: &quot;A String&quot;, # Name describing the field.
               },
@@ -1178,7 +1178,7 @@ <h3>Method Details</h3>
               &quot;logicalOperator&quot;: &quot;A String&quot;, # The operator to apply to the result of conditions. Default and currently only supported value is `AND`.
             },
           },
-          &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to. When you have columns that reference their position within a list, omit the index from the FieldId. FieldId name matching ignores the index. For example, instead of &quot;contact.nums[0].type&quot;, use &quot;contact.nums.type&quot;.
+          &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to.
             { # General identifier of a data field in a storage service.
               &quot;name&quot;: &quot;A String&quot;, # Name describing the field.
             },
@@ -1995,7 +1995,7 @@ <h3>Method Details</h3>
               &quot;logicalOperator&quot;: &quot;A String&quot;, # The operator to apply to the result of conditions. Default and currently only supported value is `AND`.
             },
           },
-          &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to. When you have columns that reference their position within a list, omit the index from the FieldId. FieldId name matching ignores the index. For example, instead of &quot;contact.nums[0].type&quot;, use &quot;contact.nums.type&quot;.
+          &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to.
             { # General identifier of a data field in a storage service.
               &quot;name&quot;: &quot;A String&quot;, # Name describing the field.
             },
@@ -2800,7 +2800,7 @@ <h3>Method Details</h3>
                   &quot;logicalOperator&quot;: &quot;A String&quot;, # The operator to apply to the result of conditions. Default and currently only supported value is `AND`.
                 },
               },
-              &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to. When you have columns that reference their position within a list, omit the index from the FieldId. FieldId name matching ignores the index. For example, instead of &quot;contact.nums[0].type&quot;, use &quot;contact.nums.type&quot;.
+              &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to.
                 { # General identifier of a data field in a storage service.
                   &quot;name&quot;: &quot;A String&quot;, # Name describing the field.
                 },
@@ -3612,7 +3612,7 @@ <h3>Method Details</h3>
                 &quot;logicalOperator&quot;: &quot;A String&quot;, # The operator to apply to the result of conditions. Default and currently only supported value is `AND`.
               },
             },
-            &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to. When you have columns that reference their position within a list, omit the index from the FieldId. FieldId name matching ignores the index. For example, instead of &quot;contact.nums[0].type&quot;, use &quot;contact.nums.type&quot;.
+            &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to.
               { # General identifier of a data field in a storage service.
                 &quot;name&quot;: &quot;A String&quot;, # Name describing the field.
               },
@@ -4406,7 +4406,7 @@ <h3>Method Details</h3>
               &quot;logicalOperator&quot;: &quot;A String&quot;, # The operator to apply to the result of conditions. Default and currently only supported value is `AND`.
             },
           },
-          &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to. When you have columns that reference their position within a list, omit the index from the FieldId. FieldId name matching ignores the index. For example, instead of &quot;contact.nums[0].type&quot;, use &quot;contact.nums.type&quot;.
+          &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to.
             { # General identifier of a data field in a storage service.
               &quot;name&quot;: &quot;A String&quot;, # Name describing the field.
             },

docs/dyn/dlp_v2.projects.content.html

@@ -372,7 +372,7 @@ <h3>Method Details</h3>
               &quot;logicalOperator&quot;: &quot;A String&quot;, # The operator to apply to the result of conditions. Default and currently only supported value is `AND`.
             },
           },
-          &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to. When you have columns that reference their position within a list, omit the index from the FieldId. FieldId name matching ignores the index. For example, instead of &quot;contact.nums[0].type&quot;, use &quot;contact.nums.type&quot;.
+          &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to.
             { # General identifier of a data field in a storage service.
               &quot;name&quot;: &quot;A String&quot;, # Name describing the field.
             },
@@ -1143,7 +1143,7 @@ <h3>Method Details</h3>
                 &quot;logicalOperator&quot;: &quot;A String&quot;, # The operator to apply to the result of conditions. Default and currently only supported value is `AND`.
               },
             },
-            &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to. When you have columns that reference their position within a list, omit the index from the FieldId. FieldId name matching ignores the index. For example, instead of &quot;contact.nums[0].type&quot;, use &quot;contact.nums.type&quot;.
+            &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to.
               { # General identifier of a data field in a storage service.
                 &quot;name&quot;: &quot;A String&quot;, # Name describing the field.
               },
@@ -2648,7 +2648,7 @@ <h3>Method Details</h3>
               &quot;logicalOperator&quot;: &quot;A String&quot;, # The operator to apply to the result of conditions. Default and currently only supported value is `AND`.
             },
           },
-          &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to. When you have columns that reference their position within a list, omit the index from the FieldId. FieldId name matching ignores the index. For example, instead of &quot;contact.nums[0].type&quot;, use &quot;contact.nums.type&quot;.
+          &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to.
             { # General identifier of a data field in a storage service.
               &quot;name&quot;: &quot;A String&quot;, # Name describing the field.
             },
@@ -3247,7 +3247,7 @@ <h3>Method Details</h3>
                 &quot;logicalOperator&quot;: &quot;A String&quot;, # The operator to apply to the result of conditions. Default and currently only supported value is `AND`.
               },
             },
-            &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to. When you have columns that reference their position within a list, omit the index from the FieldId. FieldId name matching ignores the index. For example, instead of &quot;contact.nums[0].type&quot;, use &quot;contact.nums.type&quot;.
+            &quot;fields&quot;: [ # Required. Input field(s) to apply the transformation to.
               { # General identifier of a data field in a storage service.
                 &quot;name&quot;: &quot;A String&quot;, # Name describing the field.
               },