google-cloud-asset-v1 0.26.1 → 0.28.0

data/lib/google/cloud/asset/v1/asset_service/rest/client.rb

@@ -327,6 +327,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::ExportAssetsRequest.new
+              #
+              #   # Call the export_assets method.
+              #   result = client.export_assets request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def export_assets request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -446,6 +469,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Asset::V1::Asset>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::ListAssetsRequest.new
+              #
+              #   # Call the list_assets method.
+              #   result = client.list_assets request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::Asset::V1::Asset.
+              #     p item
+              #   end
+              #
               def list_assets request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -552,6 +595,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::BatchGetAssetsHistoryResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::BatchGetAssetsHistoryRequest.new
+              #
+              #   # Call the batch_get_assets_history method.
+              #   result = client.batch_get_assets_history request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::BatchGetAssetsHistoryResponse.
+              #   p result
+              #
               def batch_get_assets_history request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -627,6 +686,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::Feed]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::CreateFeedRequest.new
+              #
+              #   # Call the create_feed method.
+              #   result = client.create_feed request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::Feed.
+              #   p result
+              #
               def create_feed request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -692,6 +767,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::Feed]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::GetFeedRequest.new
+              #
+              #   # Call the get_feed method.
+              #   result = client.get_feed request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::Feed.
+              #   p result
+              #
               def get_feed request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -756,6 +847,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::ListFeedsResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::ListFeedsRequest.new
+              #
+              #   # Call the list_feeds method.
+              #   result = client.list_feeds request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::ListFeedsResponse.
+              #   p result
+              #
               def list_feeds request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -826,6 +933,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::Feed]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::UpdateFeedRequest.new
+              #
+              #   # Call the update_feed method.
+              #   result = client.update_feed request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::Feed.
+              #   p result
+              #
               def update_feed request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -891,6 +1014,22 @@ module Google
               # @return [::Google::Protobuf::Empty]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::DeleteFeedRequest.new
+              #
+              #   # Call the delete_feed method.
+              #   result = client.delete_feed request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def delete_feed request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -969,49 +1108,73 @@ module Google
               #     Examples:
               #
               #     * `name:Important` to find Google Cloud resources whose name contains
-              #       "Important" as a word.
+              #       `Important` as a word.
               #     * `name=Important` to find the Google Cloud resource whose name is exactly
-              #       "Important".
+              #       `Important`.
               #     * `displayName:Impor*` to find Google Cloud resources whose display name
-              #       contains "Impor" as a prefix of any word in the field.
+              #       contains `Impor` as a prefix of any word in the field.
               #     * `location:us-west*` to find Google Cloud resources whose location
-              #       contains both "us" and "west" as prefixes.
-              #     * `labels:prod` to find Google Cloud resources whose labels contain "prod"
+              #       contains both `us` and `west` as prefixes.
+              #     * `labels:prod` to find Google Cloud resources whose labels contain `prod`
               #       as a key or value.
-              #     * `labels.env:prod` to find Google Cloud resources that have a label "env"
-              #       and its value is "prod".
-              #     * `labels.env:*` to find Google Cloud resources that have a label "env".
+              #     * `labels.env:prod` to find Google Cloud resources that have a label `env`
+              #       and its value is `prod`.
+              #     * `labels.env:*` to find Google Cloud resources that have a label `env`.
+              #     * `tagKeys:env` to find Google Cloud resources that have directly
+              #       attached tags where the
+              #       [`TagKey`](https://cloud.google.com/resource-manager/reference/rest/v3/tagKeys#resource:-tagkey)
+              #       .`namespacedName` contains `env`.
+              #     * `tagValues:prod*` to find Google Cloud resources that have directly
+              #       attached tags where the
+              #       [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue)
+              #       .`namespacedName` contains a word prefixed by `prod`.
+              #     * `tagValueIds=tagValues/123` to find Google Cloud resources that have
+              #       directly attached tags where the
+              #       [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue)
+              #       .`name` is exactly `tagValues/123`.
+              #     * `effectiveTagKeys:env` to find Google Cloud resources that have
+              #       directly attached or inherited tags where the
+              #       [`TagKey`](https://cloud.google.com/resource-manager/reference/rest/v3/tagKeys#resource:-tagkey)
+              #       .`namespacedName` contains `env`.
+              #     * `effectiveTagValues:prod*` to find Google Cloud resources that have
+              #       directly attached or inherited tags where the
+              #       [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue)
+              #       .`namespacedName` contains a word prefixed by `prod`.
+              #     * `effectiveTagValueIds=tagValues/123` to find Google Cloud resources that
+              #        have directly attached or inherited tags where the
+              #       [`TagValue`](https://cloud.google.com/resource-manager/reference/rest/v3/tagValues#resource:-tagvalue)
+              #       .`name` is exactly `tagValues/123`.
               #     * `kmsKey:key` to find Google Cloud resources encrypted with a
