google-cloud-resource_manager-v3 0.3.0 → 0.5.0

data/lib/google/cloud/resource_manager/v3/folders/rest.rb

@@ -0,0 +1,55 @@
+# 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/cloud/resource_manager/v3/version"
+
+require "google/cloud/resource_manager/v3/folders/credentials"
+require "google/cloud/resource_manager/v3/folders/paths"
+require "google/cloud/resource_manager/v3/folders/rest/operations"
+require "google/cloud/resource_manager/v3/folders/rest/client"
+
+module Google
+  module Cloud
+    module ResourceManager
+      module V3
+        ##
+        # Manages Cloud Platform folder resources.
+        # Folders can be used to organize the resources under an
+        # organization and to control the policies applied to groups of resources.
+        #
+        # To load this service and instantiate a REST client:
+        #
+        #     require "google/cloud/resource_manager/v3/folders/rest"
+        #     client = ::Google::Cloud::ResourceManager::V3::Folders::Rest::Client.new
+        #
+        module Folders
+          # Client for the REST transport
+          module Rest
+          end
+        end
+      end
+    end
+  end
+end
+
+helper_path = ::File.join __dir__, "rest", "helpers.rb"
+require "google/cloud/resource_manager/v3/folders/rest/helpers" if ::File.file? helper_path

data/lib/google/cloud/resource_manager/v3/folders.rb

@@ -26,6 +26,7 @@ require "google/cloud/resource_manager/v3/folders/credentials"
 require "google/cloud/resource_manager/v3/folders/paths"
 require "google/cloud/resource_manager/v3/folders/operations"
 require "google/cloud/resource_manager/v3/folders/client"
+require "google/cloud/resource_manager/v3/folders/rest"
 
 module Google
   module Cloud
@@ -36,11 +37,16 @@ module Google
         # Folders can be used to organize the resources under an
         # organization and to control the policies applied to groups of resources.
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/resource_manager/v3/folders"
         #     client = ::Google::Cloud::ResourceManager::V3::Folders::Client.new
         #
+        # @example Load this service and instantiate a REST client
+        #
+        #     require "google/cloud/resource_manager/v3/folders/rest"
+        #     client = ::Google::Cloud::ResourceManager::V3::Folders::Rest::Client.new
+        #
         module Folders
         end
       end

data/lib/google/cloud/resource_manager/v3/organizations/client.rb

@@ -177,9 +177,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The resource name of the Organization to fetch. This is the organization's
-            #     relative path in the API, formatted as "organizations/[organizationId]".
-            #     For example, "organizations/1234".
+            #     Required. The resource name of the Organization to fetch. This is the
+            #     organization's relative path in the API, formatted as
+            #     "organizations/[organizationId]". For example, "organizations/1234".
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::ResourceManager::V3::Organization]
@@ -271,13 +271,15 @@ module Google
             #
             #   @param page_size [::Integer]
             #     Optional. The maximum number of organizations to return in the response.
-            #     If unspecified, server picks an appropriate default.
+            #     The server can return fewer organizations than requested. If unspecified,
+            #     server picks an appropriate default.
             #   @param page_token [::String]
-            #     Optional. A pagination token returned from a previous call to `SearchOrganizations`
-            #     that indicates from where listing should continue.
+            #     Optional. A pagination token returned from a previous call to
+            #     `SearchOrganizations` that indicates from where listing should continue.
             #   @param query [::String]
-            #     Optional. An optional query string used to filter the Organizations to return in
-            #     the response. Query rules are case-insensitive.
+            #     Optional. An optional query string used to filter the Organizations to
+            #     return in the response. Query rules are case-insensitive.
+            #
             #
             #     ```
             #     | Field            | Description                                |
@@ -315,13 +317,11 @@ module Google
             #   # Call the search_organizations method.
             #   result = client.search_organizations request
             #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can
-            #   # iterate over all elements by calling #each, and the enumerable
-            #   # will lazily make API calls to fetch subsequent pages. Other
-            #   # methods are also available for managing paging directly.
-            #   result.each do |response|
+            #   # 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::ResourceManager::V3::Organization.
-            #     p response
+            #     p item
             #   end
             #
             def search_organizations request, options = nil
@@ -687,9 +687,9 @@ module Google
             #    *  (`String`) The path to a service account key file in JSON format
             #    *  (`Hash`) A service account key as a Hash
             #    *  (`Google::Auth::Credentials`) A googleauth credentials object
-            #       (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
+            #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
             #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
-            #       (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
+            #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
             #    *  (`GRPC::Core::Channel`) a gRPC channel with included credentials
             #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
             #    *  (`nil`) indicating no credentials