google-apis-iam_v1 0.57.0 → 0.58.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bf3ee28d164f715af7b24104a7894e9a8d458d07daac23b4c45463d1b2ee0908
-  data.tar.gz: c839e4b6035c0c5636dc17c721cab5c09db1064f16b1f2715d7e2235113ed751
+  metadata.gz: 6f9d281593997c787da4fa82daba4dbc8078b1abbd7ec381b234016ea83e2d1f
+  data.tar.gz: 476e992d2e353596d46aa84a827917cb77c08a900a66651f42d35a42c7258547
 SHA512:
-  metadata.gz: 409d207b02d976a597350369b97591aefdf43ab23b36e79bf562f56921ace01d09ccc30f7fc10e5672c1197138f22cc8a8a8b28cf25f49246d17e2a10f4b0be8
-  data.tar.gz: 6b0ab91c05700f5a6a991b637ae5c33f0df731b81bdccb1de920196bcc1ca4eef29fa9b55b4b7d90ca248b1d24fb6558f08d9a21e5e2a5197f2ca629958be47a
+  metadata.gz: 17cf034754341a4e13d9c10c868ff80c7fd0a850789f3a41d66e92f71e6f1b3c71b88a96ea976226c79afb0d1954d156cffe07b34c51cda57b467afa93e19cf0
+  data.tar.gz: ff2e17ed6ccafd4ae447dc521c57483ed3bfc9b16cf7e2dc1420c6a9efe9d27c17bfabe808325de87cda82240e7e502a5b32e6b6b7e5ac8f58cb9c9509bea429

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Release history for google-apis-iam_v1
 
+### v0.58.0 (2024-05-26)
+
+* Regenerated from discovery document revision 20240521
+* Regenerated using generator version 0.15.0
+
 ### v0.57.0 (2024-04-28)
 
 * Regenerated from discovery document revision 20240418

data/lib/google/apis/iam_v1/classes.rb

@@ -1066,7 +1066,7 @@ module Google
       class ListOauthClientCredentialsResponse
         include Google::Apis::Core::Hashable
       
-        # A list of oauth client credentials.
+        # A list of OauthClientCredentials.
         # Corresponds to the JSON property `oauthClientCredentials`
         # @return [Array<Google::Apis::IamV1::OauthClientCredential>]
         attr_accessor :oauth_client_credentials
@@ -1091,7 +1091,7 @@ module Google
         # @return [String]
         attr_accessor :next_page_token
       
-        # A list of oauth clients.
+        # A list of OauthClients.
         # Corresponds to the JSON property `oauthClients`
         # @return [Array<Google::Apis::IamV1::OauthClient>]
         attr_accessor :oauth_clients
@@ -1334,13 +1334,13 @@ module Google
         end
       end
       
-      # Represents an oauth client. Used to access Google Cloud resources on behave of
-      # a user by using OAuth2 Protocol to obtain an access token from Google Cloud
+      # Represents an OauthClient. Used to access Google Cloud resources on behave of
+      # a user by using OAuth 2.0 Protocol to obtain an access token from Google Cloud
       # Platform.
       class OauthClient
         include Google::Apis::Core::Hashable
       
-        # Required. The list of OAuth grant type is allowed for the oauth client.
+        # Required. The list of OAuth grant types is allowed for the OauthClient.
         # Corresponds to the JSON property `allowedGrantTypes`
         # @return [Array<String>]
         attr_accessor :allowed_grant_types
@@ -1351,58 +1351,60 @@ module Google
         # @return [Array<String>]
         attr_accessor :allowed_redirect_uris
       
-        # Required. The list of scopes that the oauth client is allowed to request
-        # during OAuth flows. The following scopes are supported: * `https://www.
-        # googleapis.com/auth/cloud-platform`: See, edit, configure, and delete your
-        # Google Cloud data and see the email address for your Google Account. * `openid`
-        # : Associate you with your personal info on Google Cloud. * `email`: See your
-        # Google Cloud Account email address.
+        # Required. The list of scopes that the OauthClient is allowed to request during
+        # OAuth flows. The following scopes are supported: * `https://www.googleapis.com/
+        # auth/cloud-platform`: See, edit, configure, and delete your Google Cloud data
+        # and see the email address for your Google Account. * `openid`: Associate you
+        # with your personal info on Google Cloud. * `email`: See your Google Cloud
+        # Account email address.
         # Corresponds to the JSON property `allowedScopes`
         # @return [Array<String>]
         attr_accessor :allowed_scopes
       
-        # Output only. The system-generated oauth client id.
+        # Output only. The system-generated OauthClient id.
         # Corresponds to the JSON property `clientId`
         # @return [String]
         attr_accessor :client_id
       
-        # Immutable. The type of oauth client. either public or private.
+        # Immutable. The type of OauthClient. Either public or private. For private
+        # clients, the client secret can be managed using the dedicated
+        # OauthClientCredential resource.
         # Corresponds to the JSON property `clientType`
         # @return [String]
         attr_accessor :client_type
       
-        # Optional. A user-specified description of the oauth client. Cannot exceed 256
+        # Optional. A user-specified description of the OauthClient. Cannot exceed 256
         # characters.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # Optional. Whether the oauth client is disabled. You cannot use a disabled
-        # oauth client for login.
+        # Optional. Whether the OauthClient is disabled. You cannot use a disabled OAuth
+        # client.
         # Corresponds to the JSON property `disabled`
         # @return [Boolean]
         attr_accessor :disabled
         alias_method :disabled?, :disabled
       
-        # Optional. A user-specified display name of the oauth client. Cannot exceed 32
+        # Optional. A user-specified display name of the OauthClient. Cannot exceed 32
         # characters.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
       
-        # Output only. Time after which the oauth client will be permanently purged and
+        # Output only. Time after which the OauthClient will be permanently purged and
         # cannot be recovered.
         # Corresponds to the JSON property `expireTime`
         # @return [String]
         attr_accessor :expire_time
       
-        # Immutable. The resource name of the oauth client. Format:`projects/`project`/
+        # Immutable. The resource name of the OauthClient. Format:`projects/`project`/
         # locations/`location`/oauthClients/`oauth_client``.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Output only. The state of the oauth client.
+        # Output only. The state of the OauthClient.
         # Corresponds to the JSON property `state`
         # @return [String]
         attr_accessor :state
@@ -1427,32 +1429,36 @@ module Google
         end
       end
       