-              #       customer-managed encryption key whose name contains "key" as a word. This
+              #       customer-managed encryption key whose name contains `key` as a word. This
               #       field is deprecated. Please use the `kmsKeys` field to retrieve Cloud KMS
               #       key information.
               #     * `kmsKeys:key` to find Google Cloud resources encrypted with
-              #       customer-managed encryption keys whose name contains the word "key".
+              #       customer-managed encryption keys whose name contains the word `key`.
               #     * `relationships:instance-group-1` to find Google Cloud resources that have
-              #       relationships with "instance-group-1" in the related resource name.
+              #       relationships with `instance-group-1` in the related resource name.
               #     * `relationships:INSTANCE_TO_INSTANCEGROUP` to find Compute Engine
-              #       instances that have relationships of type "INSTANCE_TO_INSTANCEGROUP".
+              #       instances that have relationships of type `INSTANCE_TO_INSTANCEGROUP`.
               #     * `relationships.INSTANCE_TO_INSTANCEGROUP:instance-group-1` to find
-              #       Compute Engine instances that have relationships with "instance-group-1"
+              #       Compute Engine instances that have relationships with `instance-group-1`
               #       in the Compute Engine instance group resource name, for relationship type
-              #       "INSTANCE_TO_INSTANCEGROUP".
+              #       `INSTANCE_TO_INSTANCEGROUP`.
               #     * `state:ACTIVE` to find Google Cloud resources whose state contains
-              #       "ACTIVE" as a word.
+              #       `ACTIVE` as a word.
               #     * `NOT state:ACTIVE` to find Google Cloud resources whose state doesn't
-              #       contain "ACTIVE" as a word.
+              #       contain `ACTIVE` as a word.
               #     * `createTime<1609459200` to find Google Cloud resources that were created
-              #       before "2021-01-01 00:00:00 UTC". 1609459200 is the epoch timestamp of
-              #       "2021-01-01 00:00:00 UTC" in seconds.
+              #       before `2021-01-01 00:00:00 UTC`. `1609459200` is the epoch timestamp of
+              #       `2021-01-01 00:00:00 UTC` in seconds.
               #     * `updateTime>1609459200` to find Google Cloud resources that were updated
-              #       after "2021-01-01 00:00:00 UTC". 1609459200 is the epoch timestamp of
-              #       "2021-01-01 00:00:00 UTC" in seconds.
-              #     * `Important` to find Google Cloud resources that contain "Important" as a
+              #       after `2021-01-01 00:00:00 UTC`. `1609459200` is the epoch timestamp of
+              #       `2021-01-01 00:00:00 UTC` in seconds.
+              #     * `Important` to find Google Cloud resources that contain `Important` as a
               #       word in any of the searchable fields.
-              #     * `Impor*` to find Google Cloud resources that contain "Impor" as a prefix
+              #     * `Impor*` to find Google Cloud resources that contain `Impor` as a prefix
               #       of any word in any of the searchable fields.
               #     * `Important location:(us-west1 OR global)` to find Google Cloud
