google-api-client 0.42.0 → 0.44.1

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

@@ -24,7 +24,10 @@ module Google
       #
       # Manages identity and access control for Google Cloud Platform resources,
       #  including the creation of service accounts, which you can use to authenticate
-      #  to Google and make API calls.
+      #  to Google and make API calls. *Note:* This API is tied to the IAM service
+      #  account credentials API ( iamcredentials.googleapis.com). Enabling or
+      #  disabling this API will also enable or disable the IAM service account
+      #  credentials API.
       #
       # @example
       #    require 'google/apis/iam_v1'
@@ -49,9 +52,8 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Lints, or validates, an IAM policy. Currently checks the
-        # google.iam.v1.Binding.condition field, which contains a condition
-        # expression for a role binding.
+        # Lints, or validates, an IAM policy. Currently checks the google.iam.v1.Binding.
+        # condition field, which contains a condition expression for a role binding.
         # Successful calls to this method always return an HTTP `200 OK` status code,
         # even if the linter detects an issue in the IAM policy.
         # @param [Google::Apis::IamV1::LintPolicyRequest] lint_policy_request_object
@@ -83,9 +85,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns a list of services that allow you to opt into audit logs that are
-        # not generated by default.
-        # To learn more about audit logs, see the [Logging
+        # Returns a list of services that allow you to opt into audit logs that are not
+        # generated by default. To learn more about audit logs, see the [Logging
         # documentation](https://cloud.google.com/logging/docs/audit).
         # @param [Google::Apis::IamV1::QueryAuditableServicesRequest] query_auditable_services_request_object
         # @param [String] fields
@@ -118,24 +119,19 @@ 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`](/iam/reference/rest/v1/projects.roles) or
-        #   [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
-        #   resource type's `parent` value format is described below:
-        #   * [`projects.roles.create()`](/iam/reference/rest/v1/projects.roles/create):
-        #   `projects/`PROJECT_ID``. This method creates project-level
-        #   [custom roles](/iam/docs/understanding-custom-roles).
-        #   Example request URL:
-        #   `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/roles`
-        #   * [`organizations.roles.create()`](/iam/reference/rest/v1/organizations.roles/
-        #   create):
-        #   `organizations/`ORGANIZATION_ID``. This method creates organization-level
-        #   [custom roles](/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.
+        #   The `parent` parameter's value depends on the target resource for the request,
+        #   namely [`projects`](/iam/reference/rest/v1/projects.roles) or [`organizations`]
+        #   (/iam/reference/rest/v1/organizations.roles). Each resource type's `parent`
+        #   value format is described below: * [`projects.roles.create()`](/iam/reference/
+        #   rest/v1/projects.roles/create): `projects/`PROJECT_ID``. This method creates
+        #   project-level [custom roles](/iam/docs/understanding-custom-roles). Example
+        #   request URL: `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/roles` * [`
+        #   organizations.roles.create()`](/iam/reference/rest/v1/organizations.roles/
+        #   create): `organizations/`ORGANIZATION_ID``. This method creates organization-
+        #   level [custom roles](/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.
@@ -166,39 +162,30 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a custom Role.
-        # When you delete a custom role, the following changes occur immediately:
-        # * You cannot bind a member to the custom role in an IAM
-        # Policy.
-        # * Existing bindings to the custom role are not changed, but they have no
-        # effect.
-        # * By default, the response from ListRoles does not include the custom
-        # role.
-        # You have 7 days to undelete the custom role. After 7 days, the following
-        # changes occur:
-        # * The custom role is permanently deleted and cannot be recovered.
-        # * If an IAM policy contains a binding to the custom role, the binding is
-        # permanently removed.
+        # Deletes a custom Role. When you delete a custom role, the following changes
+        # occur immediately: * You cannot bind a member to the custom role in an IAM
+        # Policy. * Existing bindings to the custom role are not changed, but they have
+        # no effect. * By default, the response from ListRoles does not include the
+        # custom role. You have 7 days to undelete the custom role. After 7 days, the
+        # following changes occur: * The custom role is permanently deleted and cannot
+        # be recovered. * If an IAM policy contains a binding to the custom role, the
+        # binding is permanently removed.
         # @param [String] name
-        #   The `name` parameter's value depends on the target resource for the
-        #   request, namely
-        #   [`projects`](/iam/reference/rest/v1/projects.roles) or
-        #   [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
-        #   resource type's `name` value format is described below:
-        #   * [`projects.roles.delete()`](/iam/reference/rest/v1/projects.roles/delete):
-        #   `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This method deletes only
-        #   [custom roles](/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()`](/iam/reference/rest/v1/organizations.roles/
-        #   delete):
-        #   `organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method
-        #   deletes only [custom roles](/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.
+        #   The `name` parameter's value depends on the target resource for the request,
+        #   namely [`projects`](/iam/reference/rest/v1/projects.roles) or [`organizations`]
+        #   (/iam/reference/rest/v1/organizations.roles). Each resource type's `name`
+        #   value format is described below: * [`projects.roles.delete()`](/iam/reference/
+        #   rest/v1/projects.roles/delete): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``.
+        #   This method deletes only [custom roles](/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()`](/iam/reference/rest/v1/organizations.roles/
+        #   delete): `organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method
+        #   deletes only [custom roles](/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
@@ -231,31 +218,25 @@ 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`](/iam/reference/rest/v1/roles),
-        #   [`projects`](/iam/reference/rest/v1/projects.roles), or
-        #   [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
-        #   resource type's `name` value format is described below:
-        #   * [`roles.get()`](/iam/reference/rest/v1/roles/get): `roles/`ROLE_NAME``.
-        #   This method returns results from all
-        #   [predefined roles](/iam/docs/understanding-roles#predefined_roles) in
-        #   Cloud IAM. Example request URL:
-        #   `https://iam.googleapis.com/v1/roles/`ROLE_NAME``
-        #   * [`projects.roles.get()`](/iam/reference/rest/v1/projects.roles/get):
-        #   `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This method returns only
-        #   [custom roles](/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()`](/iam/reference/rest/v1/organizations.roles/get)
-        #   :
-        #   `organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method
-        #   returns only [custom roles](/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.
+        #   The `name` parameter's value depends on the target resource for the request,
+        #   namely [`roles`](/iam/reference/rest/v1/roles), [`projects`](/iam/reference/
+        #   rest/v1/projects.roles), or [`organizations`](/iam/reference/rest/v1/
+        #   organizations.roles). Each resource type's `name` value format is described
+        #   below: * [`roles.get()`](/iam/reference/rest/v1/roles/get): `roles/`ROLE_NAME``
+        #   . This method returns results from all [predefined roles](/iam/docs/
+        #   understanding-roles#predefined_roles) in Cloud IAM. Example request URL: `
+        #   https://iam.googleapis.com/v1/roles/`ROLE_NAME`` * [`projects.roles.get()`](/
+        #   iam/reference/rest/v1/projects.roles/get): `projects/`PROJECT_ID`/roles/`
+        #   CUSTOM_ROLE_ID``. This method returns only [custom roles](/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()`](/iam/reference/rest/v1/
+        #   organizations.roles/get): `organizations/`ORGANIZATION_ID`/roles/`
+        #   CUSTOM_ROLE_ID``. This method returns only [custom roles](/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
@@ -283,45 +264,38 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists every predefined Role that IAM supports, or every custom role
-        # that is defined for an organization or project.
+        # Lists every predefined Role that IAM supports, or every custom role that is
+        # defined for an organization or project.
         # @param [String] parent