-      # Represents an oauth client credential. Used to authenticate an oauth client
-      # while accessing Google Cloud resources on behalf of a user by using OAuth2
+      # Represents an OauthClientCredential. Used to authenticate an OauthClient while
+      # accessing Google Cloud resources on behalf of a user by using OAuth 2.0
       # Protocol.
       class OauthClientCredential
         include Google::Apis::Core::Hashable
       
-        # Output only. The system-generated oauth client secret.
+        # Output only. The system-generated OAuth client secret. The client secret must
+        # be stored securely. If the client secret is leaked, you must delete and re-
+        # create the client credential. To learn more, see [OAuth client and credential
+        # security risks and mitigations](https://cloud.google.com/iam/docs/workforce-
+        # oauth-app#security)
         # Corresponds to the JSON property `clientSecret`
         # @return [String]
         attr_accessor :client_secret
       
-        # Optional. Whether the oauth client credential is disabled. You cannot use a
-        # disabled oauth client credential for OAuth.
+        # Optional. Whether the OauthClientCredential is disabled. You cannot use a
+        # disabled OauthClientCredential.
         # Corresponds to the JSON property `disabled`
         # @return [Boolean]
         attr_accessor :disabled
         alias_method :disabled?, :disabled
       
-        # Optional. A user-specified display name of the oauth client credential Cannot
+        # Optional. A user-specified display name of the OauthClientCredential. Cannot
         # exceed 32 characters.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
       
-        # Immutable. The resource name of the oauth client credential. Format: `projects/
-        # `project`/locations/`location`/oauthClients/`oauth_client`/credentials/`
+        # Immutable. The resource name of the OauthClientCredential. Format: `projects/`
+        # project`/locations/`location`/oauthClients/`oauth_client`/credentials/`
         # credential``
         # Corresponds to the JSON property `name`
         # @return [String]
@@ -2334,8 +2340,8 @@ module Google
         # @return [String]
         attr_accessor :description
       
-        # optional. If the key is disabled, it may have a DisableReason describing why
-        # it was disabled.
+        # Output only. optional. If the key is disabled, it may have a DisableReason
+        # describing why it was disabled.
         # Corresponds to the JSON property `disableReason`
         # @return [String]
         attr_accessor :disable_reason
@@ -2346,9 +2352,10 @@ module Google
         attr_accessor :disabled
         alias_method :disabled?, :disabled
       
-        # Extended Status provides permanent information about a service account key.
-        # For example, if this key was detected as exposed or compromised, that
-        # information will remain for the lifetime of the key in the extended_status.
+        # Output only. Extended Status provides permanent information about a service
+        # account key. For example, if this key was detected as exposed or compromised,
+        # that information will remain for the lifetime of the key in the
+        # extended_status.
         # Corresponds to the JSON property `extendedStatus`
         # @return [Array<Google::Apis::IamV1::ExtendedStatus>]
         attr_accessor :extended_status

data/lib/google/apis/iam_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module IamV1
       # Version of the google-apis-iam_v1 gem
-      GEM_VERSION = "0.57.0"
+      GEM_VERSION = "0.58.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.14.0"
+      GENERATOR_VERSION = "0.15.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20240418"
+      REVISION = "20240521"
     end
   end
 end

data/lib/google/apis/iam_v1/service.rb

@@ -1064,20 +1064,20 @@ module Google
         # Creates a new custom Role.
         # @param [String] parent
         #   The `parent` parameter's value depends on the target resource for the request,
-        #   namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/
-        #   projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/
-        #   reference/rest/v1/organizations.roles). Each resource type's `parent` value
-        #   format is described below: * [`projects.roles.create()`](https://cloud.google.
-        #   com/iam/docs/reference/rest/v1/projects.roles/create): `projects/`PROJECT_ID``.
-        #   This method creates project-level [custom roles](https://cloud.google.com/iam/
-        #   docs/understanding-custom-roles). Example request URL: `https://iam.googleapis.
-        #   com/v1/projects/`PROJECT_ID`/roles` * [`organizations.roles.create()`](https://
-        #   cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/create): `
-        #   organizations/`ORGANIZATION_ID``. This method creates organization-level [
-        #   custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles).
-        #   Example request URL: `https://iam.googleapis.com/v1/organizations/`
-        #   ORGANIZATION_ID`/roles` Note: Wildcard (*) values are invalid; you must
-        #   specify a complete project ID or organization ID.
+        #   namely [projects](https://cloud.google.com/iam/docs/reference/rest/v1/projects.
+        #   roles) or [organizations](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   organizations.roles). Each resource type's `parent` value format is described
+        #   below: * [projects.roles.create](https://cloud.google.com/iam/docs/reference/
+        #   rest/v1/projects.roles/create): `projects/`PROJECT_ID``. This method creates
+        #   project-level [custom roles](https://cloud.google.com/iam/docs/understanding-
+        #   custom-roles). Example request URL: `https://iam.googleapis.com/v1/projects/`
+        #   PROJECT_ID`/roles` * [organizations.roles.create](https://cloud.google.com/iam/
+        #   docs/reference/rest/v1/organizations.roles/create): `organizations/`
+        #   ORGANIZATION_ID``. This method creates organization-level [custom roles](https:
+        #   //cloud.google.com/iam/docs/understanding-custom-roles). Example request URL: `
+        #   https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles` Note:
+        #   Wildcard (*) values are invalid; you must specify a complete project ID or
+        #   organization ID.
         # @param [Google::Apis::IamV1::CreateRoleRequest] create_role_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1118,22 +1118,22 @@ module Google
         # binding is permanently removed.
         # @param [String] name
         #   The `name` parameter's value depends on the target resource for the request,
-        #   namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/
-        #   projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/
-        #   reference/rest/v1/organizations.roles). Each resource type's `name` value
-        #   format is described below: * [`projects.roles.delete()`](https://cloud.google.
-        #   com/iam/docs/reference/rest/v1/projects.roles/delete): `projects/`PROJECT_ID`/
-        #   roles/`CUSTOM_ROLE_ID``. This method deletes only [custom roles](https://cloud.
-        #   google.com/iam/docs/understanding-custom-roles) that have been created at the
-        #   project level. Example request URL: `https://iam.googleapis.com/v1/projects/`
-        #   PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.delete()`](https://
-        #   cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/delete): `
-        #   organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method deletes
-        #   only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-
-        #   roles) that have been created at the organization level. Example request URL: `
-        #   https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`
-        #   CUSTOM_ROLE_ID`` Note: Wildcard (*) values are invalid; you must specify a
-        #   complete project ID or organization ID.
+        #   namely [projects](https://cloud.google.com/iam/docs/reference/rest/v1/projects.
+        #   roles) or [organizations](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   organizations.roles). Each resource type's `name` value format is described
+        #   below: * [projects.roles.delete](https://cloud.google.com/iam/docs/reference/
+        #   rest/v1/projects.roles/delete): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``.
+        #   This method deletes only [custom roles](https://cloud.google.com/iam/docs/
+        #   understanding-custom-roles) that have been created at the project level.
+        #   Example request URL: `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/
+        #   roles/`CUSTOM_ROLE_ID`` * [organizations.roles.delete](https://cloud.google.
+        #   com/iam/docs/reference/rest/v1/organizations.roles/delete): `organizations/`
+        #   ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method deletes only [custom
+        #   roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have
+        #   been created at the organization level. Example request URL: `https://iam.
+        #   googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note:
+        #   Wildcard (*) values are invalid; you must specify a complete project ID or
+        #   organization ID.
         # @param [String] etag
         #   Used to perform a consistent read-modify-write.
         # @param [String] fields
