docs: update comments for rpc BatchCreatePullRequestComments, ResolvePullRequestComments and UnresolvePullRequestComments

Google APIs · copybara-github · commit ae65549ccc7c · 2025-07-29T11:41:19.000-07:00
PiperOrigin-RevId: 788541778
diff --git a/google/cloud/securesourcemanager/v1/BUILD.bazel b/google/cloud/securesourcemanager/v1/BUILD.bazel
@@ -343,6 +343,7 @@ load(
 
 csharp_proto_library(
     name = "securesourcemanager_csharp_proto",
+    extra_opts = [],
     deps = [":securesourcemanager_proto"],
 )
 
diff --git a/google/cloud/securesourcemanager/v1/secure_source_manager.proto b/google/cloud/securesourcemanager/v1/secure_source_manager.proto
@@ -512,7 +512,11 @@ service SecureSourceManager {
     option (google.api.method_signature) = "parent";
   }
 
-  // Creates a pull request comment.
+  // Creates a pull request comment. This function is used to create a single
+  // PullRequestComment of type Comment, or a single PullRequestComment of type
+  // Code that's replying to another PullRequestComment of type Code. Use
+  // BatchCreatePullRequestComments to create multiple PullRequestComments for
+  // code reviews.
   rpc CreatePullRequestComment(CreatePullRequestCommentRequest)
       returns (google.longrunning.Operation) {
     option (google.api.http) = {
@@ -553,7 +557,11 @@ service SecureSourceManager {
     };
   }
 
-  // Batch creates pull request comments.
+  // Batch creates pull request comments. This function is used to create
+  // multiple PullRequestComments for code review. There needs to be exactly one
+  // PullRequestComment of type Review, and at most 100 PullRequestComments of
+  // type Code per request. The Postition of the code comments must be unique
+  // within the request.
   rpc BatchCreatePullRequestComments(BatchCreatePullRequestCommentsRequest)
       returns (google.longrunning.Operation) {
     option (google.api.http) = {
@@ -567,7 +575,10 @@ service SecureSourceManager {
     };
   }
 
-  // Resolves pull request comments.
+  // Resolves pull request comments. A list of PullRequestComment names must be
+  // provided. The PullRequestComment names must be in the same conversation
+  // thread. If auto_fill is set, all comments in the conversation thread will
+  // be resolved.
   rpc ResolvePullRequestComments(ResolvePullRequestCommentsRequest)
       returns (google.longrunning.Operation) {
     option (google.api.http) = {
@@ -581,7 +592,10 @@ service SecureSourceManager {
     };
   }
 
-  // Unresolves pull request comment.
+  // Unresolves pull request comments. A list of PullRequestComment names must
+  // be provided. The PullRequestComment names must be in the same conversation
+  // thread. If auto_fill is set, all comments in the conversation thread will
+  // be unresolved.
   rpc UnresolvePullRequestComments(UnresolvePullRequestCommentsRequest)
       returns (google.longrunning.Operation) {
     option (google.api.http) = {
diff --git a/google/cloud/securesourcemanager/v1/securesourcemanager_v1.yaml b/google/cloud/securesourcemanager/v1/securesourcemanager_v1.yaml
@@ -10,7 +10,10 @@ apis:
 - name: google.longrunning.Operations
 
 types:
+- name: google.cloud.securesourcemanager.v1.BatchCreatePullRequestCommentsResponse
 - name: google.cloud.securesourcemanager.v1.OperationMetadata
+- name: google.cloud.securesourcemanager.v1.ResolvePullRequestCommentsResponse
+- name: google.cloud.securesourcemanager.v1.UnresolvePullRequestCommentsResponse
 
 documentation:
   summary: |-

Original file line number	Diff line number	Diff line change
`@@ -343,6 +343,7 @@ load(`
`343`	`343`
`344`	`344`	`csharp_proto_library(`
`345`	`345`	`name = "securesourcemanager_csharp_proto",`
	`346`	`+ extra_opts = [],`
`346`	`347`	`deps = [":securesourcemanager_proto"],`
`347`	`348`	`)`
`348`	`349`