docs: [google-cloud-documentai] Update the comment to add a note about documentai.processors.create permission (#12807)

gcf-owl-bot[bot] · web-flow · commit 9318d94ce12b · 2024-06-21T09:42:59.000-07:00
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>
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/packages/google-cloud-documentai/google/cloud/documentai_v1/services/document_processor_service/async_client.py b/packages/google-cloud-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/packages/google-cloud-documentai/google/cloud/documentai_v1/services/document_processor_service/client.py b/packages/google-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/packages/google-cloud-documentai/google/cloud/documentai_v1/services/document_processor_service/transports/grpc.py b/packages/google-cloud-documentai/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/packages/google-cloud-documentai/google/cloud/documentai_v1/services/document_processor_service/transports/grpc_asyncio.py b/packages/google-cloud-documentai/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/packages/google-cloud-documentai/samples/generated_samples/snippet_metadata_google.cloud.documentai.v1.json b/packages/google-cloud-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/packages/google-cloud-documentai/samples/generated_samples/snippet_metadata_google.cloud.documentai.v1beta2.json b/packages/google-cloud-documentai/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/packages/google-cloud-documentai/samples/generated_samples/snippet_metadata_google.cloud.documentai.v1beta3.json b/packages/google-cloud-documentai/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": [
     {

Original file line number	Diff line number	Diff line change
`@@ -13,4 +13,4 @@`
`13`	`13`	`# See the License for the specific language governing permissions and`
`14`	`14`	`# limitations under the License.`
`15`	`15`	`#`
`16`		`-__version__ = "2.29.0" # {x-release-please-version}`
	`16`	`+__version__ = "0.0.0" # {x-release-please-version}`
Original file line number	Diff line number	Diff line change
`@@ -8,7 +8,7 @@`
`8`	`8`	`],`
`9`	`9`	`"language": "PYTHON",`
`10`	`10`	`"name": "google-cloud-documentai",`
`11`		`- "version": "2.29.0"`
	`11`	`+ "version": "0.1.0"`
`12`	`12`	`},`
`13`	`13`	`"snippets": [`
`14`	`14`	`{`