google-cloud-asset-v1 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e4cf188086cd7f80f9cf6ac3cfd9087be5e9f1e3c99d561755f5c6be11964a4a
-  data.tar.gz: ebf6196b50e1bfe2742f4f25cb56fc5f9f94a5ea0e7a7255b88c2da7ec64eb5d
+  metadata.gz: fbb4372d981825e8ce3c0a7f02a6fb309b80d5eb0461a19cfe96f6993582a5f1
+  data.tar.gz: 021a0bc123388102bae0d73a8c633af50850e73a4663db5096941e30cdbfc758
 SHA512:
-  metadata.gz: 30c335c506ddcc5be42c1058459df6173be542f1b55b1484992ddc694b1d4417b945a8b210f45e2fe2601858090682588feec9c1d470ea666fa6945689d6c073
-  data.tar.gz: d0b11a7c2f908675d474bb85099597e70f51b6a3f3d0cc2793dd3e936c57ad5ccff4ff9a6ce478c8be79b1116bd39a9ea2eab6666955db93886ad93f5c65cd3c
+  metadata.gz: 005d22cb6b6d3e92d266862a0e320a39693dd6c5a6fd2836a402c8e46a9af925b67a48e7078466634fd5230b639b643578d64667cbe91ca26d3bfcd0876da57d
+  data.tar.gz: b1e71821afea9caea0d4ab1e97cbb4c97cca95ae4f35d21fe3bd7e5c25c876e3e818b729b4a588c85d413c89cc6d0eef98af8744b40e9c6791034f1d505d3f20

data/README.md

@@ -1,4 +1,4 @@
-# Cloud Asset V1
+# Ruby Client for the Cloud Asset V1 API
 
 API Client library for the Cloud Asset V1 API
 
