google-iam-v2 0.1.2 → 0.3.0

data/lib/google/iam/v2/policies/rest/service_stub.rb

@@ -0,0 +1,343 @@
+# frozen_string_literal: true
+
+# Copyright 2023 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!
+
+require "google/iam/v2/policy_pb"
+
+module Google
+  module Iam
+    module V2
+      module Policies
+        module Rest
+          ##
+          # REST service stub for the Policies service.
+          # Service stub contains baseline method implementations
+          # including transcoding, making the REST call, and deserialing the response.
+          #
+          class ServiceStub
+            def initialize endpoint:, credentials:
+              # These require statements are intentionally placed here to initialize
+              # the REST modules only when it's required.
+              require "gapic/rest"
+
+              @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint, credentials: credentials,
+                                                           numeric_enums: true,
+                                                           raise_faraday_errors: false
+            end
+
+            ##
+            # Baseline implementation for the list_policies REST call
+            #
+            # @param request_pb [::Google::Iam::V2::ListPoliciesRequest]
+            #   A request object representing the call parameters. Required.
+            # @param options [::Gapic::CallOptions]
+            #   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+            #
+            # @yield [result, operation] Access the result along with the TransportOperation object
+            # @yieldparam result [::Google::Iam::V2::ListPoliciesResponse]
+            # @yieldparam operation [::Gapic::Rest::TransportOperation]
+            #
+            # @return [::Google::Iam::V2::ListPoliciesResponse]
+            #   A result object deserialized from the server's reply
+            def list_policies request_pb, options = nil
+              raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+              verb, uri, query_string_params, body = ServiceStub.transcode_list_policies_request request_pb
+              query_string_params = if query_string_params.any?
+                                      query_string_params.to_h { |p| p.split("=", 2) }
+                                    else
+                                      {}
+                                    end
+
+              response = @client_stub.make_http_request(
+                verb,
+                uri:     uri,
+                body:    body || "",
+                params:  query_string_params,
+                options: options
+              )
+              operation = ::Gapic::Rest::TransportOperation.new response
+              result = ::Google::Iam::V2::ListPoliciesResponse.decode_json response.body, ignore_unknown_fields: true
+
+              yield result, operation if block_given?
+              result
+            end
+
+            ##
+            # Baseline implementation for the get_policy REST call
+            #
+            # @param request_pb [::Google::Iam::V2::GetPolicyRequest]
+            #   A request object representing the call parameters. Required.
+            # @param options [::Gapic::CallOptions]
+            #   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+            #
+            # @yield [result, operation] Access the result along with the TransportOperation object
+            # @yieldparam result [::Google::Iam::V2::Policy]
+            # @yieldparam operation [::Gapic::Rest::TransportOperation]
+            #
+            # @return [::Google::Iam::V2::Policy]
+            #   A result object deserialized from the server's reply
+            def get_policy request_pb, options = nil
+              raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+              verb, uri, query_string_params, body = ServiceStub.transcode_get_policy_request request_pb
+              query_string_params = if query_string_params.any?
+                                      query_string_params.to_h { |p| p.split("=", 2) }
+                                    else
+                                      {}
+                                    end
+
+              response = @client_stub.make_http_request(
+                verb,
+                uri:     uri,
+                body:    body || "",
+                params:  query_string_params,
+                options: options
+              )
+              operation = ::Gapic::Rest::TransportOperation.new response
+              result = ::Google::Iam::V2::Policy.decode_json response.body, ignore_unknown_fields: true
+
+              yield result, operation if block_given?
+              result
+            end
+
+            ##
+            # Baseline implementation for the create_policy REST call
+            #
+            # @param request_pb [::Google::Iam::V2::CreatePolicyRequest]
+            #   A request object representing the call parameters. Required.
+            # @param options [::Gapic::CallOptions]
+            #   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+            #
+            # @yield [result, operation] Access the result along with the TransportOperation object
+            # @yieldparam result [::Google::Longrunning::Operation]
+            # @yieldparam operation [::Gapic::Rest::TransportOperation]
+            #
+            # @return [::Google::Longrunning::Operation]
+            #   A result object deserialized from the server's reply
+            def create_policy request_pb, options = nil
+              raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+              verb, uri, query_string_params, body = ServiceStub.transcode_create_policy_request request_pb
+              query_string_params = if query_string_params.any?
+                                      query_string_params.to_h { |p| p.split("=", 2) }
+                                    else
+                                      {}
+                                    end
+
+              response = @client_stub.make_http_request(
+                verb,
+                uri:     uri,
+                body:    body || "",
+                params:  query_string_params,
+                options: options
+              )
+              operation = ::Gapic::Rest::TransportOperation.new response
+              result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
+
+              yield result, operation if block_given?
+              result
+            end
+
+            ##
+            # Baseline implementation for the update_policy REST call
+            #
+            # @param request_pb [::Google::Iam::V2::UpdatePolicyRequest]
+            #   A request object representing the call parameters. Required.
+            # @param options [::Gapic::CallOptions]
+            #   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+            #
+            # @yield [result, operation] Access the result along with the TransportOperation object
+            # @yieldparam result [::Google::Longrunning::Operation]
+            # @yieldparam operation [::Gapic::Rest::TransportOperation]
+            #
+            # @return [::Google::Longrunning::Operation]
+            #   A result object deserialized from the server's reply
+            def update_policy request_pb, options = nil
+              raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+              verb, uri, query_string_params, body = ServiceStub.transcode_update_policy_request request_pb
+              query_string_params = if query_string_params.any?
+                                      query_string_params.to_h { |p| p.split("=", 2) }
+                                    else
+                                      {}
+                                    end
+
+              response = @client_stub.make_http_request(
+                verb,
+                uri:     uri,
+                body:    body || "",
+                params:  query_string_params,
+                options: options
+              )
+              operation = ::Gapic::Rest::TransportOperation.new response
+              result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
+
+              yield result, operation if block_given?
+              result
+            end
+
+            ##
+            # Baseline implementation for the delete_policy REST call
+            #
+            # @param request_pb [::Google::Iam::V2::DeletePolicyRequest]
+            #   A request object representing the call parameters. Required.
+            # @param options [::Gapic::CallOptions]
+            #   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+            #
+            # @yield [result, operation] Access the result along with the TransportOperation object
+            # @yieldparam result [::Google::Longrunning::Operation]
+            # @yieldparam operation [::Gapic::Rest::TransportOperation]
+            #
+            # @return [::Google::Longrunning::Operation]
+            #   A result object deserialized from the server's reply
+            def delete_policy request_pb, options = nil
+              raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+              verb, uri, query_string_params, body = ServiceStub.transcode_delete_policy_request request_pb
+              query_string_params = if query_string_params.any?
+                                      query_string_params.to_h { |p| p.split("=", 2) }
+                                    else
+                                      {}
+                                    end
+
+              response = @client_stub.make_http_request(
+                verb,
+                uri:     uri,
+                body:    body || "",
+                params:  query_string_params,
+                options: options
+              )
+              operation = ::Gapic::Rest::TransportOperation.new response
+              result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
+
+              yield result, operation if block_given?
+              result
+            end
+
+            ##
+            # @private
+            #
+            # GRPC transcoding helper method for the list_policies REST call
+            #
+            # @param request_pb [::Google::Iam::V2::ListPoliciesRequest]
+            #   A request object representing the call parameters. Required.
+            # @return [Array(String, [String, nil], Hash{String => String})]
+            #   Uri, Body, Query string parameters
+            def self.transcode_list_policies_request request_pb
+              transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                      .with_bindings(
+                                                        uri_method: :get,
+                                                        uri_template: "/v2/{parent}",
+                                                        matches: [
+                                                          ["parent", %r{^policies/[^/]+/[^/]+/?$}, false]
+                                                        ]
+                                                      )
+              transcoder.transcode request_pb
+            end
+
+            ##
+            # @private
+            #
+            # GRPC transcoding helper method for the get_policy REST call
+            #
+            # @param request_pb [::Google::Iam::V2::GetPolicyRequest]
+            #   A request object representing the call parameters. Required.
+            # @return [Array(String, [String, nil], Hash{String => String})]
+            #   Uri, Body, Query string parameters
+            def self.transcode_get_policy_request request_pb
+              transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                      .with_bindings(
+                                                        uri_method: :get,
+                                                        uri_template: "/v2/{name}",
+                                                        matches: [
+                                                          ["name", %r{^policies/[^/]+/[^/]+/[^/]+/?$}, false]
+                                                        ]
+                                                      )
+              transcoder.transcode request_pb
+            end
+
+            ##
+            # @private
+            #
+            # GRPC transcoding helper method for the create_policy REST call
+            #
+            # @param request_pb [::Google::Iam::V2::CreatePolicyRequest]
+            #   A request object representing the call parameters. Required.
+            # @return [Array(String, [String, nil], Hash{String => String})]
+            #   Uri, Body, Query string parameters
+            def self.transcode_create_policy_request request_pb
+              transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                      .with_bindings(
+                                                        uri_method: :post,
+                                                        uri_template: "/v2/{parent}",
+                                                        body: "policy",
+                                                        matches: [
+                                                          ["parent", %r{^policies/[^/]+/[^/]+/?$}, false]
+                                                        ]
+                                                      )
+              transcoder.transcode request_pb
+            end
+
+            ##
+            # @private
+            #
+            # GRPC transcoding helper method for the update_policy REST call
+            #
+            # @param request_pb [::Google::Iam::V2::UpdatePolicyRequest]
+            #   A request object representing the call parameters. Required.
+            # @return [Array(String, [String, nil], Hash{String => String})]
+            #   Uri, Body, Query string parameters
+            def self.transcode_update_policy_request request_pb
+              transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                      .with_bindings(
+                                                        uri_method: :put,
+                                                        uri_template: "/v2/{policy.name}",
+                                                        body: "policy",
+                                                        matches: [
+                                                          ["policy.name", %r{^policies/[^/]+/[^/]+/[^/]+/?$}, false]
+                                                        ]
+                                                      )
+              transcoder.transcode request_pb
+            end
+
+            ##
+            # @private
+            #
+            # GRPC transcoding helper method for the delete_policy REST call
+            #
+            # @param request_pb [::Google::Iam::V2::DeletePolicyRequest]
+            #   A request object representing the call parameters. Required.
+            # @return [Array(String, [String, nil], Hash{String => String})]
+            #   Uri, Body, Query string parameters
+            def self.transcode_delete_policy_request request_pb
+              transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                      .with_bindings(
+                                                        uri_method: :delete,
+                                                        uri_template: "/v2/{name}",
+                                                        matches: [
+                                                          ["name", %r{^policies/[^/]+/[^/]+/[^/]+/?$}, false]
+                                                        ]
+                                                      )
+              transcoder.transcode request_pb
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/google/iam/v2/policies/rest.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+# Copyright 2023 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!
+
+require "gapic/rest"
+require "gapic/config"
+require "gapic/config/method"
+
+require "google/iam/v2/version"
+
+require "google/iam/v2/policies/credentials"
+require "google/iam/v2/policies/rest/operations"
+require "google/iam/v2/policies/rest/client"
+
+module Google
+  module Iam
+    module V2
+      ##
+      # An interface for managing Identity and Access Management (IAM) policies.
+      #
+      # To load this service and instantiate a REST client:
+      #
+      #     require "google/iam/v2/policies/rest"
+      #     client = ::Google::Iam::V2::Policies::Rest::Client.new
+      #
+      module Policies
+        # Client for the REST transport
+        module Rest
+        end
+      end
+    end
+  end
+end
+
+helper_path = ::File.join __dir__, "rest", "helpers.rb"
+require "google/iam/v2/policies/rest/helpers" if ::File.file? helper_path