@@ -1167,27 +1167,27 @@ module Google
         # Gets the definition of a Role.
         # @param [String] name
         #   The `name` parameter's value depends on the target resource for the request,
-        #   namely [`roles`](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [`
-        #   projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles),
-        #   or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   namely [roles](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [
+        #   projects](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles),
+        #   or [organizations](https://cloud.google.com/iam/docs/reference/rest/v1/
         #   organizations.roles). Each resource type's `name` value format is described
-        #   below: * [`roles.get()`](https://cloud.google.com/iam/docs/reference/rest/v1/
-        #   roles/get): `roles/`ROLE_NAME``. This method returns results from all [
-        #   predefined roles](https://cloud.google.com/iam/docs/understanding-roles#
-        #   predefined_roles) in IAM. Example request URL: `https://iam.googleapis.com/v1/
-        #   roles/`ROLE_NAME`` * [`projects.roles.get()`](https://cloud.google.com/iam/
-        #   docs/reference/rest/v1/projects.roles/get): `projects/`PROJECT_ID`/roles/`
-        #   CUSTOM_ROLE_ID``. This method returns only [custom roles](https://cloud.google.
-        #   com/iam/docs/understanding-custom-roles) that have been created at the project
-        #   level. Example request URL: `https://iam.googleapis.com/v1/projects/`
-        #   PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.get()`](https://
-        #   cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/get): `
-        #   organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method returns
-        #   only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-
-        #   roles) that have been created at the organization level. Example request URL: `
-        #   https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`
-        #   CUSTOM_ROLE_ID`` Note: Wildcard (*) values are invalid; you must specify a
-        #   complete project ID or organization ID.
+        #   below: * [roles.get](https://cloud.google.com/iam/docs/reference/rest/v1/roles/
+        #   get): `roles/`ROLE_NAME``. This method returns results from all [predefined
+        #   roles](https://cloud.google.com/iam/docs/understanding-roles#predefined_roles)
+        #   in IAM. Example request URL: `https://iam.googleapis.com/v1/roles/`ROLE_NAME``
+        #   * [projects.roles.get](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   projects.roles/get): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This
+        #   method returns only [custom roles](https://cloud.google.com/iam/docs/
+        #   understanding-custom-roles) that have been created at the project level.
+        #   Example request URL: `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/
+        #   roles/`CUSTOM_ROLE_ID`` * [organizations.roles.get](https://cloud.google.com/
+        #   iam/docs/reference/rest/v1/organizations.roles/get): `organizations/`
+        #   ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method returns only [custom
+        #   roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have
+        #   been created at the organization level. Example request URL: `https://iam.
+        #   googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note:
+        #   Wildcard (*) values are invalid; you must specify a complete project ID or
+        #   organization ID.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1219,21 +1219,21 @@ module Google
         # defined for an organization or project.
         # @param [String] parent
         #   The `parent` parameter's value depends on the target resource for the request,
-        #   namely [`roles`](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [`
-        #   projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles),
-        #   or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   namely [roles](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [
+        #   projects](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles),
+        #   or [organizations](https://cloud.google.com/iam/docs/reference/rest/v1/
         #   organizations.roles). Each resource type's `parent` value format is described
-        #   below: * [`roles.list()`](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   below: * [roles.list](https://cloud.google.com/iam/docs/reference/rest/v1/
         #   roles/list): An empty string. This method doesn't require a resource; it
         #   simply returns all [predefined roles](https://cloud.google.com/iam/docs/
         #   understanding-roles#predefined_roles) in IAM. Example request URL: `https://
-        #   iam.googleapis.com/v1/roles` * [`projects.roles.list()`](https://cloud.google.
-        #   com/iam/docs/reference/rest/v1/projects.roles/list): `projects/`PROJECT_ID``.
-        #   This method lists all project-level [custom roles](https://cloud.google.com/
-        #   iam/docs/understanding-custom-roles). Example request URL: `https://iam.
-        #   googleapis.com/v1/projects/`PROJECT_ID`/roles` * [`organizations.roles.list()`]
-        #   (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/list):
-        #   `organizations/`ORGANIZATION_ID``. This method lists all organization-level [
+        #   iam.googleapis.com/v1/roles` * [projects.roles.list](https://cloud.google.com/
+        #   iam/docs/reference/rest/v1/projects.roles/list): `projects/`PROJECT_ID``. This
+        #   method lists all project-level [custom roles](https://cloud.google.com/iam/
+        #   docs/understanding-custom-roles). Example request URL: `https://iam.googleapis.
+        #   com/v1/projects/`PROJECT_ID`/roles` * [organizations.roles.list](https://cloud.
+        #   google.com/iam/docs/reference/rest/v1/organizations.roles/list): `
+        #   organizations/`ORGANIZATION_ID``. This method lists all organization-level [
         #   custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles).
         #   Example request URL: `https://iam.googleapis.com/v1/organizations/`
         #   ORGANIZATION_ID`/roles` Note: Wildcard (*) values are invalid; you must
@@ -1284,22 +1284,22 @@ module Google
         # Updates the definition of a custom Role.
         # @param [String] name
         #   The `name` parameter's value depends on the target resource for the request,
