docs: [google-cloud-documentai] Update the comment to add a note abou…

…t `documentai.processors.create` permission (#12807) BEGIN_COMMIT_OVERRIDE docs: Update the comment to add a note about `documentai.processors.create` permission END_COMMIT_OVERRIDE - [ ] Regenerate this pull request now. PiperOrigin-RevId: 643086644 Source-Link: googleapis/googleapis@65337c6 Source-Link: googleapis/googleapis-gen@4e96e9e Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWRvY3VtZW50YWkvLk93bEJvdC55YW1sIiwiaCI6IjRlOTZlOWUzMzBmYTlhNTI1ZDlhMmVjZDM2ZTYzODU0ZTkwZDNhOTUifQ== --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
googleapis · Jun 21, 2024 · 9318d94 · 9318d94
1 parent 4974a1f
commit 9318d94
Show file tree

Hide file tree

Showing 12 changed files with 30 additions and 12 deletions.
diff --git a/packages/google-cloud-documentai/google/cloud/documentai/gapic_version.py b/packages/google-cloud-documentai/google/cloud/documentai/gapic_version.py
@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "2.29.0"  # {x-release-please-version}
+__version__ = "0.0.0"  # {x-release-please-version}
diff --git a/packages/google-cloud-documentai/google/cloud/documentai_v1/gapic_version.py b/packages/google-cloud-documentai/google/cloud/documentai_v1/gapic_version.py
@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "2.29.0"  # {x-release-please-version}
+__version__ = "0.0.0"  # {x-release-please-version}
diff --git a/...documentai/google/cloud/documentai_v1/services/document_processor_service/async_client.py b/...documentai/google/cloud/documentai_v1/services/document_processor_service/async_client.py
@@ -1934,7 +1934,11 @@ async def create_processor(
         r"""Creates a processor from the
         [ProcessorType][google.cloud.documentai.v1.ProcessorType]
         provided. The processor will be at ``ENABLED`` state by default
-        after its creation.
+        after its creation. Note that this method requires the
+        ``documentai.processors.create`` permission on the project,
+        which is highly privileged. A user or service account with this
+        permission can create new processors that can interact with any
+        gcs bucket in your project.
 
         .. code-block:: python
 

diff --git a/...cloud-documentai/google/cloud/documentai_v1/services/document_processor_service/client.py b/...cloud-documentai/google/cloud/documentai_v1/services/document_processor_service/client.py
@@ -2385,7 +2385,11 @@ def create_processor(
         r"""Creates a processor from the
         [ProcessorType][google.cloud.documentai.v1.ProcessorType]
         provided. The processor will be at ``ENABLED`` state by default
-        after its creation.
+        after its creation. Note that this method requires the
+        ``documentai.processors.create`` permission on the project,
+        which is highly privileged. A user or service account with this
+        permission can create new processors that can interact with any
+        gcs bucket in your project.
 
         .. code-block:: python
 

diff --git a/...umentai/google/cloud/documentai_v1/services/document_processor_service/transports/grpc.py b/...umentai/google/cloud/documentai_v1/services/document_processor_service/transports/grpc.py
@@ -649,7 +649,11 @@ def create_processor(
         Creates a processor from the
         [ProcessorType][google.cloud.documentai.v1.ProcessorType]
         provided. The processor will be at ``ENABLED`` state by default
-        after its creation.
+        after its creation. Note that this method requires the
+        ``documentai.processors.create`` permission on the project,
+        which is highly privileged. A user or service account with this
+        permission can create new processors that can interact with any
+        gcs bucket in your project.
 
         Returns:
             Callable[[~.CreateProcessorRequest],

diff --git a/...google/cloud/documentai_v1/services/document_processor_service/transports/grpc_asyncio.py b/...google/cloud/documentai_v1/services/document_processor_service/transports/grpc_asyncio.py
@@ -657,7 +657,11 @@ def create_processor(
         Creates a processor from the
         [ProcessorType][google.cloud.documentai.v1.ProcessorType]
         provided. The processor will be at ``ENABLED`` state by default
-        after its creation.
+        after its creation. Note that this method requires the
+        ``documentai.processors.create`` permission on the project,
+        which is highly privileged. A user or service account with this
+        permission can create new processors that can interact with any
+        gcs bucket in your project.
 
         Returns:
             Callable[[~.CreateProcessorRequest],

diff --git a/packages/google-cloud-documentai/google/cloud/documentai_v1beta2/gapic_version.py b/packages/google-cloud-documentai/google/cloud/documentai_v1beta2/gapic_version.py
@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "2.29.0"  # {x-release-please-version}
+__version__ = "0.0.0"  # {x-release-please-version}
diff --git a/packages/google-cloud-documentai/google/cloud/documentai_v1beta3/gapic_version.py b/packages/google-cloud-documentai/google/cloud/documentai_v1beta3/gapic_version.py
@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "2.29.0"  # {x-release-please-version}
+__version__ = "0.0.0"  # {x-release-please-version}
diff --git a/packages/google-cloud-documentai/google/cloud/documentai_v1beta3/types/document_service.py b/packages/google-cloud-documentai/google/cloud/documentai_v1beta3/types/document_service.py
@@ -396,8 +396,10 @@ class ListDocumentsRequest(proto.Message):
             https://google.aip.dev/160.
 
             Currently support query strings are:
+            ------------------------------------
+
+            ``SplitType=DATASET_SPLIT_TEST|DATASET_SPLIT_TRAIN|DATASET_SPLIT_UNASSIGNED``
 
-            - ``SplitType=DATASET_SPLIT_TEST|DATASET_SPLIT_TRAIN|DATASET_SPLIT_UNASSIGNED``
             -  ``LabelingState=DOCUMENT_LABELED|DOCUMENT_UNLABELED|DOCUMENT_AUTO_LABELED``
             -  ``DisplayName=\"file_name.pdf\"``
             -  ``EntityType=abc/def``

diff --git a/...oud-documentai/samples/generated_samples/snippet_metadata_google.cloud.documentai.v1.json b/...oud-documentai/samples/generated_samples/snippet_metadata_google.cloud.documentai.v1.json
@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-cloud-documentai",
-    "version": "2.29.0"
+    "version": "0.1.0"
   },
   "snippets": [
     {

diff --git a/...ocumentai/samples/generated_samples/snippet_metadata_google.cloud.documentai.v1beta2.json b/...ocumentai/samples/generated_samples/snippet_metadata_google.cloud.documentai.v1beta2.json
@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-cloud-documentai",
-    "version": "2.29.0"
+    "version": "0.1.0"
   },
   "snippets": [
     {

diff --git a/...ocumentai/samples/generated_samples/snippet_metadata_google.cloud.documentai.v1beta3.json b/...ocumentai/samples/generated_samples/snippet_metadata_google.cloud.documentai.v1beta3.json
@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-cloud-documentai",
-    "version": "2.29.0"
+    "version": "0.1.0"
   },
   "snippets": [
     {