data/lib/google/iam/v2/policies.rb

@@ -25,6 +25,7 @@ require "google/iam/v2/version"
 require "google/iam/v2/policies/credentials"
 require "google/iam/v2/policies/operations"
 require "google/iam/v2/policies/client"
+require "google/iam/v2/policies/rest"
 
 module Google
   module Iam
@@ -32,11 +33,16 @@ module Google
       ##
       # An interface for managing Identity and Access Management (IAM) policies.
       #
-      # To load this service and instantiate a client:
+      # @example Load this service and instantiate a gRPC client
       #
       #     require "google/iam/v2/policies"
       #     client = ::Google::Iam::V2::Policies::Client.new
       #
+      # @example Load this service and instantiate a REST client
+      #
+      #     require "google/iam/v2/policies/rest"
+      #     client = ::Google::Iam::V2::Policies::Rest::Client.new
+      #
       module Policies
       end
     end

data/lib/google/iam/v2/policy_pb.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/iam/v2/policy.proto
 
@@ -10,55 +11,33 @@ require 'google/iam/v2/deny_pb'
 require 'google/longrunning/operations_pb'
 require 'google/protobuf/timestamp_pb'
 
-Google::Protobuf::DescriptorPool.generated_pool.build do
-  add_file("google/iam/v2/policy.proto", :syntax => :proto3) do
-    add_message "google.iam.v2.Policy" do
-      optional :name, :string, 1
-      optional :uid, :string, 2
-      optional :kind, :string, 3
-      optional :display_name, :string, 4
-      map :annotations, :string, :string, 5
-      optional :etag, :string, 6
-      optional :create_time, :message, 7, "google.protobuf.Timestamp"
-      optional :update_time, :message, 8, "google.protobuf.Timestamp"
-      optional :delete_time, :message, 9, "google.protobuf.Timestamp"
-      repeated :rules, :message, 10, "google.iam.v2.PolicyRule"
-      optional :managing_authority, :string, 11
-    end
-    add_message "google.iam.v2.PolicyRule" do
-      optional :description, :string, 1
-      oneof :kind do
-        optional :deny_rule, :message, 2, "google.iam.v2.DenyRule"
-      end
-    end
-    add_message "google.iam.v2.ListPoliciesRequest" do
-      optional :parent, :string, 1
-      optional :page_size, :int32, 2
-      optional :page_token, :string, 3
-    end
-    add_message "google.iam.v2.ListPoliciesResponse" do
-      repeated :policies, :message, 1, "google.iam.v2.Policy"
-      optional :next_page_token, :string, 2
-    end
-    add_message "google.iam.v2.GetPolicyRequest" do
-      optional :name, :string, 1
-    end
-    add_message "google.iam.v2.CreatePolicyRequest" do
-      optional :parent, :string, 1
-      optional :policy, :message, 2, "google.iam.v2.Policy"
-      optional :policy_id, :string, 3
-    end
-    add_message "google.iam.v2.UpdatePolicyRequest" do
-      optional :policy, :message, 1, "google.iam.v2.Policy"
-    end
-    add_message "google.iam.v2.DeletePolicyRequest" do
-      optional :name, :string, 1
-      optional :etag, :string, 2
-    end
-    add_message "google.iam.v2.PolicyOperationMetadata" do
-      optional :create_time, :message, 1, "google.protobuf.Timestamp"
+
+descriptor_data = "\n\x1agoogle/iam/v2/policy.proto\x12\rgoogle.iam.v2\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x18google/iam/v2/deny.proto\x1a#google/longrunning/operations.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\xc2\x03\n\x06Policy\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x05\x12\x10\n\x03uid\x18\x02 \x01(\tB\x03\xe0\x41\x05\x12\x11\n\x04kind\x18\x03 \x01(\tB\x03\xe0\x41\x03\x12\x14\n\x0c\x64isplay_name\x18\x04 \x01(\t\x12;\n\x0b\x61nnotations\x18\x05 \x03(\x0b\x32&.google.iam.v2.Policy.AnnotationsEntry\x12\x0c\n\x04\x65tag\x18\x06 \x01(\t\x12\x34\n\x0b\x63reate_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12\x34\n\x0bupdate_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12\x34\n\x0b\x64\x65lete_time\x18\t \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12(\n\x05rules\x18\n \x03(\x0b\x32\x19.google.iam.v2.PolicyRule\x12\x1f\n\x12managing_authority\x18\x0b \x01(\tB\x03\xe0\x41\x05\x1a\x32\n\x10\x41nnotationsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"W\n\nPolicyRule\x12,\n\tdeny_rule\x18\x02 \x01(\x0b\x32\x17.google.iam.v2.DenyRuleH\x00\x12\x13\n\x0b\x64\x65scription\x18\x01 \x01(\tB\x06\n\x04kind\"Q\n\x13ListPoliciesRequest\x12\x13\n\x06parent\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\"X\n\x14ListPoliciesResponse\x12\'\n\x08policies\x18\x01 \x03(\x0b\x32\x15.google.iam.v2.Policy\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\"%\n\x10GetPolicyRequest\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x02\"i\n\x13\x43reatePolicyRequest\x12\x13\n\x06parent\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12*\n\x06policy\x18\x02 \x01(\x0b\x32\x15.google.iam.v2.PolicyB\x03\xe0\x41\x02\x12\x11\n\tpolicy_id\x18\x03 \x01(\t\"A\n\x13UpdatePolicyRequest\x12*\n\x06policy\x18\x01 \x01(\x0b\x32\x15.google.iam.v2.PolicyB\x03\xe0\x41\x02\";\n\x13\x44\x65letePolicyRequest\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x11\n\x04\x65tag\x18\x02 \x01(\tB\x03\xe0\x41\x01\"J\n\x17PolicyOperationMetadata\x12/\n\x0b\x63reate_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp2\xd0\x06\n\x08Policies\x12\x83\x01\n\x0cListPolicies\x12\".google.iam.v2.ListPoliciesRequest\x1a#.google.iam.v2.ListPoliciesResponse\"*\x82\xd3\xe4\x93\x02\x1b\x12\x19/v2/{parent=policies/*/*}\xda\x41\x06parent\x12m\n\tGetPolicy\x12\x1f.google.iam.v2.GetPolicyRequest\x1a\x15.google.iam.v2.Policy\"(\x82\xd3\xe4\x93\x02\x1b\x12\x19/v2/{name=policies/*/*/*}\xda\x41\x04name\x12\xba\x01\n\x0c\x43reatePolicy\x12\".google.iam.v2.CreatePolicyRequest\x1a\x1d.google.longrunning.Operation\"g\x82\xd3\xe4\x93\x02#\"\x19/v2/{parent=policies/*/*}:\x06policy\xda\x41\x17parent,policy,policy_id\xca\x41!\n\x06Policy\x12\x17PolicyOperationMetadata\x12\xa7\x01\n\x0cUpdatePolicy\x12\".google.iam.v2.UpdatePolicyRequest\x1a\x1d.google.longrunning.Operation\"T\x82\xd3\xe4\x93\x02*\x1a /v2/{policy.name=policies/*/*/*}:\x06policy\xca\x41!\n\x06Policy\x12\x17PolicyOperationMetadata\x12\x9f\x01\n\x0c\x44\x65letePolicy\x12\".google.iam.v2.DeletePolicyRequest\x1a\x1d.google.longrunning.Operation\"L\x82\xd3\xe4\x93\x02\x1b*\x19/v2/{name=policies/*/*/*}\xda\x41\x04name\xca\x41!\n\x06Policy\x12\x17PolicyOperationMetadata\x1a\x46\xca\x41\x12iam.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformBy\n\x11\x63om.google.iam.v2B\x0bPolicyProtoP\x01Z)cloud.google.com/go/iam/apiv2/iampb;iampb\xaa\x02\x13Google.Cloud.Iam.V2\xca\x02\x13Google\\Cloud\\Iam\\V2b\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError => e
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+    ["google.protobuf.Timestamp", "google/protobuf/timestamp.proto"],
+    ["google.iam.v2.DenyRule", "google/iam/v2/deny.proto"],
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
     end
   end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
 end
 
 module Google

data/lib/google/iam/v2/rest.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+# Copyright 2023 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!
+
+require "google/iam/v2/policies/rest"
+require "google/iam/v2/version"
+
+module Google
+  module Iam
+    ##
+    # To load just the REST part of this package, including all its services, and instantiate a REST client:
+    #
+    # @example
+    #
+    #     require "google/iam/v2/rest"
+    #     client = ::Google::Iam::V2::Policies::Rest::Client.new
+    #
+    module V2
+    end
+  end
+end

data/lib/google/iam/v2/version.rb

@@ -20,7 +20,7 @@
 module Google
   module Iam
     module V2
-      VERSION = "0.1.2"
+      VERSION = "0.3.0"
     end
   end
 end

data/lib/google/iam/v2.rb

@@ -22,13 +22,18 @@ require "google/iam/v2/version"
 module Google
   module Iam
     ##
-    # To load this package, including all its services, and instantiate a client:
+    # API client module.
     #
-    # @example
+    # @example Load this package, including all its services, and instantiate a gRPC client
     #
     #     require "google/iam/v2"
     #     client = ::Google::Iam::V2::Policies::Client.new
     #
+    # @example Load this package, including all its services, and instantiate a REST client
+    #
+    #     require "google/iam/v2"
+    #     client = ::Google::Iam::V2::Policies::Rest::Client.new
+    #
     module V2
     end
   end