-              #       resources that contain "Important" as a word in any of the searchable
-              #       fields and are also located in the "us-west1" region or the "global"
+              #       resources that contain `Important` as a word in any of the searchable
+              #       fields and are also located in the `us-west1` region or the `global`
               #       location.
               #   @param asset_types [::Array<::String>]
               #     Optional. A list of asset types that this request searches for. If empty,
@@ -1030,10 +1193,10 @@ module Google
               #     supported asset type, an INVALID_ARGUMENT error will be returned.
               #   @param page_size [::Integer]
               #     Optional. The page size for search result pagination. Page size is capped
-              #     at 500 even if a larger value is given. If set to zero, server will pick an
-              #     appropriate default. Returned results may be fewer than requested. When
-              #     this happens, there could be more results as long as `next_page_token` is
-              #     returned.
+              #     at 500 even if a larger value is given. If set to zero or a negative value,
+              #     server will pick an appropriate default. Returned results may be fewer than
+              #     requested. When this happens, there could be more results as long as
+              #     `next_page_token` is returned.
               #   @param page_token [::String]
               #     Optional. If present, then retrieve the next batch of results from the
               #     preceding call to this method. `page_token` must be the value of
@@ -1044,7 +1207,7 @@ module Google
               #     the results. The default order is ascending. Add " DESC" after the field
               #     name to indicate descending order. Redundant space characters are ignored.
               #     Example: "location DESC, name".
-              #     Only singular primitive fields in the response are sortable:
+              #     Only the following fields in the response are sortable:
               #
               #       * name
               #       * assetType
@@ -1057,43 +1220,37 @@ module Google
               #       * state
               #       * parentFullResourceName
               #       * parentAssetType
-              #
-              #     All the other fields such as repeated fields (e.g., `networkTags`,
-              #     `kmsKeys`), map fields (e.g., `labels`) and struct fields (e.g.,
-              #     `additionalAttributes`) are not supported.
               #   @param read_mask [::Google::Protobuf::FieldMask, ::Hash]
-              #     Optional. A comma-separated list of fields specifying which fields to be
-              #     returned in ResourceSearchResult. Only '*' or combination of top level
-              #     fields can be specified. Field names of both snake_case and camelCase are
-              #     supported. Examples: `"*"`, `"name,location"`, `"name,versionedResources"`.
-              #
-              #     The read_mask paths must be valid field paths listed but not limited to
-              #     (both snake_case and camelCase are supported):
-              #
-              #       * name
-              #       * assetType
-              #       * project
-              #       * displayName
-              #       * description
-              #       * location
-              #       * tagKeys
-              #       * tagValues
-              #       * tagValueIds
-              #       * labels
-              #       * networkTags
-              #       * kmsKey (This field is deprecated. Please use the `kmsKeys` field to
-              #         retrieve Cloud KMS key information.)
-              #       * kmsKeys
-              #       * createTime
-              #       * updateTime
-              #       * state
-              #       * additionalAttributes
-              #       * versionedResources
-              #
-              #     If read_mask is not specified, all fields except versionedResources will
-              #     be returned.
-              #     If only '*' is specified, all fields including versionedResources will be
-              #     returned.
+              #     Optional. A comma-separated list of fields that you want returned in the
+              #     results. The following fields are returned by default if not specified:
+              #
+              #       * `name`
+              #       * `assetType`
+              #       * `project`
+              #       * `folders`
+              #       * `organization`
+              #       * `displayName`
+              #       * `description`
+              #       * `location`
+              #       * `labels`
+              #       * `tags`
+              #       * `effectiveTags`
+              #       * `networkTags`
+              #       * `kmsKeys`
+              #       * `createTime`
+              #       * `updateTime`
+              #       * `state`
+              #       * `additionalAttributes`
+              #       * `parentFullResourceName`
+              #       * `parentAssetType`
+              #
+              #     Some fields of large size, such as `versionedResources`,
+              #     `attachedResources`, `effectiveTags` etc., are not returned by default, but
+              #     you can specify them in the `read_mask` parameter if you want to include
+              #     them. If `"*"` is specified, all [available
+              #     fields](https://cloud.google.com/asset-inventory/docs/reference/rest/v1/TopLevel/searchAllResources#resourcesearchresult)
+              #     are returned.
+              #     Examples: `"name,location"`, `"name,versionedResources"`, `"*"`.
               #     Any invalid field path will trigger INVALID_ARGUMENT error.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Asset::V1::ResourceSearchResult>]
