feat: Clarify Batch API proto doc about pubsub notifications

Google APIs · copybara-github · commit 0e42ad0c17e1 · 2023-08-07T16:11:08.000-07:00
---
feat: add Batch Managed Container support for v1alpha
PiperOrigin-RevId: 554622486
diff --git a/google/cloud/batch/v1/job.proto b/google/cloud/batch/v1/job.proto
@@ -184,8 +184,12 @@ message JobStatus {
 // Notification configurations.
 message JobNotification {
   // Message details.
-  // Describe the attribute that a message should have.
-  // Without specified message attributes, no message will be sent by default.
+  // Describe the conditions under which messages will be sent.
+  // If no attribute is defined, no message will be sent by default.
+  // One message should specify either the job or the task level attributes,
+  // but not both. For example,
+  // job level: JOB_STATE_CHANGED and/or a specified new_job_state;
+  // task level: TASK_STATE_CHANGED and/or a specified new_task_state.
   message Message {
     // The message type.
     Type type = 1;
@@ -210,8 +214,8 @@ message JobNotification {
   }
 
   // The Pub/Sub topic where notifications like the job state changes
-  // will be published. This topic exist in the same project as the job
-  // and billings will be charged to this project.
+  // will be published. The topic must exist in the same project as
+  // the job and billings will be charged to this project.
   // If not specified, no Pub/Sub messages will be sent.
   // Topic format: `projects/{project}/topics/{topic}`.
   string pubsub_topic = 1;
diff --git a/google/cloud/batch/v1/task.proto b/google/cloud/batch/v1/task.proto
@@ -16,6 +16,7 @@ syntax = "proto3";
 
 package google.cloud.batch.v1;
 
+import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 import "google/cloud/batch/v1/volume.proto";
 import "google/protobuf/duration.proto";