-        #   namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/
-        #   projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/
-        #   reference/rest/v1/organizations.roles). Each resource type's `name` value
-        #   format is described below: * [`projects.roles.patch()`](https://cloud.google.
-        #   com/iam/docs/reference/rest/v1/projects.roles/patch): `projects/`PROJECT_ID`/
-        #   roles/`CUSTOM_ROLE_ID``. This method updates only [custom roles](https://cloud.
-        #   google.com/iam/docs/understanding-custom-roles) that have been created at the
-        #   project level. Example request URL: `https://iam.googleapis.com/v1/projects/`
-        #   PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.patch()`](https://
-        #   cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/patch): `
-        #   organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method updates
-        #   only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-
-        #   roles) that have been created at the organization level. Example request URL: `
-        #   https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`
-        #   CUSTOM_ROLE_ID`` Note: Wildcard (*) values are invalid; you must specify a
-        #   complete project ID or organization ID.
+        #   namely [projects](https://cloud.google.com/iam/docs/reference/rest/v1/projects.
+        #   roles) or [organizations](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   organizations.roles). Each resource type's `name` value format is described
+        #   below: * [projects.roles.patch](https://cloud.google.com/iam/docs/reference/
+        #   rest/v1/projects.roles/patch): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``.
+        #   This method updates only [custom roles](https://cloud.google.com/iam/docs/
+        #   understanding-custom-roles) that have been created at the project level.
+        #   Example request URL: `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/
+        #   roles/`CUSTOM_ROLE_ID`` * [organizations.roles.patch](https://cloud.google.com/
+        #   iam/docs/reference/rest/v1/organizations.roles/patch): `organizations/`
+        #   ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method updates only [custom
+        #   roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have
+        #   been created at the organization level. Example request URL: `https://iam.
+        #   googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note:
+        #   Wildcard (*) values are invalid; you must specify a complete project ID or
+        #   organization ID.
         # @param [Google::Apis::IamV1::Role] role_object
         # @param [String] update_mask
         #   A mask describing which fields in the Role have changed.
@@ -1336,22 +1336,22 @@ module Google
         # Undeletes a custom Role.
         # @param [String] name
         #   The `name` parameter's value depends on the target resource for the request,
-        #   namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/
-        #   projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/
-        #   reference/rest/v1/organizations.roles). Each resource type's `name` value
-        #   format is described below: * [`projects.roles.undelete()`](https://cloud.
-        #   google.com/iam/docs/reference/rest/v1/projects.roles/undelete): `projects/`
-        #   PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This method undeletes only [custom roles](
-        #   https://cloud.google.com/iam/docs/understanding-custom-roles) that have been
-        #   created at the project level. Example request URL: `https://iam.googleapis.com/
-        #   v1/projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.
-        #   undelete()`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.
-        #   roles/undelete): `organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``.
-        #   This method undeletes only [custom roles](https://cloud.google.com/iam/docs/
-        #   understanding-custom-roles) that have been created at the organization level.
-        #   Example request URL: `https://iam.googleapis.com/v1/organizations/`
-        #   ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note: Wildcard (*) values are invalid;
-        #   you must specify a complete project ID or organization ID.
+        #   namely [projects](https://cloud.google.com/iam/docs/reference/rest/v1/projects.
+        #   roles) or [organizations](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   organizations.roles). Each resource type's `name` value format is described
+        #   below: * [projects.roles.undelete](https://cloud.google.com/iam/docs/reference/
+        #   rest/v1/projects.roles/undelete): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID`
+        #   `. This method undeletes only [custom roles](https://cloud.google.com/iam/docs/
+        #   understanding-custom-roles) that have been created at the project level.
+        #   Example request URL: `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/
+        #   roles/`CUSTOM_ROLE_ID`` * [organizations.roles.undelete](https://cloud.google.
+        #   com/iam/docs/reference/rest/v1/organizations.roles/undelete): `organizations/`
+        #   ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method undeletes only [custom
+        #   roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have
+        #   been created at the organization level. Example request URL: `https://iam.
+        #   googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note:
+        #   Wildcard (*) values are invalid; you must specify a complete project ID or
+        #   organization ID.
         # @param [Google::Apis::IamV1::UndeleteRoleRequest] undelete_role_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1414,18 +1414,18 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new OauthClient. You cannot reuse the name of a deleted oauth client
+        # Creates a new OauthClient. You cannot reuse the name of a deleted OauthClient
         # until 30 days after deletion.
         # @param [String] parent
-        #   Required. The parent resource to create the oauth client in. The only
-        #   supported location is `global`.
+        #   Required. The parent resource to create the OauthClient in. The only supported
+        #   location is `global`.
         # @param [Google::Apis::IamV1::OauthClient] oauth_client_object
         # @param [String] oauth_client_id
-        #   Required. The ID to use for the oauth client, which becomes the final
-        #   component of the resource name. This value should be a string of 6 to 63
-        #   lowercase letters, digits, or hyphens. It must start with a letter, and cannot
-        #   have a trailing hyphen. The prefix `gcp-` is reserved for use by Google, and
-        #   may not be specified.
+        #   Required. The ID to use for the OauthClient, which becomes the final component
+        #   of the resource name. This value should be a string of 6 to 63 lowercase
+        #   letters, digits, or hyphens. It must start with a letter, and cannot have a
+        #   trailing hyphen. The prefix `gcp-` is reserved for use by Google, and may not
+        #   be specified.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1456,16 +1456,16 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a OauthClient. You cannot use a deleted oauth client. However,
-        # deletion does not revoke access tokens that have already been issued; they
+        # Deletes an OauthClient. You cannot use a deleted OauthClient. However,
+        # deletion does not revoke access tokens that have already been issued. They
         # continue to grant access. Deletion does revoke refresh tokens that have
-        # already been issued; They cannot be used to renew an access token. If the
-        # oauth client is undeleted, and the refresh tokens are not expired, they are
-        # valid for token exchange again. You can undelete an oauth client for 30 days.
-        # After 30 days, deletion is permanent. You cannot update deleted oauth clients.
+        # already been issued. They cannot be used to renew an access token. If the
+        # OauthClient is undeleted, and the refresh tokens are not expired, they are
+        # valid for token exchange again. You can undelete an OauthClient for 30 days.
+        # After 30 days, deletion is permanent. You cannot update deleted OauthClients.
         # However, you can view and list them.
         # @param [String] name
-        #   Required. The name of the oauth client to delete. Format: `projects/`project`/
+        #   Required. The name of the OauthClient to delete. Format: `projects/`project`/
         #   locations/`location`/oauthClients/`oauth_client``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1496,8 +1496,8 @@ module Google
         
         # Gets an individual OauthClient.
         # @param [String] name
