refactor: Move CommonOperationMetadata into a separate proto file for…

… potential reuse. (#227)

* feat: Move CommonOperationMetadata into a separate proto file for potential reuse.

PiperOrigin-RevId: 377114643

Source-Link: googleapis/googleapis@204809d

Source-Link: googleapis/googleapis-gen@97c815b

* 🦉 Updates from OwlBot

* 🦉 Updates from OwlBot

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

packages/google-cloud-documentai/protos/google/cloud/documentai/v1beta3/document_processor_service.proto

@@ -22,6 +22,7 @@ import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 import "google/cloud/documentai/v1beta3/document.proto";
 import "google/cloud/documentai/v1beta3/document_io.proto";
+import "google/cloud/documentai/v1beta3/operation_metadata.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/field_mask.proto";
 import "google/protobuf/timestamp.proto";
@@ -364,39 +365,3 @@ message ReviewDocumentOperationMetadata {
   // The basic metadata of the long running operation.
   CommonOperationMetadata common_metadata = 5;
 }
-
-// The common metadata for long running operations.
-message CommonOperationMetadata {
-  // State of the longrunning operation.
-  enum State {
-    // Unspecified state.
-    STATE_UNSPECIFIED = 0;
-
-    // Operation is still running.
-    RUNNING = 1;
-
-    // Operation is being cancelled.
-    CANCELLING = 2;
-
-    // Operation succeeded.
-    SUCCEEDED = 3;
-
-    // Operation failed.
-    FAILED = 4;
-
-    // Operation is cancelled.
-    CANCELLED = 5;
-  }
-
-  // The state of the operation.
-  State state = 1;
-
-  // A message providing more details about the current state of processing.
-  string state_message = 2;
-
-  // The creation time of the operation.
-  google.protobuf.Timestamp create_time = 3;
-
-  // The last update time of the operation.
-  google.protobuf.Timestamp update_time = 4;
-}

packages/google-cloud-documentai/protos/google/cloud/documentai/v1beta3/geometry.proto

@@ -32,7 +32,7 @@ message Vertex {
   // X coordinate.
   int32 x = 1;
 
-  // Y coordinate.
+  // Y coordinate (starts from the top of the image).
   int32 y = 2;
 }
 
@@ -43,7 +43,7 @@ message NormalizedVertex {
   // X coordinate.
   float x = 1;
 
-  // Y coordinate.
+  // Y coordinate (starts from the top of the image).
   float y = 2;
 }
 

packages/google-cloud-documentai/protos/google/cloud/documentai/v1beta3/operation_metadata.proto

@@ -0,0 +1,64 @@
+// Copyright 2021 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.documentai.v1beta3;
+
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Cloud.DocumentAI.V1Beta3";
+option go_package = "google.golang.org/genproto/googleapis/cloud/documentai/v1beta3;documentai";
+option java_multiple_files = true;
+option java_outer_classname = "OperationMetadataProto";
+option java_package = "com.google.cloud.documentai.v1beta3";
+option php_namespace = "Google\\Cloud\\DocumentAI\\V1beta3";
+option ruby_package = "Google::Cloud::DocumentAI::V1beta3";
+
+// The common metadata for long running operations.
+message CommonOperationMetadata {
+  // State of the longrunning operation.
+  enum State {
+    // Unspecified state.
+    STATE_UNSPECIFIED = 0;
+
+    // Operation is still running.
+    RUNNING = 1;
+
+    // Operation is being cancelled.
+    CANCELLING = 2;
+
+    // Operation succeeded.
+    SUCCEEDED = 3;
+
+    // Operation failed.
+    FAILED = 4;
+
+    // Operation is cancelled.
+    CANCELLED = 5;
+  }
+
+  // The state of the operation.
+  State state = 1;
+
+  // A message providing more details about the current state of processing.
+  string state_message = 2;
+
+  // The creation time of the operation.
+  google.protobuf.Timestamp create_time = 3;
+
+  // The last update time of the operation.
+  google.protobuf.Timestamp update_time = 4;
+}

packages/google-cloud-documentai/src/v1beta3/document_processor_service_proto_list.json

@@ -2,5 +2,6 @@
   "../../protos/google/cloud/documentai/v1beta3/document.proto",
   "../../protos/google/cloud/documentai/v1beta3/document_io.proto",
   "../../protos/google/cloud/documentai/v1beta3/document_processor_service.proto",
-  "../../protos/google/cloud/documentai/v1beta3/geometry.proto"
+  "../../protos/google/cloud/documentai/v1beta3/geometry.proto",
+  "../../protos/google/cloud/documentai/v1beta3/operation_metadata.proto"
 ]