-        #   The `parent` parameter's value depends on the target resource for the
-        #   request, namely
-        #   [`roles`](/iam/reference/rest/v1/roles),
-        #   [`projects`](/iam/reference/rest/v1/projects.roles), or
-        #   [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
-        #   resource type's `parent` value format is described below:
-        #   * [`roles.list()`](/iam/reference/rest/v1/roles/list): An empty string.
-        #   This method doesn't require a resource; it simply returns all
-        #   [predefined roles](/iam/docs/understanding-roles#predefined_roles) in
-        #   Cloud IAM. Example request URL:
-        #   `https://iam.googleapis.com/v1/roles`
-        #   * [`projects.roles.list()`](/iam/reference/rest/v1/projects.roles/list):
-        #   `projects/`PROJECT_ID``. This method lists all project-level
-        #   [custom roles](/iam/docs/understanding-custom-roles).
-        #   Example request URL:
-        #   `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/roles`
-        #   * [`organizations.roles.list()`](/iam/reference/rest/v1/organizations.roles/
-        #   list):
-        #   `organizations/`ORGANIZATION_ID``. This method lists all
-        #   organization-level [custom roles](/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.
+        #   The `parent` parameter's value depends on the target resource for the request,
+        #   namely [`roles`](/iam/reference/rest/v1/roles), [`projects`](/iam/reference/
+        #   rest/v1/projects.roles), or [`organizations`](/iam/reference/rest/v1/
+        #   organizations.roles). Each resource type's `parent` value format is described
+        #   below: * [`roles.list()`](/iam/reference/rest/v1/roles/list): An empty string.
+        #   This method doesn't require a resource; it simply returns all [predefined
+        #   roles](/iam/docs/understanding-roles#predefined_roles) in Cloud IAM. Example
+        #   request URL: `https://iam.googleapis.com/v1/roles` * [`projects.roles.list()`](
+        #   /iam/reference/rest/v1/projects.roles/list): `projects/`PROJECT_ID``. This
+        #   method lists all project-level [custom roles](/iam/docs/understanding-custom-
+        #   roles). Example request URL: `https://iam.googleapis.com/v1/projects/`
+        #   PROJECT_ID`/roles` * [`organizations.roles.list()`](/iam/reference/rest/v1/
+        #   organizations.roles/list): `organizations/`ORGANIZATION_ID``. This method
+        #   lists all organization-level [custom roles](/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 [Fixnum] page_size
-        #   Optional limit on the number of roles to include in the response.
-        #   The default is 300, and the maximum is 1,000.
+        #   Optional limit on the number of roles to include in the response. The default
+        #   is 300, and the maximum is 1,000.
         # @param [String] page_token
         #   Optional pagination token returned in an earlier ListRolesResponse.
         # @param [Boolean] show_deleted
         #   Include Roles that have been deleted.
         # @param [String] view
-        #   Optional view for the returned Role objects. When `FULL` is specified,
-        #   the `includedPermissions` field is returned, which includes a list of all
-        #   permissions in the role. The default value is `BASIC`, which does not
-        #   return the `includedPermissions` field.
+        #   Optional view for the returned Role objects. When `FULL` is specified, the `
+        #   includedPermissions` field is returned, which includes a list of all
+        #   permissions in the role. The default value is `BASIC`, which does not return
+        #   the `includedPermissions` field.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -355,25 +329,21 @@ 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`](/iam/reference/rest/v1/projects.roles) or
-        #   [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
-        #   resource type's `name` value format is described below:
-        #   * [`projects.roles.patch()`](/iam/reference/rest/v1/projects.roles/patch):
-        #   `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This method updates only
-        #   [custom roles](/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()`](/iam/reference/rest/v1/organizations.roles/
-        #   patch):
-        #   `organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method
-        #   updates only [custom roles](/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.
+        #   The `name` parameter's value depends on the target resource for the request,
+        #   namely [`projects`](/iam/reference/rest/v1/projects.roles) or [`organizations`]
+        #   (/iam/reference/rest/v1/organizations.roles). Each resource type's `name`
+        #   value format is described below: * [`projects.roles.patch()`](/iam/reference/
+        #   rest/v1/projects.roles/patch): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``.
+        #   This method updates only [custom roles](/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()`](/iam/reference/rest/v1/organizations.roles/patch)
+        #   : `organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method
+        #   updates only [custom roles](/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.
@@ -409,26 +379,21 @@ module Google
         
         # Undeletes a custom Role.
         # @param [String] name
-        #   The `name` parameter's value depends on the target resource for the
-        #   request, namely
-        #   [`projects`](/iam/reference/rest/v1/projects.roles) or
-        #   [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
-        #   resource type's `name` value format is described below:
-        #   * [`projects.roles.undelete()`](/iam/reference/rest/v1/projects.roles/undelete)
-        #   :
-        #   `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This method undeletes
-        #   only [custom roles](/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()`](/iam/reference/rest/v1/organizations.
-        #   roles/undelete):
-        #   `organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method
-        #   undeletes only [custom roles](/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.
+        #   The `name` parameter's value depends on the target resource for the request,
+        #   namely [`projects`](/iam/reference/rest/v1/projects.roles) or [`organizations`]
+        #   (/iam/reference/rest/v1/organizations.roles). Each resource type's `name`
+        #   value format is described below: * [`projects.roles.undelete()`](/iam/
+        #   reference/rest/v1/projects.roles/undelete): `projects/`PROJECT_ID`/roles/`
+        #   CUSTOM_ROLE_ID``. This method undeletes only [custom roles](/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()`](/iam/reference/
+        #   rest/v1/organizations.roles/undelete): `organizations/`ORGANIZATION_ID`/roles/`
+        #   CUSTOM_ROLE_ID``. This method undeletes only [custom roles](/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.
@@ -460,8 +425,7 @@ module Google
         end
         
         # Lists every permission that you can test on a resource. A permission is
-        # testable if you can check whether a member has that permission on the
-        # resource.
+        # testable if you can check whether a member has that permission on the resource.
         # @param [Google::Apis::IamV1::QueryTestablePermissionsRequest] query_testable_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -493,24 +457,19 @@ 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`](/iam/reference/rest/v1/projects.roles) or
