feat: A new message FoundationModelTuningOptions is added (#7241)

feat: A new field `foundation_model_tuning_options` is added to message `.google.cloud.documentai.v1.TrainProcessorVersionRequest` docs: updated comments PiperOrigin-RevId: 625415406 Source-Link: googleapis/googleapis@caa099d Source-Link: googleapis/googleapis-gen@9168448 Copy-Tag: eyJwIjoiRG9jdW1lbnRBaS8uT3dsQm90LnlhbWwiLCJoIjoiOTE2ODQ0ODZjYzg1MGM4NTY0NzkyNzIwNjk0YTIwYjhjMDRjNTA2MSJ9
googleapis · Apr 19, 2024 · 6bec4cc · 6bec4cc
1 parent 06be47c
commit 6bec4cc
Show file tree

Hide file tree

Showing 78 changed files with 677 additions and 910 deletions.
diff --git a/DocumentAi/metadata/V1/DocumentProcessorService.php b/DocumentAi/metadata/V1/DocumentProcessorService.php
diff --git a/DocumentAi/samples/V1/DocumentProcessorServiceClient/batch_process_documents.php b/DocumentAi/samples/V1/DocumentProcessorServiceClient/batch_process_documents.php
@@ -34,8 +34,7 @@
  * LRO endpoint to batch process many documents. The output is written
  * to Cloud Storage as JSON in the [Document] format.
  *
- * @param string $name The resource name of
- *                     [Processor][google.cloud.documentai.v1.Processor] or
+ * @param string $name The resource name of [Processor][google.cloud.documentai.v1.Processor] or
  *                     [ProcessorVersion][google.cloud.documentai.v1.ProcessorVersion].
  *                     Format: `projects/{project}/locations/{location}/processors/{processor}`,
  *                     or

diff --git a/DocumentAi/samples/V1/DocumentProcessorServiceClient/create_processor.php b/DocumentAi/samples/V1/DocumentProcessorServiceClient/create_processor.php
@@ -29,12 +29,11 @@
 use Google\Cloud\DocumentAI\V1\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.
+ * Creates a processor from the [ProcessorType][google.cloud.documentai.v1.ProcessorType] provided.
+ * The processor will be at `ENABLED` state by default after its creation.
  *
- * @param string $formattedParent The parent (project and location) under which to create the
- *                                processor. Format: `projects/{project}/locations/{location}`
+ * @param string $formattedParent The parent (project and location) under which to create the processor.
+ *                                Format: `projects/{project}/locations/{location}`
  *                                Please see {@see DocumentProcessorServiceClient::locationName()} for help formatting this field.
  */
 function create_processor_sample(string $formattedParent): void

diff --git a/DocumentAi/samples/V1/DocumentProcessorServiceClient/evaluate_processor_version.php b/DocumentAi/samples/V1/DocumentProcessorServiceClient/evaluate_processor_version.php
@@ -34,9 +34,7 @@
  * Evaluates a ProcessorVersion against annotated documents, producing an
  * Evaluation.
  *
- * @param string $formattedProcessorVersion The resource name of the
- *                                          [ProcessorVersion][google.cloud.documentai.v1.ProcessorVersion] to
- *                                          evaluate.
+ * @param string $formattedProcessorVersion The resource name of the [ProcessorVersion][google.cloud.documentai.v1.ProcessorVersion] to evaluate.
  *                                          `projects/{project}/locations/{location}/processors/{processor}/processorVersions/{processorVersion}`
  *                                          Please see {@see DocumentProcessorServiceClient::processorVersionName()} for help formatting this field.
  */

diff --git a/DocumentAi/samples/V1/DocumentProcessorServiceClient/fetch_processor_types.php b/DocumentAi/samples/V1/DocumentProcessorServiceClient/fetch_processor_types.php
@@ -29,8 +29,7 @@
 use Google\Cloud\DocumentAI\V1\FetchProcessorTypesResponse;
 
 /**
- * Fetches processor types. Note that we don't use
- * [ListProcessorTypes][google.cloud.documentai.v1.DocumentProcessorService.ListProcessorTypes]
+ * Fetches processor types. Note that we don't use [ListProcessorTypes][google.cloud.documentai.v1.DocumentProcessorService.ListProcessorTypes]
  * here, because it isn't paginated.
  *
  * @param string $formattedParent The location of processor types to list.

diff --git a/DocumentAi/samples/V1/DocumentProcessorServiceClient/get_evaluation.php b/DocumentAi/samples/V1/DocumentProcessorServiceClient/get_evaluation.php
@@ -31,8 +31,7 @@
 /**
  * Retrieves a specific evaluation.
  *
- * @param string $formattedName The resource name of the
- *                              [Evaluation][google.cloud.documentai.v1.Evaluation] to get.
+ * @param string $formattedName The resource name of the [Evaluation][google.cloud.documentai.v1.Evaluation] to get.
  *                              `projects/{project}/locations/{location}/processors/{processor}/processorVersions/{processorVersion}/evaluations/{evaluation}`
  *                              Please see {@see DocumentProcessorServiceClient::evaluationName()} for help formatting this field.
  */

diff --git a/DocumentAi/samples/V1/DocumentProcessorServiceClient/list_evaluations.php b/DocumentAi/samples/V1/DocumentProcessorServiceClient/list_evaluations.php
@@ -32,9 +32,7 @@
 /**
  * Retrieves a set of evaluations for a given processor version.
  *
- * @param string $formattedParent The resource name of the
- *                                [ProcessorVersion][google.cloud.documentai.v1.ProcessorVersion] to list
- *                                evaluations for.
+ * @param string $formattedParent The resource name of the [ProcessorVersion][google.cloud.documentai.v1.ProcessorVersion] to list evaluations for.
  *                                `projects/{project}/locations/{location}/processors/{processor}/processorVersions/{processorVersion}`
  *                                Please see {@see DocumentProcessorServiceClient::processorVersionName()} for help formatting this field.
  */

diff --git a/DocumentAi/samples/V1/DocumentProcessorServiceClient/list_processor_versions.php b/DocumentAi/samples/V1/DocumentProcessorServiceClient/list_processor_versions.php
@@ -32,9 +32,8 @@
 /**
  * Lists all versions of a processor.
  *
- * @param string $formattedParent The parent (project, location and processor) to list all
- *                                versions. Format:
- *                                `projects/{project}/locations/{location}/processors/{processor}`
+ * @param string $formattedParent The parent (project, location and processor) to list all versions.
+ *                                Format: `projects/{project}/locations/{location}/processors/{processor}`
  *                                Please see {@see DocumentProcessorServiceClient::processorName()} for help formatting this field.
  */
 function list_processor_versions_sample(string $formattedParent): void

diff --git a/DocumentAi/samples/V1/DocumentProcessorServiceClient/list_processors.php b/DocumentAi/samples/V1/DocumentProcessorServiceClient/list_processors.php
@@ -32,8 +32,8 @@
 /**
  * Lists all processors which belong to this project.
  *
- * @param string $formattedParent The parent (project and location) which owns this collection of
- *                                Processors. Format: `projects/{project}/locations/{location}`
+ * @param string $formattedParent The parent (project and location) which owns this collection of Processors.
+ *                                Format: `projects/{project}/locations/{location}`
  *                                Please see {@see DocumentProcessorServiceClient::locationName()} for help formatting this field.
  */
 function list_processors_sample(string $formattedParent): void

diff --git a/DocumentAi/samples/V1/DocumentProcessorServiceClient/process_document.php b/DocumentAi/samples/V1/DocumentProcessorServiceClient/process_document.php
@@ -31,15 +31,11 @@
 /**
  * Processes a single document.
  *
- * @param string $name The resource name of the
- *                     [Processor][google.cloud.documentai.v1.Processor] or
+ * @param string $name The resource name of the [Processor][google.cloud.documentai.v1.Processor] or
  *                     [ProcessorVersion][google.cloud.documentai.v1.ProcessorVersion]
- *                     to use for processing. If a
- *                     [Processor][google.cloud.documentai.v1.Processor] is specified, the server
- *                     will use its [default
- *                     version][google.cloud.documentai.v1.Processor.default_processor_version].
- *                     Format: `projects/{project}/locations/{location}/processors/{processor}`,
- *                     or
+ *                     to use for processing. If a [Processor][google.cloud.documentai.v1.Processor] is specified, the server will use
+ *                     its [default version][google.cloud.documentai.v1.Processor.default_processor_version]. Format:
+ *                     `projects/{project}/locations/{location}/processors/{processor}`, or
  *                     `projects/{project}/locations/{location}/processors/{processor}/processorVersions/{processorVersion}`
  */
 function process_document_sample(string $name): void

diff --git a/DocumentAi/samples/V1/DocumentProcessorServiceClient/review_document.php b/DocumentAi/samples/V1/DocumentProcessorServiceClient/review_document.php
@@ -34,9 +34,8 @@
  * Send a document for Human Review. The input document should be processed by
  * the specified processor.
  *
- * @param string $formattedHumanReviewConfig The resource name of the
- *                                           [HumanReviewConfig][google.cloud.documentai.v1.HumanReviewConfig] that the
- *                                           document will be reviewed with. Please see
+ * @param string $formattedHumanReviewConfig The resource name of the [HumanReviewConfig][google.cloud.documentai.v1.HumanReviewConfig] that the document will be
+ *                                           reviewed with. Please see
  *                                           {@see DocumentProcessorServiceClient::humanReviewConfigName()} for help formatting this field.
  */
 function review_document_sample(string $formattedHumanReviewConfig): void

diff --git a/DocumentAi/samples/V1/DocumentProcessorServiceClient/set_default_processor_version.php b/DocumentAi/samples/V1/DocumentProcessorServiceClient/set_default_processor_version.php
@@ -31,19 +31,14 @@
 use Google\Rpc\Status;
 
 /**
- * Set the default (active) version of a
- * [Processor][google.cloud.documentai.v1.Processor] that will be used in
- * [ProcessDocument][google.cloud.documentai.v1.DocumentProcessorService.ProcessDocument]
- * and
+ * Set the default (active) version of a [Processor][google.cloud.documentai.v1.Processor] that will be used in
+ * [ProcessDocument][google.cloud.documentai.v1.DocumentProcessorService.ProcessDocument] and
  * [BatchProcessDocuments][google.cloud.documentai.v1.DocumentProcessorService.BatchProcessDocuments].
  *
- * @param string $formattedProcessor               The resource name of the
- *                                                 [Processor][google.cloud.documentai.v1.Processor] to change default
- *                                                 version. Please see
+ * @param string $formattedProcessor               The resource name of the [Processor][google.cloud.documentai.v1.Processor] to change default version. Please see
  *                                                 {@see DocumentProcessorServiceClient::processorName()} for help formatting this field.
- * @param string $formattedDefaultProcessorVersion The resource name of child
- *                                                 [ProcessorVersion][google.cloud.documentai.v1.ProcessorVersion] to use as
- *                                                 default. Format:
+ * @param string $formattedDefaultProcessorVersion The resource name of child [ProcessorVersion][google.cloud.documentai.v1.ProcessorVersion] to use as default.
+ *                                                 Format:
  *                                                 `projects/{project}/locations/{location}/processors/{processor}/processorVersions/{version}`
  *                                                 Please see {@see DocumentProcessorServiceClient::processorVersionName()} for help formatting this field.
  */

diff --git a/DocumentAi/samples/V1/DocumentProcessorServiceClient/train_processor_version.php b/DocumentAi/samples/V1/DocumentProcessorServiceClient/train_processor_version.php
@@ -36,9 +36,8 @@
  * Operation metadata is returned as
  * [TrainProcessorVersionMetadata][google.cloud.documentai.v1.TrainProcessorVersionMetadata].
  *
- * @param string $formattedParent The parent (project, location and processor) to create the new
- *                                version for. Format:
- *                                `projects/{project}/locations/{location}/processors/{processor}`. Please see
+ * @param string $formattedParent The parent (project, location and processor) to create the new version for.
+ *                                Format: `projects/{project}/locations/{location}/processors/{processor}`. Please see
  *                                {@see DocumentProcessorServiceClient::processorName()} for help formatting this field.
  */
 function train_processor_version_sample(string $formattedParent): void

diff --git a/DocumentAi/src/V1/BatchProcessMetadata/IndividualProcessStatus.php b/DocumentAi/src/V1/BatchProcessMetadata/IndividualProcessStatus.php
diff --git a/DocumentAi/src/V1/BatchProcessRequest.php b/DocumentAi/src/V1/BatchProcessRequest.php
diff --git a/DocumentAi/src/V1/Client/DocumentProcessorServiceClient.php b/DocumentAi/src/V1/Client/DocumentProcessorServiceClient.php
@@ -436,9 +436,8 @@ public function batchProcessDocuments(BatchProcessRequest $request, array $callO
     }
 
     /**
-     * Creates a processor from the
-     * [ProcessorType][google.cloud.documentai.v1.ProcessorType] provided. The
-     * processor will be at `ENABLED` state by default after its creation.
+     * Creates a processor from the [ProcessorType][google.cloud.documentai.v1.ProcessorType] provided.
+     * The processor will be at `ENABLED` state by default after its creation.
      *
      * The async variant is
      * {@see DocumentProcessorServiceClient::createProcessorAsync()} .
@@ -630,8 +629,7 @@ public function evaluateProcessorVersion(EvaluateProcessorVersionRequest $reques
     }
 
     /**
-     * Fetches processor types. Note that we don't use
-     * [ListProcessorTypes][google.cloud.documentai.v1.DocumentProcessorService.ListProcessorTypes]
+     * Fetches processor types. Note that we don't use [ListProcessorTypes][google.cloud.documentai.v1.DocumentProcessorService.ListProcessorTypes]
      * here, because it isn't paginated.
      *
      * The async variant is
@@ -930,10 +928,8 @@ public function reviewDocument(ReviewDocumentRequest $request, array $callOption
     }
 
     /**
-     * Set the default (active) version of a
-     * [Processor][google.cloud.documentai.v1.Processor] that will be used in
-     * [ProcessDocument][google.cloud.documentai.v1.DocumentProcessorService.ProcessDocument]
-     * and
+     * Set the default (active) version of a [Processor][google.cloud.documentai.v1.Processor] that will be used in
+     * [ProcessDocument][google.cloud.documentai.v1.DocumentProcessorService.ProcessDocument] and
      * [BatchProcessDocuments][google.cloud.documentai.v1.DocumentProcessorService.BatchProcessDocuments].
      *
      * The async variant is