google-cloud-resource_manager-v3 0.4.0 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 32d1fb7149f69726573b065cb5d2b5cb4cff94813c08d1594ce4758569a871fa
-  data.tar.gz: 1b0e2ed2a459d2c4047a35f2d2cf7dc870e9a861d3a6e90590310ebd9dc1e0d8
+  metadata.gz: 4ce80b7a20806fd70f73a21b33dab7e23d2fd0074ec3e799b466129aeed81c89
+  data.tar.gz: 515d2179248a51b5bdfecfd231eb105b5cd3ba2435e5ab399678cfac6137eb67
 SHA512:
-  metadata.gz: bcfa4939eef4a80768d48c8ebee090c5bb034655327f80f6fff3e29269fb75118318ce9138197f82a36e17a3c09adeeddf1021fe819adb913a460e550934bdc1
-  data.tar.gz: 45583f5b44936d9ba558c9df9fb1dade858ad8f3ae0d8c980aa2dbf9492487fe9e4ad47284af11fbe8e4c71e7ae3f6dd903aee4d172b9491d2e13465d4202a37
+  metadata.gz: 7d56ea3e66247fce5ee953dee8afbefaf2daf191aa57a818844ea7031f2fb22fd28506382b9577845ea3a07423de38d25d9d9b4475cbb02f17ee1dd715c23145
+  data.tar.gz: 9c278cc225d69d099e2fe4d81df12bdacea221a136ba3424d82bb3c007f25581b21e52f34b04eb667facbda8e4bad1a7b4078aa122ff3026fd67cb80d99e2d22

data/README.md

@@ -47,7 +47,7 @@ for general usage information.
 
 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/current/stdlibs/logger/Logger.html) as shown below,
-or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
+or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/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.
 

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

@@ -303,14 +303,19 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The resource name of the organization or folder whose folders are
-            #     being listed.
-            #     Must be of the form `folders/{folder_id}` or `organizations/{org_id}`.
+            #     Required. The name of the parent resource whose folders are being listed.
+            #     Only children of this parent resource are listed; descendants are not
+            #     listed.
+            #
+            #     If the parent is a folder, use the value `folders/{folder_id}`. If the
+            #     parent is an organization, use the value `organizations/{org_id}`.
+            #
             #     Access to this method is controlled by checking the
             #     `resourcemanager.folders.list` permission on the `parent`.
             #   @param page_size [::Integer]
-            #     Optional. The maximum number of folders to return in the response.
-            #     If unspecified, server picks an appropriate default.
+            #     Optional. The maximum number of folders to return in the response. The
+            #     server can return fewer folders than requested. If unspecified, server
+            #     picks an appropriate default.
             #   @param page_token [::String]
             #     Optional. A pagination token returned from a previous call to `ListFolders`
             #     that indicates where this listing should continue from.
@@ -404,11 +409,12 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param page_size [::Integer]
-            #     Optional. The maximum number of folders to return in the response.
-            #     If unspecified, server picks an appropriate default.
+            #     Optional. The maximum number of folders to return in the response. The
+            #     server can return fewer folders than requested. If unspecified, server
+            #     picks an appropriate default.
             #   @param page_token [::String]
-            #     Optional. A pagination token returned from a previous call to `SearchFolders`
-            #     that indicates from where search should continue.
+            #     Optional. A pagination token returned from a previous call to
+            #     `SearchFolders` that indicates from where search should continue.
             #   @param query [::String]
             #     Optional. Search criteria used to select the folders to return.
             #     If no search criteria is specified then all accessible folders will be
@@ -548,8 +554,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param folder [::Google::Cloud::ResourceManager::V3::Folder, ::Hash]
-            #     Required. The folder being created, only the display name and parent will be
-            #     consulted. All other fields will be ignored.
+            #     Required. The folder being created, only the display name and parent will
+            #     be consulted. All other fields will be ignored.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]
@@ -619,7 +625,9 @@ module Google
             # Updates a folder, changing its `display_name`.
             # Changes to the folder `display_name` will be rejected if they violate
             # either the `display_name` formatting rules or the naming constraints
-            # described in the {::Google::Cloud::ResourceManager::V3::Folders::Client#create_folder CreateFolder} documentation.
+            # described in the
+            # {::Google::Cloud::ResourceManager::V3::Folders::Client#create_folder CreateFolder}
+            # documentation.
             #
             # The folder's `display_name` must start and end with a letter or digit,
             # may contain letters, digits, spaces, hyphens and underscores and can be
