docs: Comments are clarified for certain fields in messages QueryAssetsResponse and ResourceSearchResult

Google APIs · copybara-github · commit c27097ea636b · 2024-09-11T12:53:22.000-07:00
PiperOrigin-RevId: 673500457
diff --git a/google/cloud/asset/v1/asset_service.proto b/google/cloud/asset/v1/asset_service.proto
@@ -1996,10 +1996,12 @@ message QueryAssetsResponse {
 
   // The query response, which can be either an `error` or a valid `response`.
   //
-  // If `done` == `false` and the query result is being saved in a output, the
+  // If `done` == `false` and the query result is being saved in an output, the
   // output_config field will be set.
   // If `done` == `true`, exactly one of
   // `error`, `query_result` or `output_config` will be set.
+  // [done] is unset unless the [QueryAssetsResponse] contains a
+  // [QueryAssetsResponse.job_reference].
   bool done = 2;
 
   oneof response {
@@ -2009,8 +2011,9 @@ message QueryAssetsResponse {
     // Result of the query.
     QueryResult query_result = 4;
 
-    // Output configuration which indicates instead of being returned in API
-    // response on the fly, the query result will be saved in a specific output.
+    // Output configuration, which indicates that instead of being returned in
+    // an API response on the fly, the query result will be saved in a specific
+    // output.
     QueryAssetsOutputConfig output_config = 5;
   }
 }
diff --git a/google/cloud/asset/v1/assets.proto b/google/cloud/asset/v1/assets.proto
@@ -341,7 +341,6 @@ message EffectiveTagDetails {
 }
 
 // A result of Resource Search, containing information of a cloud resource.
-// Next ID: 34
 message ResourceSearchResult {
   // The full resource name of this resource. Example:
   // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`.
@@ -424,8 +423,8 @@ message ResourceSearchResult {
   // * Use a free text query. Example: `us-west*`
   string location = 6;
 
-  // Labels associated with this resource. See [Labelling and grouping Google
-  // Cloud
+  // User labels associated with this resource. See [Labelling and grouping
+  // Google Cloud
   // resources](https://cloud.google.com/blog/products/gcp/labelling-and-grouping-your-google-cloud-platform-resources)
   // for more information. This field is available only when the resource's
   // Protobuf contains it.