@@ -12,6 +12,53 @@ https://github.com/googleapis/google-cloud-ruby
 $ gem install google-cloud-asset-v1
 ```
 
+## Before You Begin
+
+In order to use this library, you first need to go through the following steps:
+
+1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
+1. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
+1. {file:AUTHENTICATION.md Set up authentication.}
+
+## Quick Start
+
+```ruby
+require "google/cloud/asset/v1"
+
+client = Google::Cloud::Asset::V1::AssetService::Client.new
+request = my_create_request
+response = client.export_assets request
+```
+
+View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-asset-v1/latest)
+for class and method documentation.
+
+## Enabling Logging
+
+To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
+The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib/libdoc/logger/rdoc/Logger.html) as shown below,
+or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
+that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
+and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
+
+Configuring a Ruby stdlib logger:
+
+```ruby
+require "logger"
+
+module MyLogger
+  LOGGER = Logger.new $stderr, level: Logger::WARN
+  def logger
+    LOGGER
+  end
+end
+
+# Define a gRPC module-level logger method before grpc/logconfig.rb loads.
+module GRPC
+  extend MyLogger
+end
+```
+
 ## Supported Ruby Versions
 
 This library is supported on Ruby 2.4+.

data/lib/google-cloud-asset-v1.rb

@@ -1 +1,21 @@
-require "google/cloud/asset/v1/version"
+# frozen_string_literal: true
+
+# Copyright 2020 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+# This gem does not autoload during Bundler.require. To load this gem,
+# issue explicit require statements for the packages desired, e.g.:
+# require "google/cloud/asset/v1"

data/lib/google/cloud/asset/v1.rb

@@ -17,3 +17,19 @@
 # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
 
 require "google/cloud/asset/v1/asset_service"
+require "google/cloud/asset/v1/version"
+
+module Google
+  module Cloud
+    module Asset
+      ##
+      # To load this package, including all its services, and instantiate a client:
+      #
+      #     require "google/cloud/asset/v1"
+      #     client = Google::Cloud::Asset::V1::AssetService::Client.new
+      #
+      module V1
+      end
+    end
+  end
+end

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

@@ -16,6 +16,35 @@
 
 # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
 
-require "google/cloud/asset/v1/asset_service/client"
-require "google/cloud/asset/v1/asset_service/operations"
+require "gapic/common"
+require "gapic/config"
+require "gapic/config/method"
+
+require "google/cloud/asset/v1/version"
+
 require "google/cloud/asset/v1/asset_service/credentials"
+require "google/cloud/asset/v1/asset_service/paths"
+require "google/cloud/asset/v1/asset_service/operations"
+require "google/cloud/asset/v1/asset_service/client"
+
+module Google
+  module Cloud
+    module Asset
+      module V1
+        ##
+        # Asset service definition.
+        #
+        # To load this service and instantiate a client:
+        #
+        #     require "google/cloud/asset/v1/asset_service"
+        #     client = Google::Cloud::Asset::V1::AssetService::Client.new
+        #
+        module AssetService
+        end
+      end
+    end
+  end
+end
+
+helper_path = ::File.join __dir__, "asset_service", "helpers.rb"
+require "google/cloud/asset/v1/asset_service/helpers" if ::File.file? helper_path

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

@@ -16,16 +16,8 @@
 
 # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
 
-require "gapic/common"
-require "gapic/config"
-require "gapic/config/method"
-
 require "google/cloud/errors"
-require "google/cloud/asset/v1/version"
 require "google/cloud/asset/v1/asset_service_pb"
-require "google/cloud/asset/v1/asset_service/credentials"
-require "google/cloud/asset/v1/asset_service/paths"
-require "google/cloud/asset/v1/asset_service/operations"
 
 module Google
   module Cloud
@@ -172,21 +164,26 @@ module Google
             # to keep track of the export.
             #
             # @overload export_assets(request, options = nil)
-            #   @param request [Google::Cloud::Asset::V1::ExportAssetsRequest | Hash]
-            #     Exports assets with time and resource types to a given Cloud Storage
-            #     location. The output format is newline-delimited JSON.
-            #     This API implements the {Google::Longrunning::Operation google.longrunning.Operation} API allowing you
-            #     to keep track of the export.
+            #   Pass arguments to `export_assets` via a request object, either of type
+            #   {Google::Cloud::Asset::V1::ExportAssetsRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Cloud::Asset::V1::ExportAssetsRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload export_assets(parent: nil, read_time: nil, asset_types: nil, content_type: nil, output_config: nil)
+            #   Pass arguments to `export_assets` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
             #   @param parent [String]
             #     Required. The relative name of the root asset. This can only be an
             #     organization number (such as "organizations/123"), a project ID (such as
             #     "projects/my-project-id"), or a project number (such as "projects/12345"),
             #     or a folder number (such as "folders/123").
-            #   @param read_time [Google::Protobuf::Timestamp | Hash]
+            #   @param read_time [Google::Protobuf::Timestamp, Hash]
             #     Timestamp to take an asset snapshot. This can only be set to a timestamp
             #     between the current time and the current time minus 35 days (inclusive).
             #     If not specified, the current time will be used. Due to delays in resource
@@ -201,11 +198,10 @@ module Google
             #   @param content_type [Google::Cloud::Asset::V1::ContentType]
             #     Asset content type. If not specified, no content but the asset name will be
             #     returned.
-            #   @param output_config [Google::Cloud::Asset::V1::OutputConfig | Hash]
+            #   @param output_config [Google::Cloud::Asset::V1::OutputConfig, Hash]
             #     Required. Output configuration indicating where the results will be output
             #     to. All results will be in newline delimited JSON format.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Gapic::Operation]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -262,18 +258,20 @@ module Google
             # error.
             #
             # @overload batch_get_assets_history(request, options = nil)
-            #   @param request [Google::Cloud::Asset::V1::BatchGetAssetsHistoryRequest | Hash]
-            #     Batch gets the update history of assets that overlap a time window.
-            #     For RESOURCE content, this API outputs history with asset in both
-            #     non-delete or deleted status.
-            #     For IAM_POLICY content, this API outputs history when the asset and its
-            #     attached IAM POLICY both exist. This can create gaps in the output history.
-            #     If a specified asset does not exist, this API returns an INVALID_ARGUMENT
-            #     error.
+            #   Pass arguments to `batch_get_assets_history` via a request object, either of type
+            #   {Google::Cloud::Asset::V1::BatchGetAssetsHistoryRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Cloud::Asset::V1::BatchGetAssetsHistoryRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload batch_get_assets_history(parent: nil, asset_names: nil, content_type: nil, read_time_window: nil)
+            #   Pass arguments to `batch_get_assets_history` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
             #   @param parent [String]
             #     Required. The relative name of the root asset. It can only be an
             #     organization number (such as "organizations/123"), a project ID (such as
@@ -291,7 +289,7 @@ module Google
             #     size of the asset name list is 100 in one request.
             #   @param content_type [Google::Cloud::Asset::V1::ContentType]
             #     Optional. The content type.
-            #   @param read_time_window [Google::Cloud::Asset::V1::TimeWindow | Hash]
+            #   @param read_time_window [Google::Cloud::Asset::V1::TimeWindow, Hash]
             #     Optional. The time window for the asset history. Both start_time and
             #     end_time are optional and if set, it must be after the current time minus
             #     35 days. If end_time is not set, it is default to current timestamp.
@@ -299,7 +297,6 @@ module Google
             #     returned. The returned results contain all temporal assets whose time
             #     window overlap with read_time_window.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Cloud::Asset::V1::BatchGetAssetsHistoryResponse]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -350,13 +347,20 @@ module Google
             # asset updates.
             #
             # @overload create_feed(request, options = nil)
-            #   @param request [Google::Cloud::Asset::V1::CreateFeedRequest | Hash]
-            #     Creates a feed in a parent project/folder/organization to listen to its
-            #     asset updates.
+            #   Pass arguments to `create_feed` via a request object, either of type
+            #   {Google::Cloud::Asset::V1::CreateFeedRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Cloud::Asset::V1::CreateFeedRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload create_feed(parent: nil, feed_id: nil, feed: nil)
+            #   Pass arguments to `create_feed` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
             #   @param parent [String]
             #     Required. The name of the project/folder/organization where this feed
             #     should be created in. It can only be an organization number (such as
@@ -366,14 +370,13 @@ module Google
             #   @param feed_id [String]
             #     Required. This is the client-assigned asset feed identifier and it needs to
             #     be unique under a specific parent project/folder/organization.
-            #   @param feed [Google::Cloud::Asset::V1::Feed | Hash]
+            #   @param feed [Google::Cloud::Asset::V1::Feed, Hash]
             #     Required. The feed details. The field `name` must be empty and it will be generated
             #     in the format of:
             #     projects/project_number/feeds/feed_id
             #     folders/folder_number/feeds/feed_id
             #     organizations/organization_number/feeds/feed_id
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Cloud::Asset::V1::Feed]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -423,19 +426,26 @@ module Google
             # Gets details about an asset feed.
             #
             # @overload get_feed(request, options = nil)
-            #   @param request [Google::Cloud::Asset::V1::GetFeedRequest | Hash]
-            #     Gets details about an asset feed.
+            #   Pass arguments to `get_feed` via a request object, either of type
+            #   {Google::Cloud::Asset::V1::GetFeedRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Cloud::Asset::V1::GetFeedRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload get_feed(name: nil)
+            #   Pass arguments to `get_feed` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
             #   @param name [String]
             #     Required. The name of the Feed and it must be in the format of:
             #     projects/project_number/feeds/feed_id
             #     folders/folder_number/feeds/feed_id
             #     organizations/organization_number/feeds/feed_id
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Cloud::Asset::V1::Feed]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -485,18 +495,25 @@ module Google
             # Lists all asset feeds in a parent project/folder/organization.
             #
             # @overload list_feeds(request, options = nil)
-            #   @param request [Google::Cloud::Asset::V1::ListFeedsRequest | Hash]
-            #     Lists all asset feeds in a parent project/folder/organization.
+            #   Pass arguments to `list_feeds` via a request object, either of type
+            #   {Google::Cloud::Asset::V1::ListFeedsRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Cloud::Asset::V1::ListFeedsRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload list_feeds(parent: nil)
+            #   Pass arguments to `list_feeds` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
             #   @param parent [String]
             #     Required. The parent project/folder/organization whose feeds are to be
             #     listed. It can only be using project/folder/organization number (such as
             #     "folders/12345")", or a project ID (such as "projects/my-project-id").
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Cloud::Asset::V1::ListFeedsResponse]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -546,24 +563,31 @@ module Google
             # Updates an asset feed configuration.
             #
             # @overload update_feed(request, options = nil)
-            #   @param request [Google::Cloud::Asset::V1::UpdateFeedRequest | Hash]
-            #     Updates an asset feed configuration.
+            #   Pass arguments to `update_feed` via a request object, either of type
+            #   {Google::Cloud::Asset::V1::UpdateFeedRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Cloud::Asset::V1::UpdateFeedRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload update_feed(feed: nil, update_mask: nil)
-            #   @param feed [Google::Cloud::Asset::V1::Feed | Hash]
+            #   Pass arguments to `update_feed` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param feed [Google::Cloud::Asset::V1::Feed, Hash]
             #     Required. The new values of feed details. It must match an existing feed and the
             #     field `name` must be in the format of:
             #     projects/project_number/feeds/feed_id or
             #     folders/folder_number/feeds/feed_id or
             #     organizations/organization_number/feeds/feed_id.
-            #   @param update_mask [Google::Protobuf::FieldMask | Hash]
+            #   @param update_mask [Google::Protobuf::FieldMask, Hash]
             #     Required. Only updates the `feed` fields indicated by this mask.
             #     The field mask must not be empty, and it must not contain fields that
             #     are immutable or only set by the server.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Cloud::Asset::V1::Feed]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -613,19 +637,26 @@ module Google
             # Deletes an asset feed.
             #
             # @overload delete_feed(request, options = nil)
-            #   @param request [Google::Cloud::Asset::V1::DeleteFeedRequest | Hash]
-            #     Deletes an asset feed.
+            #   Pass arguments to `delete_feed` via a request object, either of type
+            #   {Google::Cloud::Asset::V1::DeleteFeedRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Cloud::Asset::V1::DeleteFeedRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload delete_feed(name: nil)
+            #   Pass arguments to `delete_feed` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
             #   @param name [String]
             #     Required. The name of the feed and it must be in the format of:
             #     projects/project_number/feeds/feed_id
             #     folders/folder_number/feeds/feed_id
             #     organizations/organization_number/feeds/feed_id
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Protobuf::Empty]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -866,13 +897,3 @@ module Google
     end
   end
 end
-
-# rubocop:disable Lint/HandleExceptions
-
-# Once client is loaded, load helpers.rb if it exists.
-begin
-  require "google/cloud/asset/v1/asset_service/helpers"
-rescue LoadError
-end
-
-# rubocop:enable Lint/HandleExceptions

data/lib/google/cloud/asset/v1/asset_service/operations.rb

@@ -16,11 +16,7 @@
 
 # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
 
-require "gapic/common"
 require "gapic/operation"
-
-require "google/cloud/asset/v1/version"
-require "google/cloud/asset/v1/asset_service/client"
 require "google/longrunning/operations_pb"
 
 module Google
@@ -109,16 +105,20 @@ module Google
             # to use different resource name schemes, such as `users/*/operations`.
             #
             # @overload list_operations(request, options = nil)
-            #   @param request [Google::Longrunning::ListOperationsRequest | Hash]
-            #     Lists operations that match the specified filter in the request. If the
-            #     server doesn't support this method, it returns `UNIMPLEMENTED`.
+            #   Pass arguments to `list_operations` via a request object, either of type
+            #   {Google::Longrunning::ListOperationsRequest} or an equivalent Hash.
             #
-            #     NOTE: the `name` binding below allows API services to override the binding
-            #     to use different resource name schemes, such as `users/*/operations`.
+            #   @param request [Google::Longrunning::ListOperationsRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil)
+            #   Pass arguments to `list_operations` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
             #   @param name [String]
             #     The name of the operation collection.
             #   @param filter [String]
@@ -128,7 +128,6 @@ module Google
             #   @param page_token [String]
             #     The standard list page token.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Gapic::PagedEnumerable<Gapic::Operation>]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -182,18 +181,23 @@ module Google
             # service.
             #
             # @overload get_operation(request, options = nil)
-            #   @param request [Google::Longrunning::GetOperationRequest | Hash]
-            #     Gets the latest state of a long-running operation.  Clients can use this
-            #     method to poll the operation result at intervals as recommended by the API
-            #     service.
+            #   Pass arguments to `get_operation` via a request object, either of type
+            #   {Google::Longrunning::GetOperationRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Longrunning::GetOperationRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload get_operation(name: nil)
+            #   Pass arguments to `get_operation` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
             #   @param name [String]
             #     The name of the operation resource.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Gapic::Operation]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -247,19 +251,23 @@ module Google
             # `google.rpc.Code.UNIMPLEMENTED`.
             #
             # @overload delete_operation(request, options = nil)
-            #   @param request [Google::Longrunning::DeleteOperationRequest | Hash]
-            #     Deletes a long-running operation. This method indicates that the client is
-            #     no longer interested in the operation result. It does not cancel the
-            #     operation. If the server doesn't support this method, it returns
-            #     `google.rpc.Code.UNIMPLEMENTED`.
+            #   Pass arguments to `delete_operation` via a request object, either of type
+            #   {Google::Longrunning::DeleteOperationRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Longrunning::DeleteOperationRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload delete_operation(name: nil)
+            #   Pass arguments to `delete_operation` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
             #   @param name [String]
             #     The name of the operation resource to be deleted.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Protobuf::Empty]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -318,25 +326,23 @@ module Google
             # corresponding to `Code.CANCELLED`.
             #
             # @overload cancel_operation(request, options = nil)
-            #   @param request [Google::Longrunning::CancelOperationRequest | Hash]
-            #     Starts asynchronous cancellation on a long-running operation.  The server
-            #     makes a best effort to cancel the operation, but success is not
-            #     guaranteed.  If the server doesn't support this method, it returns
-            #     `google.rpc.Code.UNIMPLEMENTED`.  Clients can use
-            #     Operations.GetOperation or
-            #     other methods to check whether the cancellation succeeded or whether the
-            #     operation completed despite cancellation. On successful cancellation,
-            #     the operation is not deleted; instead, it becomes an operation with
-            #     an {Google::Longrunning::Operation#error Operation.error} value with a {Google::Rpc::Status#code google.rpc.Status.code} of 1,
-            #     corresponding to `Code.CANCELLED`.
+            #   Pass arguments to `cancel_operation` via a request object, either of type
+            #   {Google::Longrunning::CancelOperationRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Longrunning::CancelOperationRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload cancel_operation(name: nil)
+            #   Pass arguments to `cancel_operation` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
             #   @param name [String]
             #     The name of the operation resource to be cancelled.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Protobuf::Empty]
             # @yieldparam operation [GRPC::ActiveCall::Operation]

data/lib/google/cloud/asset/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Asset
       module V1
-        VERSION = "0.2.0"
+        VERSION = "0.2.1"
       end
     end
   end

data/proto_docs/google/iam/v1/policy.rb

@@ -24,40 +24,79 @@ module Google
       # specify access control policies for Cloud Platform resources.
       #
       #
-      # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
-      # `members` to a `role`, where the members can be user accounts, Google groups,
-      # Google domains, and service accounts. A `role` is a named list of permissions
-      # defined by IAM.
+      # A `Policy` is a collection of `bindings`. A `binding` binds one or more
+      # `members` to a single `role`. Members can be user accounts, service accounts,
+      # Google groups, and domains (such as G Suite). A `role` is a named list of
+      # permissions (defined by IAM or configured by users). A `binding` can
+      # optionally specify a `condition`, which is a logic expression that further
+      # constrains the role binding based on attributes about the request and/or
+      # target resource.
       #
-      # **Example**
+      # **JSON Example**
       #
       #     {
       #       "bindings": [
       #         {
-      #           "role": "roles/owner",
+      #           "role": "roles/resourcemanager.organizationAdmin",
       #           "members": [
       #             "user:mike@example.com",
       #             "group:admins@example.com",
       #             "domain:google.com",
-      #             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+      #             "serviceAccount:my-project-id@appspot.gserviceaccount.com"
       #           ]
       #         },
       #         {
-      #           "role": "roles/viewer",
-      #           "members": ["user:sean@example.com"]
+      #           "role": "roles/resourcemanager.organizationViewer",
+      #           "members": ["user:eve@example.com"],
+      #           "condition": {
+      #             "title": "expirable access",
+      #             "description": "Does not grant access after Sep 2020",
+      #             "expression": "request.time <
+      #             timestamp('2020-10-01T00:00:00.000Z')",
+      #           }
       #         }
       #       ]
       #     }
       #
+      # **YAML Example**
+      #
+      #     bindings:
+      #     - members:
+      #       - user:mike@example.com
+      #       - group:admins@example.com
+      #       - domain:google.com
+      #       - serviceAccount:my-project-id@appspot.gserviceaccount.com
+      #       role: roles/resourcemanager.organizationAdmin
+      #     - members:
+      #       - user:eve@example.com
+      #       role: roles/resourcemanager.organizationViewer
+      #       condition:
+      #         title: expirable access
+      #         description: Does not grant access after Sep 2020
+      #         expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
+      #
       # For a description of IAM and its features, see the
-      # [IAM developer's guide](https://cloud.google.com/iam).
+      # [IAM developer's guide](https://cloud.google.com/iam/docs).
       # @!attribute [rw] version
       #   @return [Integer]
-      #     Version of the `Policy`. The default version is 0.
+      #     Specifies the format of the policy.
+      #
+      #     Valid values are 0, 1, and 3. Requests specifying an invalid value will be
+      #     rejected.
+      #
+      #     Operations affecting conditional bindings must specify version 3. This can
+      #     be either setting a conditional policy, modifying a conditional binding,
+      #     or removing a binding (conditional or unconditional) from the stored
+      #     conditional policy.
+      #     Operations on non-conditional policies may specify any valid value or
+      #     leave the field unset.
+      #
+      #     If no etag is provided in the call to `setIamPolicy`, version compliance
+      #     checks against the stored policy is skipped.
       # @!attribute [rw] bindings
       #   @return [Array<Google::Iam::V1::Binding>]
-      #     Associates a list of `members` to a `role`.
-      #     Multiple `bindings` must not be specified for the same `role`.
+      #     Associates a list of `members` to a `role`. Optionally may specify a
+      #     `condition` that determines when binding is in effect.
       #     `bindings` with no members will result in an error.
       # @!attribute [rw] etag
       #   @return [String]
@@ -70,7 +109,9 @@ module Google
       #     ensure that their change will be applied to the same version of the policy.
       #
       #     If no `etag` is provided in the call to `setIamPolicy`, then the existing
-      #     policy is overwritten blindly.
+      #     policy is overwritten. Due to blind-set semantics of an etag-less policy,
+      #     'setIamPolicy' will not fail even if the incoming policy version does not
+      #     meet the requirements for modifying the stored policy.
       class Policy
         include Google::Protobuf::MessageExts
         extend Google::Protobuf::MessageExts::ClassMethods
@@ -81,7 +122,6 @@ module Google
       #   @return [String]
       #     Role that is assigned to `members`.
       #     For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
-      #     Required
       # @!attribute [rw] members
       #   @return [Array<String>]
       #     Specifies the identities requesting access for a Cloud Platform resource.
@@ -94,7 +134,7 @@ module Google
       #        who is authenticated with a Google account or a service account.
       #
       #     * `user:{emailid}`: An email address that represents a specific Google
-      #        account. For example, `alice@gmail.com` or `joe@example.com`.
+      #        account. For example, `alice@example.com` .
       #
       #
       #     * `serviceAccount:{emailid}`: An email address that represents a service
@@ -103,8 +143,15 @@ module Google
       #     * `group:{emailid}`: An email address that represents a Google group.
       #        For example, `admins@example.com`.
       #
-      #     * `domain:{domain}`: A Google Apps domain name that represents all the
+      #
+      #     * `domain:{domain}`: The G Suite domain (primary) that represents all the
       #        users of that domain. For example, `google.com` or `example.com`.
+      # @!attribute [rw] condition
+      #   @return [Google::Type::Expr]
+      #     The condition that is associated with this binding.
+      #     NOTE: An unsatisfied condition will not allow user access via current
+      #     binding. Different bindings, including their conditions, are examined
+      #     independently.
       class Binding
         include Google::Protobuf::MessageExts
         extend Google::Protobuf::MessageExts::ClassMethods
@@ -114,6 +161,9 @@ module Google
       # @!attribute [rw] binding_deltas
       #   @return [Array<Google::Iam::V1::BindingDelta>]
       #     The delta for Bindings between two policies.
+      # @!attribute [rw] audit_config_deltas
+      #   @return [Array<Google::Iam::V1::AuditConfigDelta>]
+      #     The delta for AuditConfigs between two policies.
       class PolicyDelta
         include Google::Protobuf::MessageExts
         extend Google::Protobuf::MessageExts::ClassMethods
@@ -135,6 +185,9 @@ module Google
       #     A single identity requesting access for a Cloud Platform resource.
       #     Follows the same format of Binding.members.
       #     Required
+      # @!attribute [rw] condition
+      #   @return [Google::Type::Expr]
+      #     The condition that is associated with this binding.
       class BindingDelta
         include Google::Protobuf::MessageExts
         extend Google::Protobuf::MessageExts::ClassMethods
@@ -151,6 +204,45 @@ module Google
           REMOVE = 2
         end
       end
+
+      # One delta entry for AuditConfig. Each individual change (only one
+      # exempted_member in each entry) to a AuditConfig will be a separate entry.
+      # @!attribute [rw] action
+      #   @return [Google::Iam::V1::AuditConfigDelta::Action]
+      #     The action that was performed on an audit configuration in a policy.
+      #     Required
+      # @!attribute [rw] service
+      #   @return [String]
+      #     Specifies a service that was configured for Cloud Audit Logging.
+      #     For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
+      #     `allServices` is a special value that covers all services.
+      #     Required
+      # @!attribute [rw] exempted_member
+      #   @return [String]
+      #     A single identity that is exempted from "data access" audit
+      #     logging for the `service` specified above.
+      #     Follows the same format of Binding.members.
+      # @!attribute [rw] log_type
+      #   @return [String]
+      #     Specifies the log_type that was be enabled. ADMIN_ACTIVITY is always
+      #     enabled, and cannot be configured.
+      #     Required
+      class AuditConfigDelta
+        include Google::Protobuf::MessageExts
+        extend Google::Protobuf::MessageExts::ClassMethods
+
+        # The type of action performed on an audit configuration in a policy.
+        module Action
+          # Unspecified.
+          ACTION_UNSPECIFIED = 0
+
+          # Addition of an audit configuration.
+          ADD = 1
+
+          # Removal of an audit configuration.
+          REMOVE = 2
+        end
+      end
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-asset-v1
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-04-02 00:00:00.000000000 Z
+date: 2020-04-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -42,16 +42,22 @@ dependencies:
   name: grpc-google-iam-v1
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.6.10
+    - - "<"
       - !ruby/object:Gem::Version
-        version: 0.6.9
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.6.10
+    - - "<"
       - !ruby/object:Gem::Version
-        version: 0.6.9
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: google-style
   requirement: !ruby/object:Gem::Requirement