From c6050069aa75b31a262ff243c9f5407707926856 Mon Sep 17 00:00:00 2001
From: "gcf-owl-bot[bot]" <78513119+gcf-owl-bot[bot]@users.noreply.github.com>
Date: Wed, 30 Oct 2024 10:05:12 -0700
Subject: [PATCH] feat: [contentwarehouse] Updated the exponential backoff
 settings for the Document AI ProcessDocument and BatchProcessDocuments
 methods (#5763)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* feat: Updated the exponential backoff settings for the Document AI ProcessDocument and BatchProcessDocuments methods
feat: Add RESOURCE_EXHAUSTED to retryable status codes for ProcessDocument method
feat: Added an url for issue reporting and api short name

PiperOrigin-RevId: 688214664

Source-Link: https://github.com/googleapis/googleapis/commit/76ca663d1df1cdd8e48f45af6e84212c551533ed

Source-Link: https://github.com/googleapis/googleapis-gen/commit/6ad97277430744dd9c73e7ff397dce00547d8e0c
Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWNvbnRlbnR3YXJlaG91c2UvLk93bEJvdC55YW1sIiwiaCI6IjZhZDk3Mjc3NDMwNzQ0ZGQ5YzczZTdmZjM5N2RjZTAwNTQ3ZDhlMGMifQ==

* 🦉 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: sofisl <55454395+sofisl@users.noreply.github.com>
---
 packages/google-cloud-contentwarehouse/README.md             | 4 ++--
 .../protos/google/cloud/documentai/v1/document_io.proto      | 3 ++-
 .../cloud/documentai/v1/document_processor_service.proto     | 5 +++--
 packages/google-cloud-contentwarehouse/protos/protos.json    | 3 +++
 4 files changed, 10 insertions(+), 5 deletions(-)

diff --git a/packages/google-cloud-contentwarehouse/README.md b/packages/google-cloud-contentwarehouse/README.md
index 564b5ef1b61..fe6991379c5 100644
--- a/packages/google-cloud-contentwarehouse/README.md
+++ b/packages/google-cloud-contentwarehouse/README.md
@@ -44,7 +44,7 @@ Google APIs Client Libraries, in [Client Libraries Explained][explained].
 1.  [Select or create a Cloud Platform project][projects].
 1.  [Enable billing for your project][billing].
 1.  [Enable the Document AI Warehouse API][enable_api].
-1.  [Set up authentication with a service account][auth] so you can access the
+1.  [Set up authentication][auth] so you can access the
     API from your local workstation.
 
 ### Installing the client library
@@ -212,4 +212,4 @@ See [LICENSE](https://github.com/googleapis/google-cloud-node/blob/main/LICENSE)
 [projects]: https://console.cloud.google.com/project
 [billing]: https://support.google.com/cloud/answer/6293499#enable-billing
 [enable_api]: https://console.cloud.google.com/flows/enableapi?apiid=contentwarehouse.googleapis.com
-[auth]: https://cloud.google.com/docs/authentication/getting-started
+[auth]: https://cloud.google.com/docs/authentication/external/set-up-adc-local
diff --git a/packages/google-cloud-contentwarehouse/protos/google/cloud/documentai/v1/document_io.proto b/packages/google-cloud-contentwarehouse/protos/google/cloud/documentai/v1/document_io.proto
index a84bfc4fba6..b18537f30b9 100644
--- a/packages/google-cloud-contentwarehouse/protos/google/cloud/documentai/v1/document_io.proto
+++ b/packages/google-cloud-contentwarehouse/protos/google/cloud/documentai/v1/document_io.proto
@@ -66,7 +66,8 @@ message GcsPrefix {
 
 // The common config to specify a set of documents used as input.
 message BatchDocumentsInputConfig {
-  // The source.
+  // The source. Make sure that the caller of the API has storage.objects.get
+  // access to the buckets.
   oneof source {
     // The set of documents that match the specified Cloud Storage `gcs_prefix`.
     GcsPrefix gcs_prefix = 1;
diff --git a/packages/google-cloud-contentwarehouse/protos/google/cloud/documentai/v1/document_processor_service.proto b/packages/google-cloud-contentwarehouse/protos/google/cloud/documentai/v1/document_processor_service.proto
index a39ba6ded05..03ca4730266 100644
--- a/packages/google-cloud-contentwarehouse/protos/google/cloud/documentai/v1/document_processor_service.proto
+++ b/packages/google-cloud-contentwarehouse/protos/google/cloud/documentai/v1/document_processor_service.proto
@@ -359,8 +359,9 @@ message ProcessOptions {
   // If a page range is set, only the given pages are extracted and processed
   // from the document. In the output document,
   // [Document.Page.page_number][google.cloud.documentai.v1.Document.Page.page_number]
-  // refers to the page number in the original document. This configuration
-  // only applies to sync requests.
+  // refers to the page number in the original document.
+  // This configuration only applies to online processing with
+  // [ProcessDocument][google.cloud.documentai.v1.DocumentProcessorService.ProcessDocument].
   oneof page_range {
     // Which pages to process (1-indexed).
     IndividualPageSelector individual_page_selector = 5;
diff --git a/packages/google-cloud-contentwarehouse/protos/protos.json b/packages/google-cloud-contentwarehouse/protos/protos.json
index fc996899dc9..0e396e15b38 100644
--- a/packages/google-cloud-contentwarehouse/protos/protos.json
+++ b/packages/google-cloud-contentwarehouse/protos/protos.json
@@ -1,4 +1,7 @@
 {
+  "options": {
+    "syntax": "proto3"
+  },
   "nested": {
     "google": {
       "nested": {