-        #   Required. The name of the oauth client to retrieve. Format: `projects/`project`
-        #   /locations/`location`/oauthClients/`oauth_client``.
+        #   Required. The name of the OauthClient to retrieve. Format: `projects/`project`/
+        #   locations/`location`/oauthClients/`oauth_client``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1525,19 +1525,19 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists all non-deleted OauthClientss in a project. If `show_deleted` is set to `
-        # true`, then deleted oauth clients are also listed.
+        # Lists all non-deleted OauthClients in a project. If `show_deleted` is set to `
+        # true`, then deleted OauthClients are also listed.
         # @param [String] parent
-        #   Required. The parent to list oauth clients for.
+        #   Required. The parent to list OauthClients for.
         # @param [Fixnum] page_size
-        #   Optional. The maximum number of oauth clients to return. If unspecified, at
-        #   most 50 oauth clients will be returned. The maximum value is 100; values above
+        #   Optional. The maximum number of OauthClients to return. If unspecified, at
+        #   most 50 OauthClients will be returned. The maximum value is 100; values above
         #   100 are truncated to 100.
         # @param [String] page_token
         #   Optional. A page token, received from a previous `ListOauthClients` call.
         #   Provide this to retrieve the subsequent page.
         # @param [Boolean] show_deleted
-        #   Optional. Whether to return soft-deleted oauth clients.
+        #   Optional. Whether to return soft-deleted OauthClients.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1570,7 +1570,7 @@ module Google
         
         # Updates an existing OauthClient.
         # @param [String] name
-        #   Immutable. The resource name of the oauth client. Format:`projects/`project`/
+        #   Immutable. The resource name of the OauthClient. Format:`projects/`project`/
         #   locations/`location`/oauthClients/`oauth_client``.
         # @param [Google::Apis::IamV1::OauthClient] oauth_client_object
         # @param [String] update_mask
@@ -1605,10 +1605,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Undeletes a OauthClient, as long as it was deleted fewer than 30 days ago.
+        # Undeletes an OauthClient, as long as it was deleted fewer than 30 days ago.
         # @param [String] name
-        #   Required. The name of the oauth client to undelete. Format: `projects/`project`
-        #   /locations/`location`/oauthClients/`oauth_client``.
+        #   Required. The name of the OauthClient to undelete. Format: `projects/`project`/
+        #   locations/`location`/oauthClients/`oauth_client``.
         # @param [Google::Apis::IamV1::UndeleteOauthClientRequest] undelete_oauth_client_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1641,13 +1641,13 @@ module Google
         
         # Creates a new OauthClientCredential.
         # @param [String] parent
-        #   Required. The parent resource to create the oauth client Credential in.
+        #   Required. The parent resource to create the OauthClientCredential in.
         # @param [Google::Apis::IamV1::OauthClientCredential] oauth_client_credential_object
         # @param [String] oauth_client_credential_id
-        #   Required. The ID to use for the oauth client credential, which becomes the
-        #   final component of the resource name. This value should be 4-32 characters,
-        #   and may contain the characters [a-z0-9-]. The prefix `gcp-` is reserved for
-        #   use by Google, and may not be specified.
+        #   Required. The ID to use for the OauthClientCredential, which becomes the final
+        #   component of the resource name. This value should be 4-32 characters, and may
+        #   contain the characters [a-z0-9-]. The prefix `gcp-` is reserved for use by
+        #   Google, and may not be specified.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1678,11 +1678,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a OauthClientCredential. Before deleting an oauth client credential,
-        # it should first be disabled.
+        # Deletes an OauthClientCredential. Before deleting an OauthClientCredential, it
+        # should first be disabled.
         # @param [String] name
-        #   Required. The name of the oauth client credential to delete. Format: `projects/
-        #   `project`/locations/`location`/oauthClients/`oauth_client`/credentials/`
+        #   Required. The name of the OauthClientCredential to delete. Format: `projects/`
+        #   project`/locations/`location`/oauthClients/`oauth_client`/credentials/`
         #   credential``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1713,9 +1713,9 @@ module Google
         
         # Gets an individual OauthClientCredential.
         # @param [String] name
-        #   Required. The name of the oauth client credential to retrieve. Format: `
-        #   projects/`project`/locations/`location`/oauthClients/`oauth_client`/
-        #   credentials/`credential``.
+        #   Required. The name of the OauthClientCredential to retrieve. Format: `projects/
+        #   `project`/locations/`location`/oauthClients/`oauth_client`/credentials/`
+        #   credential``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1743,9 +1743,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists all OauthClientCredentialss in a OauthClient.
+        # Lists all OauthClientCredentials in an OauthClient.
         # @param [String] parent
-        #   Required. The parent to list oauth client credentials for.
+        #   Required. The parent to list OauthClientCredentials for.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1775,8 +1775,8 @@ module Google
         
         # Updates an existing OauthClientCredential.
         # @param [String] name
-        #   Immutable. The resource name of the oauth client credential. Format: `projects/
-        #   `project`/locations/`location`/oauthClients/`oauth_client`/credentials/`
+        #   Immutable. The resource name of the OauthClientCredential. Format: `projects/`
+        #   project`/locations/`location`/oauthClients/`oauth_client`/credentials/`
         #   credential``
         # @param [Google::Apis::IamV1::OauthClientCredential] oauth_client_credential_object
         # @param [String] update_mask
@@ -2610,20 +2610,20 @@ module Google
         # Creates a new custom Role.
         # @param [String] parent
         #   The `parent` parameter's value depends on the target resource for the request,
-        #   namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/
-        #   projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/
-        #   reference/rest/v1/organizations.roles). Each resource type's `parent` value
-        #   format is described below: * [`projects.roles.create()`](https://cloud.google.
-        #   com/iam/docs/reference/rest/v1/projects.roles/create): `projects/`PROJECT_ID``.
-        #   This method creates project-level [custom roles](https://cloud.google.com/iam/
-        #   docs/understanding-custom-roles). Example request URL: `https://iam.googleapis.
-        #   com/v1/projects/`PROJECT_ID`/roles` * [`organizations.roles.create()`](https://
-        #   cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/create): `
-        #   organizations/`ORGANIZATION_ID``. This method creates organization-level [
-        #   custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles).
-        #   Example request URL: `https://iam.googleapis.com/v1/organizations/`
-        #   ORGANIZATION_ID`/roles` Note: Wildcard (*) values are invalid; you must
-        #   specify a complete project ID or organization ID.
+        #   namely [projects](https://cloud.google.com/iam/docs/reference/rest/v1/projects.
+        #   roles) or [organizations](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   organizations.roles). Each resource type's `parent` value format is described
+        #   below: * [projects.roles.create](https://cloud.google.com/iam/docs/reference/
+        #   rest/v1/projects.roles/create): `projects/`PROJECT_ID``. This method creates
+        #   project-level [custom roles](https://cloud.google.com/iam/docs/understanding-
+        #   custom-roles). Example request URL: `https://iam.googleapis.com/v1/projects/`
+        #   PROJECT_ID`/roles` * [organizations.roles.create](https://cloud.google.com/iam/
+        #   docs/reference/rest/v1/organizations.roles/create): `organizations/`
+        #   ORGANIZATION_ID``. This method creates organization-level [custom roles](https:
+        #   //cloud.google.com/iam/docs/understanding-custom-roles). Example request URL: `
+        #   https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles` Note:
+        #   Wildcard (*) values are invalid; you must specify a complete project ID or
+        #   organization ID.
         # @param [Google::Apis::IamV1::CreateRoleRequest] create_role_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -2664,22 +2664,22 @@ module Google
         # binding is permanently removed.
         # @param [String] name
         #   The `name` parameter's value depends on the target resource for the request,
