docs: [google-cloud-asset] Comments are clarified for certain fields in messages QueryAssetsResponse and ResourceSearchResult (googleapis#13076)

gcf-owl-bot[bot] · web-flow · commit 35b2c456c679 · 2024-09-16T10:56:49.000-07:00
- [ ] Regenerate this pull request now. PiperOrigin-RevId: 673500457 Source-Link: googleapis/googleapis@c27097e Source-Link: https://github.com/googleapis/googleapis-gen/commit/dd6d5ed8b59764109b996ba6895dd10be1c8b865 Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWFzc2V0Ly5Pd2xCb3QueWFtbCIsImgiOiJkZDZkNWVkOGI1OTc2NDEwOWI5OTZiYTY4OTVkZDEwYmUxYzhiODY1In0= --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
diff --git a/packages/google-cloud-asset/google/cloud/asset_v1/types/asset_service.py b/packages/google-cloud-asset/google/cloud/asset_v1/types/asset_service.py
@@ -2780,9 +2780,11 @@ class QueryAssetsResponse(proto.Message):
             valid ``response``.
 
             If ``done`` == ``false`` and the query result is being saved
-            in a output, the output_config field will be set. If
+            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.
+            ``query_result`` or ``output_config`` will be set. [done] is
+            unset unless the [QueryAssetsResponse] contains a
+            [QueryAssetsResponse.job_reference].
         error (google.rpc.status_pb2.Status):
             Error status.
 
@@ -2792,10 +2794,10 @@ class QueryAssetsResponse(proto.Message):
 
             This field is a member of `oneof`_ ``response``.
         output_config (google.cloud.asset_v1.types.QueryAssetsOutputConfig):
-            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.
 
             This field is a member of `oneof`_ ``response``.
     """
diff --git a/packages/google-cloud-asset/google/cloud/asset_v1/types/assets.py b/packages/google-cloud-asset/google/cloud/asset_v1/types/assets.py
@@ -602,7 +602,7 @@ class EffectiveTagDetails(proto.Message):
 
 class ResourceSearchResult(proto.Message):
     r"""A result of Resource Search, containing information of a
-    cloud resource. Next ID: 34
+    cloud resource.
 
     Attributes:
         name (str):
@@ -684,8 +684,8 @@ class ResourceSearchResult(proto.Message):
             -  Use a field query. Example: ``location:us-west*``
             -  Use a free text query. Example: ``us-west*``
         labels (MutableMapping[str, str]):
-            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.