-        #   [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
-        #   resource type's `parent` value format is described below:
-        #   * [`projects.roles.create()`](/iam/reference/rest/v1/projects.roles/create):
-        #   `projects/`PROJECT_ID``. This method creates project-level
-        #   [custom roles](/iam/docs/understanding-custom-roles).
-        #   Example request URL:
-        #   `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/roles`
-        #   * [`organizations.roles.create()`](/iam/reference/rest/v1/organizations.roles/
-        #   create):
-        #   `organizations/`ORGANIZATION_ID``. This method creates organization-level
-        #   [custom roles](/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.
+        #   The `parent` parameter's value depends on the target resource for the request,
+        #   namely [`projects`](/iam/reference/rest/v1/projects.roles) or [`organizations`]
+        #   (/iam/reference/rest/v1/organizations.roles). Each resource type's `parent`
+        #   value format is described below: * [`projects.roles.create()`](/iam/reference/
+        #   rest/v1/projects.roles/create): `projects/`PROJECT_ID``. This method creates
+        #   project-level [custom roles](/iam/docs/understanding-custom-roles). Example
+        #   request URL: `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/roles` * [`
+        #   organizations.roles.create()`](/iam/reference/rest/v1/organizations.roles/
+        #   create): `organizations/`ORGANIZATION_ID``. This method creates organization-
+        #   level [custom roles](/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.
@@ -541,39 +500,30 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a custom Role.
-        # When you delete a custom role, the following changes occur immediately:
-        # * You cannot bind a member to the custom role in an IAM
-        # Policy.
-        # * Existing bindings to the custom role are not changed, but they have no
-        # effect.
-        # * By default, the response from ListRoles does not include the custom
-        # role.
-        # You have 7 days to undelete the custom role. After 7 days, the following
-        # changes occur:
-        # * The custom role is permanently deleted and cannot be recovered.
-        # * If an IAM policy contains a binding to the custom role, the binding is
-        # permanently removed.
+        # Deletes a custom Role. When you delete a custom role, the following changes
+        # occur immediately: * You cannot bind a member to the custom role in an IAM
+        # Policy. * Existing bindings to the custom role are not changed, but they have
+        # no effect. * By default, the response from ListRoles does not include the
+        # custom role. You have 7 days to undelete the custom role. After 7 days, the
+        # following changes occur: * The custom role is permanently deleted and cannot
+        # be recovered. * If an IAM policy contains a binding to the custom role, the
+        # binding is permanently removed.
         # @param [String] name
-        #   The `name` parameter's value depends on the target resource for the
-        #   request, namely
-        #   [`projects`](/iam/reference/rest/v1/projects.roles) or
-        #   [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
-        #   resource type's `name` value format is described below:
-        #   * [`projects.roles.delete()`](/iam/reference/rest/v1/projects.roles/delete):
-        #   `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This method deletes only
-        #   [custom roles](/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()`](/iam/reference/rest/v1/organizations.roles/
-        #   delete):
-        #   `organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method
-        #   deletes only [custom roles](/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.
+        #   The `name` parameter's value depends on the target resource for the request,
+        #   namely [`projects`](/iam/reference/rest/v1/projects.roles) or [`organizations`]
+        #   (/iam/reference/rest/v1/organizations.roles). Each resource type's `name`
+        #   value format is described below: * [`projects.roles.delete()`](/iam/reference/
+        #   rest/v1/projects.roles/delete): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``.
+        #   This method deletes only [custom roles](/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()`](/iam/reference/rest/v1/organizations.roles/
+        #   delete): `organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method
+        #   deletes only [custom roles](/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
@@ -606,31 +556,25 @@ 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`](/iam/reference/rest/v1/roles),
-        #   [`projects`](/iam/reference/rest/v1/projects.roles), or
-        #   [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
-        #   resource type's `name` value format is described below:
-        #   * [`roles.get()`](/iam/reference/rest/v1/roles/get): `roles/`ROLE_NAME``.
-        #   This method returns results from all
-        #   [predefined roles](/iam/docs/understanding-roles#predefined_roles) in
-        #   Cloud IAM. Example request URL:
-        #   `https://iam.googleapis.com/v1/roles/`ROLE_NAME``
-        #   * [`projects.roles.get()`](/iam/reference/rest/v1/projects.roles/get):
-        #   `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This method returns only
-        #   [custom roles](/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()`](/iam/reference/rest/v1/organizations.roles/get)
-        #   :
-        #   `organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method
-        #   returns only [custom roles](/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.
+        #   The `name` parameter's value depends on the target resource for the request,
+        #   namely [`roles`](/iam/reference/rest/v1/roles), [`projects`](/iam/reference/
+        #   rest/v1/projects.roles), or [`organizations`](/iam/reference/rest/v1/
+        #   organizations.roles). Each resource type's `name` value format is described
+        #   below: * [`roles.get()`](/iam/reference/rest/v1/roles/get): `roles/`ROLE_NAME``
+        #   . This method returns results from all [predefined roles](/iam/docs/
+        #   understanding-roles#predefined_roles) in Cloud IAM. Example request URL: `
+        #   https://iam.googleapis.com/v1/roles/`ROLE_NAME`` * [`projects.roles.get()`](/
+        #   iam/reference/rest/v1/projects.roles/get): `projects/`PROJECT_ID`/roles/`
+        #   CUSTOM_ROLE_ID``. This method returns only [custom roles](/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()`](/iam/reference/rest/v1/
+        #   organizations.roles/get): `organizations/`ORGANIZATION_ID`/roles/`
+        #   CUSTOM_ROLE_ID``. This method returns only [custom roles](/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
@@ -658,45 +602,38 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists every predefined Role that IAM supports, or every custom role
-        # that is defined for an organization or project.
+        # Lists every predefined Role that IAM supports, or every custom role that is
+        # defined for an organization or project.
         # @param [String] parent