@@ -1102,6 +1259,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Asset::V1::ResourceSearchResult>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::SearchAllResourcesRequest.new
+              #
+              #   # Call the search_all_resources method.
+              #   result = client.search_all_resources request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::Asset::V1::ResourceSearchResult.
+              #     p item
+              #   end
+              #
               def search_all_resources request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1217,10 +1394,10 @@ module Google
               #       principal type "user".
               #   @param page_size [::Integer]
               #     Optional. The page size for search result pagination. Page size is capped
-              #     at 500 even if a larger value is given. If set to zero, server will pick an
-              #     appropriate default. Returned results may be fewer than requested. When
-              #     this happens, there could be more results as long as `next_page_token` is
-              #     returned.
+              #     at 500 even if a larger value is given. If set to zero or a negative value,
+              #     server will pick an appropriate default. Returned results may be fewer than
+              #     requested. When this happens, there could be more results as long as
+              #     `next_page_token` is returned.
               #   @param page_token [::String]
               #     Optional. If present, retrieve the next batch of results from the preceding
               #     call to this method. `page_token` must be the value of `next_page_token`
@@ -1262,6 +1439,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Asset::V1::IamPolicySearchResult>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::SearchAllIamPoliciesRequest.new
+              #
+              #   # Call the search_all_iam_policies method.
+              #   result = client.search_all_iam_policies request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::Asset::V1::IamPolicySearchResult.
+              #     p item
+              #   end
+              #
               def search_all_iam_policies request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1355,6 +1552,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::AnalyzeIamPolicyResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::AnalyzeIamPolicyRequest.new
+              #
+              #   # Call the analyze_iam_policy method.
+              #   result = client.analyze_iam_policy request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::AnalyzeIamPolicyResponse.
+              #   p result
+              #
               def analyze_iam_policy request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1446,6 +1659,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::AnalyzeIamPolicyLongrunningRequest.new
+              #
+              #   # Call the analyze_iam_policy_longrunning method.
+              #   result = client.analyze_iam_policy_longrunning request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def analyze_iam_policy_longrunning request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1525,6 +1761,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::AnalyzeMoveResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::AnalyzeMoveRequest.new
+              #
+              #   # Call the analyze_move method.
+              #   result = client.analyze_move request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::AnalyzeMoveResponse.
+              #   p result
+              #
               def analyze_move request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1562,8 +1814,7 @@ module Google
 
               ##
               # Issue a job that queries assets using a SQL statement compatible with
-              # [BigQuery Standard
-              # SQL](http://cloud/bigquery/docs/reference/standard-sql/enabling-standard-sql).
+              # [BigQuery SQL](https://cloud.google.com/bigquery/docs/introduction-sql).
               #
               # If the query execution finishes within timeout and there's no pagination,
               # the full query results will be returned in the `QueryAssetsResponse`.
@@ -1572,9 +1823,8 @@ module Google
               # with the `job_reference` from the a previous `QueryAssets` call.
               #
               # Note, the query result has approximately 10 GB limitation enforced by
-              # BigQuery
-              # https://cloud.google.com/bigquery/docs/best-practices-performance-output,
-              # queries return larger results will result in errors.
+              # [BigQuery](https://cloud.google.com/bigquery/docs/best-practices-performance-output).
+              # Queries return larger results will result in errors.
               #
               # @overload query_assets(request, options = nil)
               #   Pass arguments to `query_assets` via a request object, either of type
