docs: Mark revision_id in CommitSchemaRevisionRequest deprecated

Google APIs · copybara-github · commit 3b9ae88062e8 · 2023-02-08T07:37:38.000-08:00
PiperOrigin-RevId: 508076213
diff --git a/google/pubsub/v1/schema.proto b/google/pubsub/v1/schema.proto
@@ -320,17 +320,17 @@ message DeleteSchemaRevisionRequest {
   // Required. The name of the schema revision to be deleted, with a revision ID
   // explicitly included.
   //
-  // Example: projects/123/schemas/my-schema@c7cfa2a8
+  // Example: `projects/123/schemas/my-schema@c7cfa2a8`
   string name = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = { type: "pubsub.googleapis.com/Schema" }
   ];
 
-  // Required. The revision ID to roll back to.
-  // It must be a revision of the same schema.
-  //
-  //   Example: c7cfa2a8
-  string revision_id = 2 [(google.api.field_behavior) = REQUIRED];
+  // Optional. This field is deprecated and should not be used for specifying
+  // the revision ID. The revision ID should be specified via the `name`
+  // parameter.
+  string revision_id = 2
+      [deprecated = true, (google.api.field_behavior) = OPTIONAL];
 }
 
 // Request for the `DeleteSchema` method.