-        #   The `parent` parameter's value depends on the target resource for the
-        #   request, namely
-        #   [`roles`](/iam/reference/rest/v1/roles),
-        #   [`projects`](/iam/reference/rest/v1/projects.roles), or
-        #   [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
-        #   resource type's `parent` value format is described below:
-        #   * [`roles.list()`](/iam/reference/rest/v1/roles/list): An empty string.
-        #   This method doesn't require a resource; it simply returns all
-        #   [predefined roles](/iam/docs/understanding-roles#predefined_roles) in
-        #   Cloud IAM. Example request URL:
-        #   `https://iam.googleapis.com/v1/roles`
-        #   * [`projects.roles.list()`](/iam/reference/rest/v1/projects.roles/list):
-        #   `projects/`PROJECT_ID``. This method lists all project-level
-        #   [custom roles](/iam/docs/understanding-custom-roles).
-        #   Example request URL:
-        #   `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/roles`
-        #   * [`organizations.roles.list()`](/iam/reference/rest/v1/organizations.roles/
-        #   list):
-        #   `organizations/`ORGANIZATION_ID``. This method lists all
-        #   organization-level [custom roles](/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.
+        #   The `parent` parameter's value depends on the target resource for the request,
+        #   namely [`roles`](/iam/reference/rest/v1/roles), [`projects`](/iam/reference/
+        #   rest/v1/projects.roles), or [`organizations`](/iam/reference/rest/v1/
+        #   organizations.roles). Each resource type's `parent` value format is described
+        #   below: * [`roles.list()`](/iam/reference/rest/v1/roles/list): An empty string.
+        #   This method doesn't require a resource; it simply returns all [predefined
+        #   roles](/iam/docs/understanding-roles#predefined_roles) in Cloud IAM. Example
+        #   request URL: `https://iam.googleapis.com/v1/roles` * [`projects.roles.list()`](
+        #   /iam/reference/rest/v1/projects.roles/list): `projects/`PROJECT_ID``. This
+        #   method lists all project-level [custom roles](/iam/docs/understanding-custom-
+        #   roles). Example request URL: `https://iam.googleapis.com/v1/projects/`
+        #   PROJECT_ID`/roles` * [`organizations.roles.list()`](/iam/reference/rest/v1/
+        #   organizations.roles/list): `organizations/`ORGANIZATION_ID``. This method
+        #   lists all organization-level [custom roles](/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 [Fixnum] page_size
-        #   Optional limit on the number of roles to include in the response.
-        #   The default is 300, and the maximum is 1,000.
+        #   Optional limit on the number of roles to include in the response. The default
+        #   is 300, and the maximum is 1,000.
         # @param [String] page_token
         #   Optional pagination token returned in an earlier ListRolesResponse.
         # @param [Boolean] show_deleted
         #   Include Roles that have been deleted.
         # @param [String] view
-        #   Optional view for the returned Role objects. When `FULL` is specified,
-        #   the `includedPermissions` field is returned, which includes a list of all
-        #   permissions in the role. The default value is `BASIC`, which does not
-        #   return the `includedPermissions` field.
+        #   Optional view for the returned Role objects. When `FULL` is specified, the `
+        #   includedPermissions` field is returned, which includes a list of all
+        #   permissions in the role. The default value is `BASIC`, which does not return
+        #   the `includedPermissions` field.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -730,25 +667,21 @@ 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`](/iam/reference/rest/v1/projects.roles) or
-        #   [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
-        #   resource type's `name` value format is described below:
-        #   * [`projects.roles.patch()`](/iam/reference/rest/v1/projects.roles/patch):
-        #   `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This method updates only
-        #   [custom roles](/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()`](/iam/reference/rest/v1/organizations.roles/
-        #   patch):
-        #   `organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method
-        #   updates only [custom roles](/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.
+        #   The `name` parameter's value depends on the target resource for the request,
+        #   namely [`projects`](/iam/reference/rest/v1/projects.roles) or [`organizations`]
+        #   (/iam/reference/rest/v1/organizations.roles). Each resource type's `name`
+        #   value format is described below: * [`projects.roles.patch()`](/iam/reference/
+        #   rest/v1/projects.roles/patch): `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``.
+        #   This method updates only [custom roles](/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()`](/iam/reference/rest/v1/organizations.roles/patch)
+        #   : `organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method
+        #   updates only [custom roles](/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.
@@ -784,26 +717,21 @@ module Google
         
         # Undeletes a custom Role.
         # @param [String] name
-        #   The `name` parameter's value depends on the target resource for the
-        #   request, namely
-        #   [`projects`](/iam/reference/rest/v1/projects.roles) or
-        #   [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
-        #   resource type's `name` value format is described below:
-        #   * [`projects.roles.undelete()`](/iam/reference/rest/v1/projects.roles/undelete)
-        #   :
-        #   `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This method undeletes
-        #   only [custom roles](/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()`](/iam/reference/rest/v1/organizations.
-        #   roles/undelete):
-        #   `organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method
-        #   undeletes only [custom roles](/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.
+        #   The `name` parameter's value depends on the target resource for the request,
+        #   namely [`projects`](/iam/reference/rest/v1/projects.roles) or [`organizations`]
+        #   (/iam/reference/rest/v1/organizations.roles). Each resource type's `name`
+        #   value format is described below: * [`projects.roles.undelete()`](/iam/
+        #   reference/rest/v1/projects.roles/undelete): `projects/`PROJECT_ID`/roles/`
+        #   CUSTOM_ROLE_ID``. This method undeletes only [custom roles](/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()`](/iam/reference/
+        #   rest/v1/organizations.roles/undelete): `organizations/`ORGANIZATION_ID`/roles/`
+        #   CUSTOM_ROLE_ID``. This method undeletes only [custom roles](/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.
@@ -868,24 +796,21 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a ServiceAccount.
-        # **Warning:** After you delete a service account, you might not be able to
-        # undelete it. If you know that you need to re-enable the service account in
-        # the future, use DisableServiceAccount instead.
-        # If you delete a service account, IAM permanently removes the service
-        # account 30 days later. Google Cloud cannot recover the service account
-        # after it is permanently removed, even if you file a support request.
-        # To help avoid unplanned outages, we recommend that you disable the service
-        # account before you delete it. Use DisableServiceAccount to disable the
-        # service account, then wait at least 24 hours and watch for unintended
-        # consequences. If there are no unintended consequences, you can delete the
-        # service account.
+        # Deletes a ServiceAccount. **Warning:** After you delete a service account, you
+        # might not be able to undelete it. If you know that you need to re-enable the
+        # service account in the future, use DisableServiceAccount instead. If you
+        # delete a service account, IAM permanently removes the service account 30 days
+        # later. Google Cloud cannot recover the service account after it is permanently
+        # removed, even if you file a support request. To help avoid unplanned outages,
+        # we recommend that you disable the service account before you delete it. Use
+        # DisableServiceAccount to disable the service account, then wait at least 24
+        # hours and watch for unintended consequences. If there are no unintended
+        # consequences, you can delete the service account.
         # @param [String] name