@@ -648,8 +656,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param folder [::Google::Cloud::ResourceManager::V3::Folder, ::Hash]
-            #     Required. The new definition of the Folder. It must include the `name` field, which
-            #     cannot be changed.
+            #     Required. The new definition of the Folder. It must include the `name`
+            #     field, which cannot be changed.
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Required. Fields to be updated.
             #     Only the `display_name` can be updated.
@@ -741,9 +749,9 @@ module Google
             # `FolderOperation` message as an aid to stateless clients.
             # Folder moves will be rejected if they violate either the naming, height,
             # or fanout constraints described in the
-            # {::Google::Cloud::ResourceManager::V3::Folders::Client#create_folder CreateFolder} documentation.
-            # The caller must have `resourcemanager.folders.move` permission on the
-            # folder's current and proposed new parent.
+            # {::Google::Cloud::ResourceManager::V3::Folders::Client#create_folder CreateFolder}
+            # documentation. The caller must have `resourcemanager.folders.move`
+            # permission on the folder's current and proposed new parent.
             #
             # @overload move_folder(request, options = nil)
             #   Pass arguments to `move_folder` via a request object, either of type
@@ -764,9 +772,9 @@ module Google
             #     Required. The resource name of the Folder to move.
             #     Must be of the form folders/\\{folder_id}
             #   @param destination_parent [::String]
-            #     Required. The resource name of the folder or organization which should be the
-            #     folder's new parent.
-            #     Must be of the form `folders/{folder_id}` or `organizations/{org_id}`.
+            #     Required. The resource name of the folder or organization which should be
+            #     the folder's new parent. Must be of the form `folders/{folder_id}` or
+            #     `organizations/{org_id}`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]
@@ -842,11 +850,13 @@ module Google
 
             ##
             # Requests deletion of a folder. The folder is moved into the
-            # {::Google::Cloud::ResourceManager::V3::Folder::State::DELETE_REQUESTED DELETE_REQUESTED} state
-            # immediately, and is deleted approximately 30 days later. This method may
-            # only be called on an empty folder, where a folder is empty if it doesn't
-            # contain any folders or projects in the {::Google::Cloud::ResourceManager::V3::Folder::State::ACTIVE ACTIVE} state.
-            # If called on a folder in {::Google::Cloud::ResourceManager::V3::Folder::State::DELETE_REQUESTED DELETE_REQUESTED}
+            # {::Google::Cloud::ResourceManager::V3::Folder::State::DELETE_REQUESTED DELETE_REQUESTED}
+            # state immediately, and is deleted approximately 30 days later. This method
+            # may only be called on an empty folder, where a folder is empty if it
+            # doesn't contain any folders or projects in the
+            # {::Google::Cloud::ResourceManager::V3::Folder::State::ACTIVE ACTIVE} state. If
+            # called on a folder in
+            # {::Google::Cloud::ResourceManager::V3::Folder::State::DELETE_REQUESTED DELETE_REQUESTED}
             # state the operation will result in a no-op success.
             # The caller must have `resourcemanager.folders.delete` permission on the
             # identified folder.
@@ -944,14 +954,16 @@ module Google
 
             ##
             # Cancels the deletion request for a folder. This method may be called on a
-            # folder in any state. If the folder is in the {::Google::Cloud::ResourceManager::V3::Folder::State::ACTIVE ACTIVE}
-            # state the result will be a no-op success. In order to succeed, the folder's
-            # parent must be in the {::Google::Cloud::ResourceManager::V3::Folder::State::ACTIVE ACTIVE} state. In addition,
-            # reintroducing the folder into the tree must not violate folder naming,
-            # height, and fanout constraints described in the
-            # {::Google::Cloud::ResourceManager::V3::Folders::Client#create_folder CreateFolder} documentation.
-            # The caller must have `resourcemanager.folders.undelete` permission on the
-            # identified folder.
+            # folder in any state. If the folder is in the
+            # {::Google::Cloud::ResourceManager::V3::Folder::State::ACTIVE ACTIVE} state the
+            # result will be a no-op success. In order to succeed, the folder's parent
+            # must be in the
+            # {::Google::Cloud::ResourceManager::V3::Folder::State::ACTIVE ACTIVE} state. In
+            # addition, reintroducing the folder into the tree must not violate folder
+            # naming, height, and fanout constraints described in the
+            # {::Google::Cloud::ResourceManager::V3::Folders::Client#create_folder CreateFolder}
+            # documentation. The caller must have `resourcemanager.folders.undelete`
+            # permission on the identified folder.
             #
             # @overload undelete_folder(request, options = nil)
             #   Pass arguments to `undelete_folder` via a request object, either of type