-        #   namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/
-        #   projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/
-        #   reference/rest/v1/organizations.roles). Each resource type's `name` value
-        #   format is described below: * [`projects.roles.delete()`](https://cloud.google.
-        #   com/iam/docs/reference/rest/v1/projects.roles/delete): `projects/`PROJECT_ID`/
-        #   roles/`CUSTOM_ROLE_ID``. This method deletes only [custom roles](https://cloud.
-        #   google.com/iam/docs/understanding-custom-roles) that have been created at the
-        #   project level. Example request URL: `https://iam.googleapis.com/v1/projects/`
-        #   PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.delete()`](https://
-        #   cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/delete): `
-        #   organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method deletes
-        #   only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-
-        #   roles) that have been created at the organization level. Example request URL: `
-        #   https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`
-        #   CUSTOM_ROLE_ID`` Note: Wildcard (*) values are invalid; you must specify a
-        #   complete project ID or organization ID.
+        #   namely [projects](https://cloud.google.com/iam/docs/reference/rest/v1/projects.
+        #   roles) or [organizations](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   organizations.roles). Each resource type's `name` value format is described
+        #   below: * [projects.roles.delete](https://cloud.google.com/iam/docs/reference/
+        #   rest/v1/projects.roles/delete): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``.
+        #   This method deletes only [custom roles](https://cloud.google.com/iam/docs/
+        #   understanding-custom-roles) that have been created at the project level.
+        #   Example request URL: `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/
+        #   roles/`CUSTOM_ROLE_ID`` * [organizations.roles.delete](https://cloud.google.
+        #   com/iam/docs/reference/rest/v1/organizations.roles/delete): `organizations/`
+        #   ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method deletes only [custom
+        #   roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have
+        #   been created at the organization level. Example request URL: `https://iam.
+        #   googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note:
+        #   Wildcard (*) values are invalid; you must specify a complete project ID or
+        #   organization ID.
         # @param [String] etag
         #   Used to perform a consistent read-modify-write.
         # @param [String] fields
@@ -2713,27 +2713,27 @@ module Google
         # Gets the definition of a Role.
         # @param [String] name
         #   The `name` parameter's value depends on the target resource for the request,
-        #   namely [`roles`](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [`
-        #   projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles),
-        #   or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   namely [roles](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [
+        #   projects](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles),
+        #   or [organizations](https://cloud.google.com/iam/docs/reference/rest/v1/
         #   organizations.roles). Each resource type's `name` value format is described
-        #   below: * [`roles.get()`](https://cloud.google.com/iam/docs/reference/rest/v1/
-        #   roles/get): `roles/`ROLE_NAME``. This method returns results from all [
-        #   predefined roles](https://cloud.google.com/iam/docs/understanding-roles#
-        #   predefined_roles) in IAM. Example request URL: `https://iam.googleapis.com/v1/
-        #   roles/`ROLE_NAME`` * [`projects.roles.get()`](https://cloud.google.com/iam/
-        #   docs/reference/rest/v1/projects.roles/get): `projects/`PROJECT_ID`/roles/`
-        #   CUSTOM_ROLE_ID``. This method returns only [custom roles](https://cloud.google.
-        #   com/iam/docs/understanding-custom-roles) that have been created at the project
-        #   level. Example request URL: `https://iam.googleapis.com/v1/projects/`
-        #   PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.get()`](https://
-        #   cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/get): `
-        #   organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method returns
-        #   only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-
-        #   roles) that have been created at the organization level. Example request URL: `
-        #   https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`
-        #   CUSTOM_ROLE_ID`` Note: Wildcard (*) values are invalid; you must specify a
-        #   complete project ID or organization ID.
+        #   below: * [roles.get](https://cloud.google.com/iam/docs/reference/rest/v1/roles/
+        #   get): `roles/`ROLE_NAME``. This method returns results from all [predefined
+        #   roles](https://cloud.google.com/iam/docs/understanding-roles#predefined_roles)
+        #   in IAM. Example request URL: `https://iam.googleapis.com/v1/roles/`ROLE_NAME``
+        #   * [projects.roles.get](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   projects.roles/get): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This
+        #   method returns only [custom roles](https://cloud.google.com/iam/docs/
+        #   understanding-custom-roles) that have been created at the project level.
+        #   Example request URL: `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/
+        #   roles/`CUSTOM_ROLE_ID`` * [organizations.roles.get](https://cloud.google.com/
+        #   iam/docs/reference/rest/v1/organizations.roles/get): `organizations/`
+        #   ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method returns only [custom
+        #   roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have
+        #   been created at the organization level. Example request URL: `https://iam.
+        #   googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note:
+        #   Wildcard (*) values are invalid; you must specify a complete project ID or
+        #   organization ID.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2765,21 +2765,21 @@ module Google
         # defined for an organization or project.
         # @param [String] parent
         #   The `parent` parameter's value depends on the target resource for the request,
-        #   namely [`roles`](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [`
-        #   projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles),
-        #   or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   namely [roles](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [
+        #   projects](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles),
+        #   or [organizations](https://cloud.google.com/iam/docs/reference/rest/v1/
         #   organizations.roles). Each resource type's `parent` value format is described
-        #   below: * [`roles.list()`](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   below: * [roles.list](https://cloud.google.com/iam/docs/reference/rest/v1/
         #   roles/list): An empty string. This method doesn't require a resource; it
         #   simply returns all [predefined roles](https://cloud.google.com/iam/docs/
         #   understanding-roles#predefined_roles) in IAM. Example request URL: `https://