-        #   Required. The resource name of the service account in the following format:
-        #   `projects/`PROJECT_ID`/serviceAccounts/`ACCOUNT``.
-        #   Using `-` as a wildcard for the `PROJECT_ID` will infer the project from
-        #   the account. The `ACCOUNT` value can be the `email` address or the
-        #   `unique_id` of the service account.
+        #   Required. The resource name of the service account in the following format: `
+        #   projects/`PROJECT_ID`/serviceAccounts/`ACCOUNT``. Using `-` as a wildcard for
+        #   the `PROJECT_ID` will infer the project from the account. The `ACCOUNT` value
+        #   can be the `email` address or the `unique_id` of the service account.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -913,25 +838,22 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Disables a ServiceAccount immediately.
-        # If an application uses the service account to authenticate, that
-        # application can no longer call Google APIs or access Google Cloud
-        # resources. Existing access tokens for the service account are rejected, and
-        # requests for new access tokens will fail.
-        # To re-enable the service account, use EnableServiceAccount. After you
-        # re-enable the service account, its existing access tokens will be accepted,
-        # and you can request new access tokens.
-        # To help avoid unplanned outages, we recommend that you disable the service
-        # account before you delete it. Use this method to disable the service
-        # account, then wait at least 24 hours and watch for unintended consequences.
-        # If there are no unintended consequences, you can delete the service account
-        # with DeleteServiceAccount.
+        # Disables a ServiceAccount immediately. If an application uses the service
+        # account to authenticate, that application can no longer call Google APIs or
+        # access Google Cloud resources. Existing access tokens for the service account
+        # are rejected, and requests for new access tokens will fail. To re-enable the
+        # service account, use EnableServiceAccount. After you re-enable the service
+        # account, its existing access tokens will be accepted, and you can request new
+        # access tokens. To help avoid unplanned outages, we recommend that you disable
+        # the service account before you delete it. Use this method to disable the
+        # service account, then wait at least 24 hours and watch for unintended
+        # consequences. If there are no unintended consequences, you can delete the
+        # service account with DeleteServiceAccount.
         # @param [String] name
-        #   The resource name of the service account in the following format:
-        #   `projects/`PROJECT_ID`/serviceAccounts/`ACCOUNT``.
-        #   Using `-` as a wildcard for the `PROJECT_ID` will infer the project from
-        #   the account. The `ACCOUNT` value can be the `email` address or the
-        #   `unique_id` of the service account.
+        #   The resource name of the service account in the following format: `projects/`
+        #   PROJECT_ID`/serviceAccounts/`ACCOUNT``. Using `-` as a wildcard for the `
+        #   PROJECT_ID` will infer the project from the account. The `ACCOUNT` value can
+        #   be the `email` address or the `unique_id` of the service account.
         # @param [Google::Apis::IamV1::DisableServiceAccountRequest] disable_service_account_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -962,18 +884,16 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Enables a ServiceAccount that was disabled by
-        # DisableServiceAccount.
-        # If the service account is already enabled, then this method has no effect.
-        # If the service account was disabled by other means—for example, if Google
-        # disabled the service account because it was compromised—you cannot use this
-        # method to enable the service account.
+        # Enables a ServiceAccount that was disabled by DisableServiceAccount. If the
+        # service account is already enabled, then this method has no effect. If the
+        # service account was disabled by other means—for example, if Google disabled
+        # the service account because it was compromised—you cannot use this method to
+        # enable the service account.
         # @param [String] name
-        #   The resource name of the service account in the following format:
-        #   `projects/`PROJECT_ID`/serviceAccounts/`ACCOUNT``.
-        #   Using `-` as a wildcard for the `PROJECT_ID` will infer the project from
-        #   the account. The `ACCOUNT` value can be the `email` address or the
-        #   `unique_id` of the service account.
+        #   The resource name of the service account in the following format: `projects/`
+        #   PROJECT_ID`/serviceAccounts/`ACCOUNT``. Using `-` as a wildcard for the `
+        #   PROJECT_ID` will infer the project from the account. The `ACCOUNT` value can
+        #   be the `email` address or the `unique_id` of the service account.
         # @param [Google::Apis::IamV1::EnableServiceAccountRequest] enable_service_account_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1006,11 +926,10 @@ module Google
         
         # Gets a ServiceAccount.
         # @param [String] name
-        #   Required. The resource name of the service account in the following format:
-        #   `projects/`PROJECT_ID`/serviceAccounts/`ACCOUNT``.
-        #   Using `-` as a wildcard for the `PROJECT_ID` will infer the project from
-        #   the account. The `ACCOUNT` value can be the `email` address or the
-        #   `unique_id` of the service account.
+        #   Required. The resource name of the service account in the following format: `
+        #   projects/`PROJECT_ID`/serviceAccounts/`ACCOUNT``. Using `-` as a wildcard for
+        #   the `PROJECT_ID` will infer the project from the account. The `ACCOUNT` value
+        #   can be the `email` address or the `unique_id` of the service account.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1038,29 +957,25 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the IAM policy that is attached to a ServiceAccount. This IAM
-        # policy specifies which members have access to the service account.
-        # This method 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/projects/getIamPolicy)
-        # method.
+        # Gets the IAM policy that is attached to a ServiceAccount. This IAM policy
+        # specifies which members have access to the service account. This method 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/projects/
+        # getIamPolicy) method.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being requested.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy is being requested. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Fixnum] options_requested_policy_version
-        #   Optional. The policy format version to be returned.
-        #   Valid values are 0, 1, and 3. Requests specifying an invalid value will be
-        #   rejected.
-        #   Requests for policies with any conditional bindings must specify version 3.
-        #   Policies without any conditional bindings may specify any valid value or
-        #   leave the field unset.
-        #   To learn which resources support conditions in their IAM policies, see the
-        #   [IAM
-        #   documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+        #   Optional. The policy format version to be returned. Valid values are 0, 1, and
+        #   3. Requests specifying an invalid value will be rejected. Requests for
+        #   policies with any conditional bindings must specify version 3. Policies
+        #   without any conditional bindings may specify any valid value or leave the
+        #   field unset. To learn which resources support conditions in their IAM policies,
+        #   see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
+        #   resource-policies).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1094,14 +1009,13 @@ module Google
         #   Required. The resource name of the project associated with the service
         #   accounts, such as `projects/my-project-123`.
         # @param [Fixnum] page_size
-        #   Optional limit on the number of service accounts to include in the
-        #   response. Further accounts can subsequently be obtained by including the
-        #   ListServiceAccountsResponse.next_page_token
-        #   in a subsequent request.
-        #   The default is 20, and the maximum is 100.
+        #   Optional limit on the number of service accounts to include in the response.
+        #   Further accounts can subsequently be obtained by including the
+        #   ListServiceAccountsResponse.next_page_token in a subsequent request. The
+        #   default is 20, and the maximum is 100.
         # @param [String] page_token
-        #   Optional pagination token returned in an earlier
-        #   ListServiceAccountsResponse.next_page_token.
+        #   Optional pagination token returned in an earlier ListServiceAccountsResponse.
+        #   next_page_token.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1133,19 +1047,15 @@ module Google
         
         # Patches a ServiceAccount.
         # @param [String] name