@@ -1371,9 +1383,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

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

@@ -620,9 +620,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

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

@@ -271,14 +271,19 @@ module Google
               #   the default parameter values, pass an empty Hash as a request object (see above).
               #
               #   @param parent [::String]
-              #     Required. The resource name of the organization or folder whose folders are
-              #     being listed.
-              #     Must be of the form `folders/{folder_id}` or `organizations/{org_id}`.
+              #     Required. The name of the parent resource whose folders are being listed.
+              #     Only children of this parent resource are listed; descendants are not
+              #     listed.
+              #
+              #     If the parent is a folder, use the value `folders/{folder_id}`. If the
+              #     parent is an organization, use the value `organizations/{org_id}`.
+              #
               #     Access to this method is controlled by checking the
               #     `resourcemanager.folders.list` permission on the `parent`.
               #   @param page_size [::Integer]
-              #     Optional. The maximum number of folders to return in the response.
-              #     If unspecified, server picks an appropriate default.
+              #     Optional. The maximum number of folders to return in the response. The
+              #     server can return fewer folders than requested. If unspecified, server
+              #     picks an appropriate default.
               #   @param page_token [::String]
               #     Optional. A pagination token returned from a previous call to `ListFolders`
               #     that indicates where this listing should continue from.
@@ -353,11 +358,12 @@ module Google
               #   the default parameter values, pass an empty Hash as a request object (see above).
               #
               #   @param page_size [::Integer]
-              #     Optional. The maximum number of folders to return in the response.
-              #     If unspecified, server picks an appropriate default.
+              #     Optional. The maximum number of folders to return in the response. The
+              #     server can return fewer folders than requested. If unspecified, server
+              #     picks an appropriate default.
               #   @param page_token [::String]
-              #     Optional. A pagination token returned from a previous call to `SearchFolders`
-              #     that indicates from where search should continue.
+              #     Optional. A pagination token returned from a previous call to
+              #     `SearchFolders` that indicates from where search should continue.
               #   @param query [::String]
               #     Optional. Search criteria used to select the folders to return.
               #     If no search criteria is specified then all accessible folders will be
@@ -478,8 +484,8 @@ module Google
               #   the default parameter values, pass an empty Hash as a request object (see above).
               #
               #   @param folder [::Google::Cloud::ResourceManager::V3::Folder, ::Hash]
-              #     Required. The folder being created, only the display name and parent will be
-              #     consulted. All other fields will be ignored.
+              #     Required. The folder being created, only the display name and parent will
+              #     be consulted. All other fields will be ignored.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Gapic::Operation]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -527,7 +533,9 @@ module Google
               # Updates a folder, changing its `display_name`.
               # Changes to the folder `display_name` will be rejected if they violate
               # either the `display_name` formatting rules or the naming constraints
-              # described in the {::Google::Cloud::ResourceManager::V3::Folders::Rest::Client#create_folder CreateFolder} documentation.
+              # described in the
+              # {::Google::Cloud::ResourceManager::V3::Folders::Rest::Client#create_folder CreateFolder}
+              # documentation.
               #
               # The folder's `display_name` must start and end with a letter or digit,
               # may contain letters, digits, spaces, hyphens and underscores and can be
@@ -556,8 +564,8 @@ module Google
               #   the default parameter values, pass an empty Hash as a request object (see above).
               #
               #   @param folder [::Google::Cloud::ResourceManager::V3::Folder, ::Hash]
-              #     Required. The new definition of the Folder. It must include the `name` field, which
-              #     cannot be changed.
+              #     Required. The new definition of the Folder. It must include the `name`
+              #     field, which cannot be changed.
               #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
               #     Required. Fields to be updated.
               #     Only the `display_name` can be updated.
@@ -619,9 +627,9 @@ module Google
               # `FolderOperation` message as an aid to stateless clients.
               # Folder moves will be rejected if they violate either the naming, height,
               # or fanout constraints described in the