-        #   iam.googleapis.com/v1/roles` * [`projects.roles.list()`](https://cloud.google.
-        #   com/iam/docs/reference/rest/v1/projects.roles/list): `projects/`PROJECT_ID``.
-        #   This method lists all project-level [custom roles](https://cloud.google.com/
-        #   iam/docs/understanding-custom-roles). Example request URL: `https://iam.
-        #   googleapis.com/v1/projects/`PROJECT_ID`/roles` * [`organizations.roles.list()`]
-        #   (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/list):
-        #   `organizations/`ORGANIZATION_ID``. This method lists all organization-level [
+        #   iam.googleapis.com/v1/roles` * [projects.roles.list](https://cloud.google.com/
+        #   iam/docs/reference/rest/v1/projects.roles/list): `projects/`PROJECT_ID``. This
+        #   method lists all project-level [custom roles](https://cloud.google.com/iam/
+        #   docs/understanding-custom-roles). Example request URL: `https://iam.googleapis.
+        #   com/v1/projects/`PROJECT_ID`/roles` * [organizations.roles.list](https://cloud.
+        #   google.com/iam/docs/reference/rest/v1/organizations.roles/list): `
+        #   organizations/`ORGANIZATION_ID``. This method lists all organization-level [
         #   custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles).
         #   Example request URL: `https://iam.googleapis.com/v1/organizations/`
         #   ORGANIZATION_ID`/roles` Note: Wildcard (*) values are invalid; you must
@@ -2830,22 +2830,22 @@ module Google
         # Updates the definition of a custom Role.
         # @param [String] name
         #   The `name` parameter's value depends on the target resource for the request,
-        #   namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/
-        #   projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/
-        #   reference/rest/v1/organizations.roles). Each resource type's `name` value
-        #   format is described below: * [`projects.roles.patch()`](https://cloud.google.
-        #   com/iam/docs/reference/rest/v1/projects.roles/patch): `projects/`PROJECT_ID`/
-        #   roles/`CUSTOM_ROLE_ID``. This method updates only [custom roles](https://cloud.
-        #   google.com/iam/docs/understanding-custom-roles) that have been created at the
-        #   project level. Example request URL: `https://iam.googleapis.com/v1/projects/`
-        #   PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.patch()`](https://
-        #   cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/patch): `
-        #   organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method updates
-        #   only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-
-        #   roles) that have been created at the organization level. Example request URL: `
-        #   https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`
-        #   CUSTOM_ROLE_ID`` Note: Wildcard (*) values are invalid; you must specify a
-        #   complete project ID or organization ID.
+        #   namely [projects](https://cloud.google.com/iam/docs/reference/rest/v1/projects.
+        #   roles) or [organizations](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   organizations.roles). Each resource type's `name` value format is described
+        #   below: * [projects.roles.patch](https://cloud.google.com/iam/docs/reference/
+        #   rest/v1/projects.roles/patch): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``.
+        #   This method updates only [custom roles](https://cloud.google.com/iam/docs/
+        #   understanding-custom-roles) that have been created at the project level.
+        #   Example request URL: `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/
+        #   roles/`CUSTOM_ROLE_ID`` * [organizations.roles.patch](https://cloud.google.com/
+        #   iam/docs/reference/rest/v1/organizations.roles/patch): `organizations/`
+        #   ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method updates only [custom
+        #   roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have
+        #   been created at the organization level. Example request URL: `https://iam.
+        #   googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note:
+        #   Wildcard (*) values are invalid; you must specify a complete project ID or
+        #   organization ID.
         # @param [Google::Apis::IamV1::Role] role_object
         # @param [String] update_mask
         #   A mask describing which fields in the Role have changed.
@@ -2882,22 +2882,22 @@ module Google
         # Undeletes a custom Role.
         # @param [String] name
         #   The `name` parameter's value depends on the target resource for the request,
-        #   namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/
-        #   projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/
-        #   reference/rest/v1/organizations.roles). Each resource type's `name` value
-        #   format is described below: * [`projects.roles.undelete()`](https://cloud.
-        #   google.com/iam/docs/reference/rest/v1/projects.roles/undelete): `projects/`
-        #   PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This method undeletes only [custom roles](
-        #   https://cloud.google.com/iam/docs/understanding-custom-roles) that have been
-        #   created at the project level. Example request URL: `https://iam.googleapis.com/
-        #   v1/projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.
-        #   undelete()`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.
-        #   roles/undelete): `organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``.
-        #   This method undeletes only [custom roles](https://cloud.google.com/iam/docs/
-        #   understanding-custom-roles) that have been created at the organization level.
-        #   Example request URL: `https://iam.googleapis.com/v1/organizations/`
-        #   ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note: Wildcard (*) values are invalid;
-        #   you must specify a complete project ID or organization ID.
+        #   namely [projects](https://cloud.google.com/iam/docs/reference/rest/v1/projects.
+        #   roles) or [organizations](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   organizations.roles). Each resource type's `name` value format is described
+        #   below: * [projects.roles.undelete](https://cloud.google.com/iam/docs/reference/
+        #   rest/v1/projects.roles/undelete): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID`
+        #   `. This method undeletes only [custom roles](https://cloud.google.com/iam/docs/
+        #   understanding-custom-roles) that have been created at the project level.
+        #   Example request URL: `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/
+        #   roles/`CUSTOM_ROLE_ID`` * [organizations.roles.undelete](https://cloud.google.
+        #   com/iam/docs/reference/rest/v1/organizations.roles/undelete): `organizations/`
+        #   ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method undeletes only [custom
+        #   roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have
+        #   been created at the organization level. Example request URL: `https://iam.
+        #   googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note:
+        #   Wildcard (*) values are invalid; you must specify a complete project ID or
+        #   organization ID.
         # @param [Google::Apis::IamV1::UndeleteRoleRequest] undelete_role_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -3152,8 +3152,8 @@ module Google
         # does not tell you whether the service account has been granted any roles on
         # other resources. To check whether a service account has role grants on a
         # resource, use the `getIamPolicy` method for that resource. For example, to
-        # view the role grants for a project, call the Resource Manager API's [`projects.
-        # getIamPolicy`](https://cloud.google.com/resource-manager/reference/rest/v1/
+        # view the role grants for a project, call the Resource Manager API's [projects.
+        # getIamPolicy](https://cloud.google.com/resource-manager/reference/rest/v1/
         # projects/getIamPolicy) method.
         # @param [String] resource
         #   REQUIRED: The resource for which the policy is being requested. See [Resource
