feat: [datacatalog] add support for admin_search in SearchCatalog() API method (#4476)

* docs: Minor formatting

PiperOrigin-RevId: 552569489

Source-Link: googleapis/googleapis@992c4f4

Source-Link: googleapis/googleapis-gen@332d2f1
Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWRhdGFjYXRhbG9nLy5Pd2xCb3QueWFtbCIsImgiOiIzMzJkMmYxY2M1NTc3MTY2NGE2MTY5N2M3MmRmMTkwMzBkNzYxMmI5In0=

* feat: add support for admin_search in SearchCatalog() API method

PiperOrigin-RevId: 553406785

Source-Link: googleapis/googleapis@ce38ea0

Source-Link: googleapis/googleapis-gen@cbd7291
Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWRhdGFjYXRhbG9nLy5Pd2xCb3QueWFtbCIsImgiOiJjYmQ3MjkxZTFlNDM4OTE4NWRkNThhY2UyZGJhYWQ1NWRlYTA0Yzc3In0=

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
Co-authored-by: Alexander Fenster <[email protected]>

Author: gcf-owl-bot[bot]

packages/google-cloud-datacatalog/README.md

@@ -319,7 +319,7 @@ also contains samples.
 
 ## Supported Node.js Versions
 
-Our client libraries follow the [Node.js release schedule](https://nodejs.org/en/about/releases/).
+Our client libraries follow the [Node.js release schedule](https://github.com/nodejs/release#release-schedule).
 Libraries are compatible with all current _active_ and _maintenance_ versions of
 Node.js.
 If you are using an end-of-life version of Node.js, we recommend that you update

packages/google-cloud-datacatalog/protos/google/cloud/datacatalog/v1/datacatalog.proto

@@ -734,6 +734,13 @@ message SearchCatalogRequest {
   //
   // If this parameter is omitted, it defaults to the descending `relevance`.
   string order_by = 5;
+
+  // Optional. If set, uses searchAll permission granted on organizations from
+  // `include_org_ids` and projects from `include_project_ids` instead of the
+  // fine grained per resource permissions when filtering the search results.
+  // The only allowed `order_by` criteria for admin_search mode is `default`.
+  // Using this flags guarantees a full recall of the search results.
+  bool admin_search = 17 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Response message for

packages/google-cloud-datacatalog/protos/google/cloud/datacatalog/v1beta1/usage.proto

@@ -28,11 +28,11 @@ option ruby_package = "Google::Cloud::DataCatalog::V1beta1";
 
 // Detailed counts on the entry's usage.
 // Caveats:
-//   - Only BigQuery tables have usage stats
-//   - The usage stats only include 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
+// - Only BigQuery tables have usage stats
+// - The usage stats only include 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
 message UsageStats {
   // The number of times that the underlying entry was successfully used.
   float total_completions = 1;