-        #   The resource name of the service account.
-        #   Use one of the following formats:
-        #   * `projects/`PROJECT_ID`/serviceAccounts/`EMAIL_ADDRESS``
-        #   * `projects/`PROJECT_ID`/serviceAccounts/`UNIQUE_ID``
-        #   As an alternative, you can use the `-` wildcard character instead of the
-        #   project ID:
-        #   * `projects/-/serviceAccounts/`EMAIL_ADDRESS``
-        #   * `projects/-/serviceAccounts/`UNIQUE_ID``
-        #   When possible, avoid using the `-` wildcard character, because it can cause
-        #   response messages to contain misleading error codes. For example, if you
-        #   try to get the service account
-        #   `projects/-/serviceAccounts/fake@example.com`, which does not exist, the
-        #   response contains an HTTP `403 Forbidden` error instead of a `404 Not
+        #   The resource name of the service account. Use one of the following formats: * `
+        #   projects/`PROJECT_ID`/serviceAccounts/`EMAIL_ADDRESS`` * `projects/`PROJECT_ID`
+        #   /serviceAccounts/`UNIQUE_ID`` As an alternative, you can use the `-` wildcard
+        #   character instead of the project ID: * `projects/-/serviceAccounts/`
+        #   EMAIL_ADDRESS`` * `projects/-/serviceAccounts/`UNIQUE_ID`` When possible,
+        #   avoid using the `-` wildcard character, because it can cause response messages
+        #   to contain misleading error codes. For example, if you try to get the service
+        #   account `projects/-/serviceAccounts/fake@example.com`, which does not exist,
+        #   the response contains an HTTP `403 Forbidden` error instead of a `404 Not
         #   Found` error.
         # @param [Google::Apis::IamV1::PatchServiceAccountRequest] patch_service_account_request_object
         # @param [String] fields
@@ -1177,23 +1087,20 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Sets the IAM policy that is attached to a ServiceAccount.
-        # Use this method to grant or revoke access to the service account. For
-        # example, you could grant a member the ability to impersonate the service
-        # account.
-        # This method does not enable the service account to access other resources.
-        # To grant roles to a service account on a resource, follow these steps:
-        # 1. Call the resource's `getIamPolicy` method to get its current IAM policy.
-        # 2. Edit the policy so that it binds the service account to an IAM role for
-        # the resource.
-        # 3. Call the resource's `setIamPolicy` method to update its IAM policy.
-        # For detailed instructions, see
-        # [Granting roles to a service account for specific
-        # resources](https://cloud.google.com/iam/help/service-accounts/granting-access-
-        # to-service-accounts).
+        # Sets the IAM policy that is attached to a ServiceAccount. Use this method to
+        # grant or revoke access to the service account. For example, you could grant a
+        # member the ability to impersonate the service account. This method does not
+        # enable the service account to access other resources. To grant roles to a
+        # service account on a resource, follow these steps: 1. Call the resource's `
+        # getIamPolicy` method to get its current IAM policy. 2. Edit the policy so that
+        # it binds the service account to an IAM role for the resource. 3. Call the
+        # resource's `setIamPolicy` method to update its IAM policy. For detailed
+        # instructions, see [Granting roles to a service account for specific resources](
+        # https://cloud.google.com/iam/help/service-accounts/granting-access-to-service-
+        # accounts).
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being specified.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy is being specified. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::IamV1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1224,17 +1131,20 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # **Note:** We are in the process of deprecating this method. Use the
-        # [`signBlob`](https://cloud.google.com/iam/help/rest-credentials/v1/projects.
-        # serviceAccounts/signBlob)
-        # method in the IAM Service Account Credentials API instead.
-        # Signs a blob using the system-managed private key for a ServiceAccount.
+        # **Note:** This method is deprecated and will stop working on July 1, 2021. 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/credentials/migrate-api) for
+        # instructions. Signs a blob using the system-managed private key for a
+        # ServiceAccount.
         # @param [String] name
-        #   Required. The resource name of the service account in the following format:
-        #   `projects/`PROJECT_ID`/serviceAccounts/`ACCOUNT``.
-        #   Using `-` as a wildcard for the `PROJECT_ID` will infer the project from
-        #   the account. The `ACCOUNT` value can be the `email` address or the
-        #   `unique_id` of the service account.
+        #   Required. Deprecated. [Migrate to Service Account Credentials API](https://
+        #   cloud.google.com/iam/help/credentials/migrate-api). The resource name of the
+        #   service account in the following format: `projects/`PROJECT_ID`/
+        #   serviceAccounts/`ACCOUNT``. Using `-` as a wildcard for the `PROJECT_ID` will
+        #   infer the project from the account. The `ACCOUNT` value can be the `email`
+        #   address or the `unique_id` of the service account.
         # @param [Google::Apis::IamV1::SignBlobRequest] sign_blob_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1265,18 +1175,19 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # **Note:** We are in the process of deprecating this method. Use the
-        # [`signJwt`](https://cloud.google.com/iam/help/rest-credentials/v1/projects.
-        # serviceAccounts/signJwt)
-        # method in the IAM Service Account Credentials API instead.
-        # Signs a JSON Web Token (JWT) using the system-managed private key for a
-        # ServiceAccount.
+        # **Note:** This method is deprecated and will stop working on July 1, 2021. 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/credentials/migrate-api) for instructions. Signs a
+        # JSON Web Token (JWT) using the system-managed private key for a ServiceAccount.
         # @param [String] name
-        #   Required. The resource name of the service account in the following format:
-        #   `projects/`PROJECT_ID`/serviceAccounts/`ACCOUNT``.
-        #   Using `-` as a wildcard for the `PROJECT_ID` will infer the project from
-        #   the account. The `ACCOUNT` value can be the `email` address or the
-        #   `unique_id` of the service account.
+        #   Required. Deprecated. [Migrate to Service Account Credentials API](https://
+        #   cloud.google.com/iam/help/credentials/migrate-api). The resource name of the
+        #   service account in the following format: `projects/`PROJECT_ID`/
+        #   serviceAccounts/`ACCOUNT``. Using `-` as a wildcard for the `PROJECT_ID` will
+        #   infer the project from the account. The `ACCOUNT` value can be the `email`
+        #   address or the `unique_id` of the service account.
         # @param [Google::Apis::IamV1::SignJwtRequest] sign_jwt_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1307,11 +1218,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Tests whether the caller has the specified permissions on a
-        # ServiceAccount.
+        # Tests whether the caller has the specified permissions on a ServiceAccount.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy detail is being requested.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy detail is being requested. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::IamV1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1342,17 +1252,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Restores a deleted ServiceAccount.
-        # **Important:** It is not always possible to restore a deleted service
-        # account. Use this method only as a last resort.
+        # Restores a deleted ServiceAccount. **Important:** It is not always possible to
+        # restore a deleted service account. Use this method only as a last resort.
         # After you delete a service account, IAM permanently removes the service
         # account 30 days later. There is no way to restore a deleted service account
         # that has been permanently removed.
         # @param [String] name