@@ -3327,7 +3327,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # **Note:** This method is deprecated. Use the [`signBlob`](https://cloud.google.
+        # **Note:** This method is deprecated. Use the [signBlob](https://cloud.google.
         # com/iam/help/rest-credentials/v1/projects.serviceAccounts/signBlob) method in
         # the IAM Service Account Credentials API instead. If you currently use this
         # method, see the [migration guide](https://cloud.google.com/iam/help/
@@ -3375,7 +3375,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # **Note:** This method is deprecated. Use the [`signJwt`](https://cloud.google.
+        # **Note:** This method is deprecated. Use the [signJwt](https://cloud.google.
         # com/iam/help/rest-credentials/v1/projects.serviceAccounts/signJwt) method in
         # the IAM Service Account Credentials API instead. If you currently use this
         # method, see the [migration guide](https://cloud.google.com/iam/help/
@@ -3887,27 +3887,27 @@ module Google
         # Gets the definition of a Role.
         # @param [String] name
         #   The `name` parameter's value depends on the target resource for the request,
-        #   namely [`roles`](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [`
-        #   projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles),
-        #   or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   namely [roles](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [
+        #   projects](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles),
+        #   or [organizations](https://cloud.google.com/iam/docs/reference/rest/v1/
         #   organizations.roles). Each resource type's `name` value format is described
-        #   below: * [`roles.get()`](https://cloud.google.com/iam/docs/reference/rest/v1/
-        #   roles/get): `roles/`ROLE_NAME``. This method returns results from all [
-        #   predefined roles](https://cloud.google.com/iam/docs/understanding-roles#
-        #   predefined_roles) in IAM. Example request URL: `https://iam.googleapis.com/v1/
-        #   roles/`ROLE_NAME`` * [`projects.roles.get()`](https://cloud.google.com/iam/
-        #   docs/reference/rest/v1/projects.roles/get): `projects/`PROJECT_ID`/roles/`
-        #   CUSTOM_ROLE_ID``. This method returns only [custom roles](https://cloud.google.
-        #   com/iam/docs/understanding-custom-roles) that have been created at the project
-        #   level. Example request URL: `https://iam.googleapis.com/v1/projects/`
-        #   PROJECT_ID`/roles/`CUSTOM_ROLE_ID`` * [`organizations.roles.get()`](https://
-        #   cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/get): `
-        #   organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method returns
-        #   only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-
-        #   roles) that have been created at the organization level. Example request URL: `
-        #   https://iam.googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`
-        #   CUSTOM_ROLE_ID`` Note: Wildcard (*) values are invalid; you must specify a
-        #   complete project ID or organization ID.
+        #   below: * [roles.get](https://cloud.google.com/iam/docs/reference/rest/v1/roles/
+        #   get): `roles/`ROLE_NAME``. This method returns results from all [predefined
+        #   roles](https://cloud.google.com/iam/docs/understanding-roles#predefined_roles)
+        #   in IAM. Example request URL: `https://iam.googleapis.com/v1/roles/`ROLE_NAME``
+        #   * [projects.roles.get](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   projects.roles/get): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This
+        #   method returns only [custom roles](https://cloud.google.com/iam/docs/
+        #   understanding-custom-roles) that have been created at the project level.
+        #   Example request URL: `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/
+        #   roles/`CUSTOM_ROLE_ID`` * [organizations.roles.get](https://cloud.google.com/
+        #   iam/docs/reference/rest/v1/organizations.roles/get): `organizations/`
+        #   ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method returns only [custom
+        #   roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have
+        #   been created at the organization level. Example request URL: `https://iam.
+        #   googleapis.com/v1/organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID`` Note:
+        #   Wildcard (*) values are invalid; you must specify a complete project ID or
+        #   organization ID.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -3944,21 +3944,21 @@ module Google
         #   Optional pagination token returned in an earlier ListRolesResponse.
         # @param [String] parent
         #   The `parent` parameter's value depends on the target resource for the request,
-        #   namely [`roles`](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [`
-        #   projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles),
-        #   or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   namely [roles](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [
+        #   projects](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles),
+        #   or [organizations](https://cloud.google.com/iam/docs/reference/rest/v1/
         #   organizations.roles). Each resource type's `parent` value format is described
-        #   below: * [`roles.list()`](https://cloud.google.com/iam/docs/reference/rest/v1/
+        #   below: * [roles.list](https://cloud.google.com/iam/docs/reference/rest/v1/
         #   roles/list): An empty string. This method doesn't require a resource; it
         #   simply returns all [predefined roles](https://cloud.google.com/iam/docs/
         #   understanding-roles#predefined_roles) in IAM. Example request URL: `https://
-        #   iam.googleapis.com/v1/roles` * [`projects.roles.list()`](https://cloud.google.
-        #   com/iam/docs/reference/rest/v1/projects.roles/list): `projects/`PROJECT_ID``.
-        #   This method lists all project-level [custom roles](https://cloud.google.com/
-        #   iam/docs/understanding-custom-roles). Example request URL: `https://iam.
-        #   googleapis.com/v1/projects/`PROJECT_ID`/roles` * [`organizations.roles.list()`]
-        #   (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/list):
-        #   `organizations/`ORGANIZATION_ID``. This method lists all organization-level [
+        #   iam.googleapis.com/v1/roles` * [projects.roles.list](https://cloud.google.com/
+        #   iam/docs/reference/rest/v1/projects.roles/list): `projects/`PROJECT_ID``. This
+        #   method lists all project-level [custom roles](https://cloud.google.com/iam/
+        #   docs/understanding-custom-roles). Example request URL: `https://iam.googleapis.
+        #   com/v1/projects/`PROJECT_ID`/roles` * [organizations.roles.list](https://cloud.
+        #   google.com/iam/docs/reference/rest/v1/organizations.roles/list): `
+        #   organizations/`ORGANIZATION_ID``. This method lists all organization-level [
         #   custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles).
         #   Example request URL: `https://iam.googleapis.com/v1/organizations/`
         #   ORGANIZATION_ID`/roles` Note: Wildcard (*) values are invalid; you must

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-iam_v1
 version: !ruby/object:Gem::Version
-  version: 0.57.0
+  version: 0.58.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-04-28 00:00:00.000000000 Z
+date: 2024-05-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.14.0
+        version: 0.15.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.14.0
+        version: 0.15.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -59,7 +59,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-iam_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-iam_v1/v0.57.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-iam_v1/v0.58.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-iam_v1
 post_install_message: 
 rdoc_options: []