feat: Add ImportProcessorVersion in v1beta3

Google APIs · copybara-github · commit ae3e6130091c · 2023-03-20T09:55:54.000-07:00
PiperOrigin-RevId: 517997886
diff --git a/google/cloud/documentai/v1beta3/document_processor_service.proto b/google/cloud/documentai/v1beta3/document_processor_service.proto
@@ -321,6 +321,20 @@ service DocumentProcessorService {
     };
     option (google.api.method_signature) = "parent";
   }
+
+  // Imports a processor version from source processor version.
+  rpc ImportProcessorVersion(ImportProcessorVersionRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta3/{parent=projects/*/locations/*/processors/*}/processorVersions:importProcessorVersion"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent";
+    option (google.longrunning.operation_info) = {
+      response_type: "ImportProcessorVersionResponse"
+      metadata_type: "ImportProcessorVersionMetadata"
+    };
+  }
 }
 
 // Options for Process API
@@ -1121,3 +1135,47 @@ message ListEvaluationsResponse {
   // If this field is omitted, there are no subsequent pages.
   string next_page_token = 2;
 }
+
+// The request message for the ImportProcessorVersion method.
+// This method requires Document AI Service Agent of the destination project in
+// the source project's IAM with [Document AI Editor
+// role](https://cloud.google.com/document-ai/docs/access-control/iam-roles).
+//
+// The destination project is specified as part of the `parent` field.
+// The source project is specified as part of `source` field.
+//
+// The Service Agent for Document AI can be found in
+// https://cloud.google.com/iam/docs/service-agents.
+message ImportProcessorVersionRequest {
+  oneof source {
+    // The source processor version to import from.
+    string processor_version_source = 2 [(google.api.resource_reference) = {
+      type: "documentai.googleapis.com/ProcessorVersion"
+    }];
+  }
+
+  // Required. The destination processor name to create the processor version
+  // in. Format:
+  // `projects/{project}/locations/{location}/processors/{processor}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "documentai.googleapis.com/ProcessorVersion"
+    }
+  ];
+}
+
+// The response message for the ImportProcessorVersion method.
+message ImportProcessorVersionResponse {
+  // The destination processor version name.
+  string processor_version = 1 [(google.api.resource_reference) = {
+    type: "documentai.googleapis.com/ProcessorVersion"
+  }];
+}
+
+// The long running operation metadata for the ImportProcessorVersion
+// method.
+message ImportProcessorVersionMetadata {
+  // The basic metadata for the long running operation.
+  CommonOperationMetadata common_metadata = 1;
+}
diff --git a/google/cloud/documentai/v1beta3/documentai_v1beta3.yaml b/google/cloud/documentai/v1beta3/documentai_v1beta3.yaml
@@ -21,6 +21,8 @@ types:
 - name: google.cloud.documentai.v1beta3.EnableProcessorResponse
 - name: google.cloud.documentai.v1beta3.EvaluateProcessorVersionMetadata
 - name: google.cloud.documentai.v1beta3.EvaluateProcessorVersionResponse
+- name: google.cloud.documentai.v1beta3.ImportProcessorVersionMetadata
+- name: google.cloud.documentai.v1beta3.ImportProcessorVersionResponse
 - name: google.cloud.documentai.v1beta3.ReviewDocumentOperationMetadata
 - name: google.cloud.documentai.v1beta3.ReviewDocumentResponse
 - name: google.cloud.documentai.v1beta3.SetDefaultProcessorVersionMetadata