-        #   The resource name of the service account in the following format:
-        #   `projects/`PROJECT_ID`/serviceAccounts/`ACCOUNT_UNIQUE_ID``.
-        #   Using `-` as a wildcard for the `PROJECT_ID` will infer the project from
-        #   the account.
+        #   The resource name of the service account in the following format: `projects/`
+        #   PROJECT_ID`/serviceAccounts/`ACCOUNT_UNIQUE_ID``. Using `-` as a wildcard for
+        #   the `PROJECT_ID` will infer the project from the account.
         # @param [Google::Apis::IamV1::UndeleteServiceAccountRequest] undelete_service_account_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1384,23 +1292,18 @@ module Google
         end
         
         # **Note:** We are in the process of deprecating this method. Use
-        # PatchServiceAccount instead.
-        # Updates a ServiceAccount.
-        # You can update only the `display_name` and `description` fields.
+        # PatchServiceAccount instead. Updates a ServiceAccount. You can update only the
+        # `display_name` and `description` fields.
         # @param [String] name
-        #   The resource name of the service account.
-        #   Use one of the following formats:
-        #   * `projects/`PROJECT_ID`/serviceAccounts/`EMAIL_ADDRESS``
-        #   * `projects/`PROJECT_ID`/serviceAccounts/`UNIQUE_ID``
-        #   As an alternative, you can use the `-` wildcard character instead of the
-        #   project ID:
-        #   * `projects/-/serviceAccounts/`EMAIL_ADDRESS``
-        #   * `projects/-/serviceAccounts/`UNIQUE_ID``
-        #   When possible, avoid using the `-` wildcard character, because it can cause
-        #   response messages to contain misleading error codes. For example, if you
-        #   try to get the service account
-        #   `projects/-/serviceAccounts/fake@example.com`, which does not exist, the
-        #   response contains an HTTP `403 Forbidden` error instead of a `404 Not
+        #   The resource name of the service account. Use one of the following formats: * `
+        #   projects/`PROJECT_ID`/serviceAccounts/`EMAIL_ADDRESS`` * `projects/`PROJECT_ID`
+        #   /serviceAccounts/`UNIQUE_ID`` As an alternative, you can use the `-` wildcard
+        #   character instead of the project ID: * `projects/-/serviceAccounts/`
+        #   EMAIL_ADDRESS`` * `projects/-/serviceAccounts/`UNIQUE_ID`` When possible,
+        #   avoid using the `-` wildcard character, because it can cause response messages
+        #   to contain misleading error codes. For example, if you try to get the service
+        #   account `projects/-/serviceAccounts/fake@example.com`, which does not exist,
+        #   the response contains an HTTP `403 Forbidden` error instead of a `404 Not
         #   Found` error.
         # @param [Google::Apis::IamV1::ServiceAccount] service_account_object
         # @param [String] fields
@@ -1434,11 +1337,10 @@ module Google
         
         # Creates a ServiceAccountKey.
         # @param [String] name
-        #   Required. The resource name of the service account in the following format:
-        #   `projects/`PROJECT_ID`/serviceAccounts/`ACCOUNT``.
-        #   Using `-` as a wildcard for the `PROJECT_ID` will infer the project from
-        #   the account. The `ACCOUNT` value can be the `email` address or the
-        #   `unique_id` of the service account.
+        #   Required. The resource name of the service account in the following format: `
+        #   projects/`PROJECT_ID`/serviceAccounts/`ACCOUNT``. Using `-` as a wildcard for
+        #   the `PROJECT_ID` will infer the project from the account. The `ACCOUNT` value
+        #   can be the `email` address or the `unique_id` of the service account.
         # @param [Google::Apis::IamV1::CreateServiceAccountKeyRequest] create_service_account_key_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1472,10 +1374,10 @@ module Google
         # Deletes a ServiceAccountKey.
         # @param [String] name
         #   Required. The resource name of the service account key in the following format:
-        #   `projects/`PROJECT_ID`/serviceAccounts/`ACCOUNT`/keys/`key``.
-        #   Using `-` as a wildcard for the `PROJECT_ID` will infer the project from
-        #   the account. The `ACCOUNT` value can be the `email` address or the
-        #   `unique_id` of the service account.
+        #   `projects/`PROJECT_ID`/serviceAccounts/`ACCOUNT`/keys/`key``. Using `-` as a
+        #   wildcard for the `PROJECT_ID` will infer the project from the account. The `
+        #   ACCOUNT` value can be the `email` address or the `unique_id` of the service
+        #   account.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1506,13 +1408,13 @@ module Google
         # Gets a ServiceAccountKey.
         # @param [String] name
         #   Required. The resource name of the service account key in the following format:
-        #   `projects/`PROJECT_ID`/serviceAccounts/`ACCOUNT`/keys/`key``.
-        #   Using `-` as a wildcard for the `PROJECT_ID` will infer the project from
-        #   the account. The `ACCOUNT` value can be the `email` address or the
-        #   `unique_id` of the service account.
+        #   `projects/`PROJECT_ID`/serviceAccounts/`ACCOUNT`/keys/`key``. Using `-` as a
+        #   wildcard for the `PROJECT_ID` will infer the project from the account. The `
+        #   ACCOUNT` value can be the `email` address or the `unique_id` of the service
+        #   account.
         # @param [String] public_key_type
-        #   The output format of the public key requested.
-        #   X509_PEM is the default output format.
+        #   The output format of the public key requested. X509_PEM is the default output
+        #   format.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1543,15 +1445,14 @@ module Google
         
         # Lists every ServiceAccountKey for a service account.
         # @param [String] name
-        #   Required. The resource name of the service account in the following format:
-        #   `projects/`PROJECT_ID`/serviceAccounts/`ACCOUNT``.
-        #   Using `-` as a wildcard for the `PROJECT_ID`, will infer the project from
-        #   the account. The `ACCOUNT` value can be the `email` address or the
-        #   `unique_id` of the service account.
+        #   Required. The resource name of the service account in the following format: `
+        #   projects/`PROJECT_ID`/serviceAccounts/`ACCOUNT``. Using `-` as a wildcard for
+        #   the `PROJECT_ID`, will infer the project from the account. The `ACCOUNT` value
+        #   can be the `email` address or the `unique_id` of the service account.
         # @param [Array<String>, String] key_types
-        #   Filters the types of keys the user wants to include in the list
-        #   response. Duplicate key types are not allowed. If no key type
-        #   is provided, all keys are returned.
+        #   Filters the types of keys the user wants to include in the list response.
+        #   Duplicate key types are not allowed. If no key type is provided, all keys are
+        #   returned.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1582,11 +1483,10 @@ module Google
         
         # Creates a ServiceAccountKey, using a public key that you provide.
         # @param [String] name