-              # {::Google::Cloud::ResourceManager::V3::Folders::Rest::Client#create_folder CreateFolder} documentation.
-              # The caller must have `resourcemanager.folders.move` permission on the
-              # folder's current and proposed new parent.
+              # {::Google::Cloud::ResourceManager::V3::Folders::Rest::Client#create_folder CreateFolder}
+              # documentation. The caller must have `resourcemanager.folders.move`
+              # permission on the folder's current and proposed new parent.
               #
               # @overload move_folder(request, options = nil)
               #   Pass arguments to `move_folder` via a request object, either of type
@@ -642,9 +650,9 @@ module Google
               #     Required. The resource name of the Folder to move.
               #     Must be of the form folders/\\{folder_id}
               #   @param destination_parent [::String]
-              #     Required. The resource name of the folder or organization which should be the
-              #     folder's new parent.
-              #     Must be of the form `folders/{folder_id}` or `organizations/{org_id}`.
+              #     Required. The resource name of the folder or organization which should be
+              #     the folder's new parent. Must be of the form `folders/{folder_id}` or
+              #     `organizations/{org_id}`.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Gapic::Operation]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -690,11 +698,13 @@ module Google
 
               ##
               # Requests deletion of a folder. The folder is moved into the
-              # {::Google::Cloud::ResourceManager::V3::Folder::State::DELETE_REQUESTED DELETE_REQUESTED} state
-              # immediately, and is deleted approximately 30 days later. This method may
-              # only be called on an empty folder, where a folder is empty if it doesn't
-              # contain any folders or projects in the {::Google::Cloud::ResourceManager::V3::Folder::State::ACTIVE ACTIVE} state.
-              # If called on a folder in {::Google::Cloud::ResourceManager::V3::Folder::State::DELETE_REQUESTED DELETE_REQUESTED}
+              # {::Google::Cloud::ResourceManager::V3::Folder::State::DELETE_REQUESTED DELETE_REQUESTED}
+              # state immediately, and is deleted approximately 30 days later. This method
+              # may only be called on an empty folder, where a folder is empty if it
+              # doesn't contain any folders or projects in the
+              # {::Google::Cloud::ResourceManager::V3::Folder::State::ACTIVE ACTIVE} state. If
+              # called on a folder in
+              # {::Google::Cloud::ResourceManager::V3::Folder::State::DELETE_REQUESTED DELETE_REQUESTED}
               # state the operation will result in a no-op success.
               # The caller must have `resourcemanager.folders.delete` permission on the
               # identified folder.
@@ -762,14 +772,16 @@ module Google
 
               ##
               # Cancels the deletion request for a folder. This method may be called on a
-              # folder in any state. If the folder is in the {::Google::Cloud::ResourceManager::V3::Folder::State::ACTIVE ACTIVE}
-              # state the result will be a no-op success. In order to succeed, the folder's
-              # parent must be in the {::Google::Cloud::ResourceManager::V3::Folder::State::ACTIVE ACTIVE} state. In addition,
-              # reintroducing the folder into the tree must not violate folder naming,
-              # height, and fanout constraints described in the
-              # {::Google::Cloud::ResourceManager::V3::Folders::Rest::Client#create_folder CreateFolder} documentation.
-              # The caller must have `resourcemanager.folders.undelete` permission on the
-              # identified folder.
+              # folder in any state. If the folder is in the
+              # {::Google::Cloud::ResourceManager::V3::Folder::State::ACTIVE ACTIVE} state the
+              # result will be a no-op success. In order to succeed, the folder's parent
+              # must be in the
+              # {::Google::Cloud::ResourceManager::V3::Folder::State::ACTIVE ACTIVE} state. In
+              # addition, reintroducing the folder into the tree must not violate folder
+              # naming, height, and fanout constraints described in the
+              # {::Google::Cloud::ResourceManager::V3::Folders::Rest::Client#create_folder CreateFolder}
+              # documentation. The caller must have `resourcemanager.folders.undelete`
+              # permission on the identified folder.
               #
               # @overload undelete_folder(request, options = nil)
               #   Pass arguments to `undelete_folder` via a request object, either of type
@@ -1090,9 +1102,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))
               #    *  (`nil`) indicating no credentials
               #   @return [::Object]
               # @!attribute [rw] scope

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

@@ -411,9 +411,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))
               #    *  (`nil`) indicating no credentials
               #   @return [::Object]
               # @!attribute [rw] scope

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                                |
@@ -685,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

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

@@ -168,9 +168,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 [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Google::Cloud::ResourceManager::V3::Organization]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -239,13 +239,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                                |
@@ -565,9 +567,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))
               #    *  (`nil`) indicating no credentials
               #   @return [::Object]
               # @!attribute [rw] scope