@@ -1599,8 +1849,8 @@ module Google
               #
               #     Only assets belonging to the `parent` will be returned.
               #   @param statement [::String]
-              #     Optional. A SQL statement that's compatible with [BigQuery Standard
-              #     SQL](http://cloud/bigquery/docs/reference/standard-sql/enabling-standard-sql).
+              #     Optional. A SQL statement that's compatible with [BigQuery
+              #     SQL](https://cloud.google.com/bigquery/docs/introduction-sql).
               #   @param job_reference [::String]
               #     Optional. Reference to the query job, which is from the
               #     `QueryAssetsResponse` of previous `QueryAssets` call.
@@ -1654,6 +1904,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::QueryAssetsResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::QueryAssetsRequest.new
+              #
+              #   # Call the query_assets method.
+              #   result = client.query_assets request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::QueryAssetsResponse.
+              #   p result
+              #
               def query_assets request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1733,6 +1999,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::SavedQuery]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::CreateSavedQueryRequest.new
+              #
+              #   # Call the create_saved_query method.
+              #   result = client.create_saved_query request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::SavedQuery.
+              #   p result
+              #
               def create_saved_query request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1799,6 +2081,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::SavedQuery]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::GetSavedQueryRequest.new
+              #
+              #   # Call the get_saved_query method.
+              #   result = client.get_saved_query request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::SavedQuery.
+              #   p result
+              #
               def get_saved_query request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1882,6 +2180,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Asset::V1::SavedQuery>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::ListSavedQueriesRequest.new
+              #
+              #   # Call the list_saved_queries method.
+              #   result = client.list_saved_queries request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::Asset::V1::SavedQuery.
+              #     p item
+              #   end
+              #
               def list_saved_queries request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1954,6 +2272,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::SavedQuery]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::UpdateSavedQueryRequest.new
+              #
+              #   # Call the update_saved_query method.
+              #   result = client.update_saved_query request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::SavedQuery.
+              #   p result
+              #
               def update_saved_query request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2021,6 +2355,22 @@ module Google
               # @return [::Google::Protobuf::Empty]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::DeleteSavedQueryRequest.new
+              #
+              #   # Call the delete_saved_query method.
+              #   result = client.delete_saved_query request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def delete_saved_query request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2099,6 +2449,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesRequest.new
+              #
+              #   # Call the batch_get_effective_iam_policies method.
+              #   result = client.batch_get_effective_iam_policies request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesResponse.
+              #   p result
+              #
               def batch_get_effective_iam_policies request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2183,6 +2549,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Asset::V1::AnalyzeOrgPoliciesResponse::OrgPolicyResult>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::AnalyzeOrgPoliciesRequest.new
+              #
+              #   # Call the analyze_org_policies method.
+              #   result = client.analyze_org_policies request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::Asset::V1::AnalyzeOrgPoliciesResponse::OrgPolicyResult.
+              #     p item
+              #   end
+              #
               def analyze_org_policies request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2270,6 +2656,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Asset::V1::AnalyzeOrgPolicyGovernedContainersResponse::GovernedContainer>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::AnalyzeOrgPolicyGovernedContainersRequest.new
+              #
+              #   # Call the analyze_org_policy_governed_containers method.
+              #   result = client.analyze_org_policy_governed_containers request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::Asset::V1::AnalyzeOrgPolicyGovernedContainersResponse::GovernedContainer.
+              #     p item
+              #   end
+              #
               def analyze_org_policy_governed_containers request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2379,6 +2785,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Asset::V1::AnalyzeOrgPolicyGovernedAssetsResponse::GovernedAsset>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::AnalyzeOrgPolicyGovernedAssetsRequest.new
+              #
+              #   # Call the analyze_org_policy_governed_assets method.
+              #   result = client.analyze_org_policy_governed_assets request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::Asset::V1::AnalyzeOrgPolicyGovernedAssetsResponse::GovernedAsset.
+              #     p item
+              #   end
+              #
               def analyze_org_policy_governed_assets request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?