-        #   The resource name of the service account in the following format:
-        #   `projects/`PROJECT_ID`/serviceAccounts/`ACCOUNT``.
-        #   Using `-` as a wildcard for the `PROJECT_ID` will infer the project from
-        #   the account. The `ACCOUNT` value can be the `email` address or the
-        #   `unique_id` of the service account.
+        #   The resource name of the service account in the following format: `projects/`
+        #   PROJECT_ID`/serviceAccounts/`ACCOUNT``. Using `-` as a wildcard for the `
+        #   PROJECT_ID` will infer the project from the account. The `ACCOUNT` value can
+        #   be the `email` address or the `unique_id` of the service account.
         # @param [Google::Apis::IamV1::UploadServiceAccountKeyRequest] upload_service_account_key_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1619,31 +1519,25 @@ 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`](/iam/reference/rest/v1/roles),
-        #   [`projects`](/iam/reference/rest/v1/projects.roles), or
-        #   [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
-        #   resource type's `name` value format is described below:
-        #   * [`roles.get()`](/iam/reference/rest/v1/roles/get): `roles/`ROLE_NAME``.
-        #   This method returns results from all
-        #   [predefined roles](/iam/docs/understanding-roles#predefined_roles) in
-        #   Cloud IAM. Example request URL:
-        #   `https://iam.googleapis.com/v1/roles/`ROLE_NAME``
-        #   * [`projects.roles.get()`](/iam/reference/rest/v1/projects.roles/get):
-        #   `projects/`PROJECT_ID`/roles/`CUSTOM_ROLE_ID``. This method returns only
-        #   [custom roles](/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()`](/iam/reference/rest/v1/organizations.roles/get)
-        #   :
-        #   `organizations/`ORGANIZATION_ID`/roles/`CUSTOM_ROLE_ID``. This method
-        #   returns only [custom roles](/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.
+        #   The `name` parameter's value depends on the target resource for the request,
+        #   namely [`roles`](/iam/reference/rest/v1/roles), [`projects`](/iam/reference/
+        #   rest/v1/projects.roles), or [`organizations`](/iam/reference/rest/v1/
+        #   organizations.roles). Each resource type's `name` value format is described
+        #   below: * [`roles.get()`](/iam/reference/rest/v1/roles/get): `roles/`ROLE_NAME``
+        #   . This method returns results from all [predefined roles](/iam/docs/
+        #   understanding-roles#predefined_roles) in Cloud IAM. Example request URL: `
+        #   https://iam.googleapis.com/v1/roles/`ROLE_NAME`` * [`projects.roles.get()`](/
+        #   iam/reference/rest/v1/projects.roles/get): `projects/`PROJECT_ID`/roles/`
+        #   CUSTOM_ROLE_ID``. This method returns only [custom roles](/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()`](/iam/reference/rest/v1/
+        #   organizations.roles/get): `organizations/`ORGANIZATION_ID`/roles/`
+        #   CUSTOM_ROLE_ID``. This method returns only [custom roles](/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
@@ -1671,45 +1565,38 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists every predefined Role that IAM supports, or every custom role
-        # that is defined for an organization or project.
+        # Lists every predefined Role that IAM supports, or every custom role that is
+        # defined for an organization or project.
         # @param [Fixnum] page_size
-        #   Optional limit on the number of roles to include in the response.
-        #   The default is 300, and the maximum is 1,000.
+        #   Optional limit on the number of roles to include in the response. The default
+        #   is 300, and the maximum is 1,000.
         # @param [String] page_token
         #   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`](/iam/reference/rest/v1/roles),
-        #   [`projects`](/iam/reference/rest/v1/projects.roles), or
-        #   [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
-        #   resource type's `parent` value format is described below:
-        #   * [`roles.list()`](/iam/reference/rest/v1/roles/list): An empty string.
-        #   This method doesn't require a resource; it simply returns all
-        #   [predefined roles](/iam/docs/understanding-roles#predefined_roles) in
-        #   Cloud IAM. Example request URL:
-        #   `https://iam.googleapis.com/v1/roles`
-        #   * [`projects.roles.list()`](/iam/reference/rest/v1/projects.roles/list):
-        #   `projects/`PROJECT_ID``. This method lists all project-level
-        #   [custom roles](/iam/docs/understanding-custom-roles).
-        #   Example request URL:
-        #   `https://iam.googleapis.com/v1/projects/`PROJECT_ID`/roles`
-        #   * [`organizations.roles.list()`](/iam/reference/rest/v1/organizations.roles/
-        #   list):
-        #   `organizations/`ORGANIZATION_ID``. This method lists all
-        #   organization-level [custom roles](/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.
+        #   The `parent` parameter's value depends on the target resource for the request,
+        #   namely [`roles`](/iam/reference/rest/v1/roles), [`projects`](/iam/reference/
+        #   rest/v1/projects.roles), or [`organizations`](/iam/reference/rest/v1/
+        #   organizations.roles). Each resource type's `parent` value format is described
+        #   below: * [`roles.list()`](/iam/reference/rest/v1/roles/list): An empty string.
+        #   This method doesn't require a resource; it simply returns all [predefined
+        #   roles](/iam/docs/understanding-roles#predefined_roles) in Cloud IAM. Example
+        #   request URL: `https://iam.googleapis.com/v1/roles` * [`projects.roles.list()`](
+        #   /iam/reference/rest/v1/projects.roles/list): `projects/`PROJECT_ID``. This
+        #   method lists all project-level [custom roles](/iam/docs/understanding-custom-
+        #   roles). Example request URL: `https://iam.googleapis.com/v1/projects/`
+        #   PROJECT_ID`/roles` * [`organizations.roles.list()`](/iam/reference/rest/v1/
+        #   organizations.roles/list): `organizations/`ORGANIZATION_ID``. This method
+        #   lists all organization-level [custom roles](/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 [Boolean] show_deleted
         #   Include Roles that have been deleted.
         # @param [String] view
-        #   Optional view for the returned Role objects. When `FULL` is specified,
-        #   the `includedPermissions` field is returned, which includes a list of all
-        #   permissions in the role. The default value is `BASIC`, which does not
-        #   return the `includedPermissions` field.
+        #   Optional view for the returned Role objects. When `FULL` is specified, the `
+        #   includedPermissions` field is returned, which includes a list of all
+        #   permissions in the role. The default value is `BASIC`, which does not return
+        #   the `includedPermissions` field.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1742,8 +1629,7 @@ module Google
         end
         
         # Lists roles that can be granted on a Google Cloud resource. A role is
-        # grantable if the IAM policy for the resource can contain bindings to the
-        # role.
+        # grantable if the IAM policy for the resource can contain bindings to the role.
         # @param [Google::Apis::IamV1::QueryGrantableRolesRequest] query_grantable_roles_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.