google-api-client 0.28.4 → 0.28.5

data/generated/google/apis/groupssettings_v1/representations.rb

@@ -37,9 +37,11 @@ module Google
           property :archive_only, as: 'archiveOnly'
           property :custom_footer_text, as: 'customFooterText'
           property :custom_reply_to, as: 'customReplyTo'
+          property :custom_roles_enabled_for_settings_to_be_merged, as: 'customRolesEnabledForSettingsToBeMerged'
           property :default_message_deny_notification_text, as: 'defaultMessageDenyNotificationText'
           property :description, as: 'description'
           property :email, as: 'email'
+          property :enable_collaborative_inbox, as: 'enableCollaborativeInbox'
           property :favorite_replies_on_top, as: 'favoriteRepliesOnTop'
           property :include_custom_footer, as: 'includeCustomFooter'
           property :include_in_global_address_list, as: 'includeInGlobalAddressList'
@@ -57,17 +59,33 @@ module Google
           property :spam_moderation_level, as: 'spamModerationLevel'
           property :who_can_add, as: 'whoCanAdd'
           property :who_can_add_references, as: 'whoCanAddReferences'
+          property :who_can_approve_members, as: 'whoCanApproveMembers'
+          property :who_can_approve_messages, as: 'whoCanApproveMessages'
           property :who_can_assign_topics, as: 'whoCanAssignTopics'
+          property :who_can_assist_content, as: 'whoCanAssistContent'
+          property :who_can_ban_users, as: 'whoCanBanUsers'
           property :who_can_contact_owner, as: 'whoCanContactOwner'
+          property :who_can_delete_any_post, as: 'whoCanDeleteAnyPost'
+          property :who_can_delete_topics, as: 'whoCanDeleteTopics'
+          property :who_can_discover_group, as: 'whoCanDiscoverGroup'
           property :who_can_enter_free_form_tags, as: 'whoCanEnterFreeFormTags'
+          property :who_can_hide_abuse, as: 'whoCanHideAbuse'
           property :who_can_invite, as: 'whoCanInvite'
           property :who_can_join, as: 'whoCanJoin'
           property :who_can_leave_group, as: 'whoCanLeaveGroup'
+          property :who_can_lock_topics, as: 'whoCanLockTopics'
+          property :who_can_make_topics_sticky, as: 'whoCanMakeTopicsSticky'
           property :who_can_mark_duplicate, as: 'whoCanMarkDuplicate'
           property :who_can_mark_favorite_reply_on_any_topic, as: 'whoCanMarkFavoriteReplyOnAnyTopic'
           property :who_can_mark_favorite_reply_on_own_topic, as: 'whoCanMarkFavoriteReplyOnOwnTopic'
           property :who_can_mark_no_response_needed, as: 'whoCanMarkNoResponseNeeded'
+          property :who_can_moderate_content, as: 'whoCanModerateContent'
+          property :who_can_moderate_members, as: 'whoCanModerateMembers'
+          property :who_can_modify_members, as: 'whoCanModifyMembers'
           property :who_can_modify_tags_and_categories, as: 'whoCanModifyTagsAndCategories'
+          property :who_can_move_topics_in, as: 'whoCanMoveTopicsIn'
+          property :who_can_move_topics_out, as: 'whoCanMoveTopicsOut'
+          property :who_can_post_announcements, as: 'whoCanPostAnnouncements'
           property :who_can_post_message, as: 'whoCanPostMessage'
           property :who_can_take_topics, as: 'whoCanTakeTopics'
           property :who_can_unassign_topic, as: 'whoCanUnassignTopic'

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

@@ -22,7 +22,7 @@ module Google
     module GroupssettingsV1
       # Groups Settings API
       #
-      # Lets you manage permission levels and related settings of a group.
+      # Manages permission levels and related settings of a group.
       #
       # @example
       #    require 'google/apis/groupssettings_v1'

data/generated/google/apis/iam_v1.rb

@@ -27,7 +27,7 @@ module Google
     # @see https://cloud.google.com/iam/
     module IamV1
       VERSION = 'V1'
-      REVISION = '20190201'
+      REVISION = '20190318'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -203,7 +203,7 @@ module Google
         # account. For example, `my-other-app@appspot.gserviceaccount.com`.
         # * `group:`emailid``: An email address that represents a Google group.
         # For example, `admins@example.com`.
-        # * `domain:`domain``: A Google Apps domain name that represents all the
+        # * `domain:`domain``: The G Suite domain (primary) that represents all the
         # users of that domain. For example, `google.com` or `example.com`.
         # Corresponds to the JSON property `members`
         # @return [Array<String>]
@@ -367,6 +367,19 @@ module Google
         end
       end
       
+      # The service account disable request.
+      class DisableServiceAccountRequest
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # A generic empty message that you can re-use to avoid defining duplicated
       # empty messages in your APIs. A typical example is to use it as the request
       # or the response type of an API method. For instance:
@@ -386,6 +399,19 @@ module Google
         end
       end
       
+      # The service account enable request.
+      class EnableServiceAccountRequest
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Represents an expression text. Example:
       # title: "User account presence"
       # description: "Determines whether the request has a user account"
@@ -695,6 +721,43 @@ module Google
         end
       end
       
+      # The patch service account request.
+      class PatchServiceAccountRequest
+        include Google::Apis::Core::Hashable
+      
+        # A service account in the Identity and Access Management API.
+        # To create a service account, specify the `project_id` and the `account_id`
+        # for the account.  The `account_id` is unique within the project, and is used
+        # to generate the service account email address and a stable
+        # `unique_id`.
+        # If the account already exists, the account's resource name is returned
+        # in the format of projects/`PROJECT_ID`/serviceAccounts/`ACCOUNT`. The caller
+        # can use the name in other methods to access the account.
+        # All other methods can identify the service account using the 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.
+        # Corresponds to the JSON property `serviceAccount`
+        # @return [Google::Apis::IamV1::ServiceAccount]
+        attr_accessor :service_account
+      
+        # 
+        # Corresponds to the JSON property `updateMask`
+        # @return [String]
+        attr_accessor :update_mask
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @service_account = args[:service_account] if args.key?(:service_account)
+          @update_mask = args[:update_mask] if args.key?(:update_mask)
+        end
+      end
+      
       # A permission which can be included by a role.
       class Permission
         include Google::Apis::Core::Hashable
@@ -1106,6 +1169,19 @@ module Google
       class ServiceAccount
         include Google::Apis::Core::Hashable
       
+        # Optional. A user-specified opaque description of the service account.
+        # Must be less than or equal to 256 UTF-8 bytes.
+        # Corresponds to the JSON property `description`
+        # @return [String]
+        attr_accessor :description
+      
+        # @OutputOnly A bool indicate if the service account is disabled.
+        # The field is currently in alpha phase.
+        # Corresponds to the JSON property `disabled`
+        # @return [Boolean]
+        attr_accessor :disabled
+        alias_method :disabled?, :disabled
+      
         # Optional. A user-specified name for the service account.
         # Must be less than or equal to 100 UTF-8 bytes.
         # Corresponds to the JSON property `displayName`
@@ -1158,6 +1234,8 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @description = args[:description] if args.key?(:description)
+          @disabled = args[:disabled] if args.key?(:disabled)
           @display_name = args[:display_name] if args.key?(:display_name)
           @email = args[:email] if args.key?(:email)
           @etag = args[:etag] if args.key?(:etag)
@@ -1465,6 +1543,50 @@ module Google
           @etag = args[:etag] if args.key?(:etag)
         end
       end
+      
+      # The service account undelete request.
+      class UndeleteServiceAccountRequest
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # 
+      class UndeleteServiceAccountResponse
+        include Google::Apis::Core::Hashable
+      
+        # A service account in the Identity and Access Management API.
+        # To create a service account, specify the `project_id` and the `account_id`
+        # for the account.  The `account_id` is unique within the project, and is used
+        # to generate the service account email address and a stable
+        # `unique_id`.
+        # If the account already exists, the account's resource name is returned
+        # in the format of projects/`PROJECT_ID`/serviceAccounts/`ACCOUNT`. The caller
+        # can use the name in other methods to access the account.
+        # All other methods can identify the service account using the 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.
+        # Corresponds to the JSON property `restoredAccount`
+        # @return [Google::Apis::IamV1::ServiceAccount]
+        attr_accessor :restored_account
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @restored_account = args[:restored_account] if args.key?(:restored_account)
+        end
+      end
     end
   end
 end

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

@@ -76,12 +76,24 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class DisableServiceAccountRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Empty
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class EnableServiceAccountRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Expr
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -124,6 +136,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class PatchServiceAccountRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Permission
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -244,6 +262,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class UndeleteServiceAccountRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class UndeleteServiceAccountResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class AuditConfig
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -323,12 +353,24 @@ module Google
         end
       end
       
+      class DisableServiceAccountRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class Empty
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
         end
       end
       
+      class EnableServiceAccountRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class Expr
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -400,6 +442,15 @@ module Google
         end
       end
       
+      class PatchServiceAccountRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :service_account, as: 'serviceAccount', class: Google::Apis::IamV1::ServiceAccount, decorator: Google::Apis::IamV1::ServiceAccount::Representation
+      
+          property :update_mask, as: 'updateMask'
+        end
+      end
+      
       class Permission
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -501,6 +552,8 @@ module Google
       class ServiceAccount
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :description, as: 'description'
+          property :disabled, as: 'disabled'
           property :display_name, as: 'displayName'
           property :email, as: 'email'
           property :etag, :base64 => true, as: 'etag'
@@ -583,6 +636,20 @@ module Google
           property :etag, :base64 => true, as: 'etag'
         end
       end
+      
+      class UndeleteServiceAccountRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class UndeleteServiceAccountResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :restored_account, as: 'restoredAccount', class: Google::Apis::IamV1::ServiceAccount, decorator: Google::Apis::IamV1::ServiceAccount::Representation
+      
+        end
+      end
     end
   end
 end

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

@@ -251,7 +251,10 @@ module Google
         # @param [Boolean] show_deleted
         #   Include Roles that have been deleted.
         # @param [String] view
-        #   Optional view for the returned Role objects.
+        #   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
@@ -510,7 +513,10 @@ module Google
         # @param [Boolean] show_deleted
         #   Include Roles that have been deleted.
         # @param [String] view
-        #   Optional view for the returned Role objects.
+        #   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
@@ -685,6 +691,81 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Disables a ServiceAccount.
+        # The API is currently in alpha phase.
+        # @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.
+        # @param [Google::Apis::IamV1::DisableServiceAccountRequest] disable_service_account_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::IamV1::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::IamV1::Empty]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def disable_service_account(name, disable_service_account_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/{+name}:disable', options)
+          command.request_representation = Google::Apis::IamV1::DisableServiceAccountRequest::Representation
+          command.request_object = disable_service_account_request_object
+          command.response_representation = Google::Apis::IamV1::Empty::Representation
+          command.response_class = Google::Apis::IamV1::Empty
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Enables a ServiceAccount.
+        # The API is currently in alpha phase.
+        # @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.
+        # @param [Google::Apis::IamV1::EnableServiceAccountRequest] enable_service_account_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::IamV1::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::IamV1::Empty]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def enable_service_account(name, enable_service_account_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/{+name}:enable', options)
+          command.request_representation = Google::Apis::IamV1::EnableServiceAccountRequest::Representation
+          command.request_object = enable_service_account_request_object
+          command.response_representation = Google::Apis::IamV1::Empty::Representation
+          command.response_class = Google::Apis::IamV1::Empty
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Gets a ServiceAccount.
         # @param [String] name
         #   The resource name of the service account in the following format:
@@ -719,8 +800,20 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns the IAM access control policy for a
+        # Returns the Cloud IAM access control policy for a
         # ServiceAccount.
+        # Note: Service accounts are both
+        # [resources and
+        # identities](/iam/docs/service-accounts#service_account_permissions). This
+        # method treats the service account as a resource. It returns the Cloud IAM
+        # policy that reflects what members have access to the service account.
+        # This method does not return what resources the service account has access
+        # to. To see if a service account has access to a resource, call the
+        # `getIamPolicy` method on the target resource. For example, to view grants
+        # for a project, call the
+        # [projects.getIamPolicy](/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.
@@ -792,8 +885,65 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Sets the IAM access control policy for a
+        # Patches a ServiceAccount.
+        # Currently, only the following fields are updatable:
+        # `display_name` and `description`.
+        # Only fields specified in the request are guaranteed to be returned in
+        # the response. Other fields in the response may be empty.
+        # Note: The field mask is required.
+        # @param [String] name
+        #   The resource name of the service account in the following format:
+        #   `projects/`PROJECT_ID`/serviceAccounts/`ACCOUNT``.
+        #   Requests using `-` as a wildcard for the `PROJECT_ID` will infer the
+        #   project from the `account` and the `ACCOUNT` value can be the `email`
+        #   address or the `unique_id` of the service account.
+        #   In responses the resource name will always be in the format
+        #   `projects/`PROJECT_ID`/serviceAccounts/`ACCOUNT``.
+        # @param [Google::Apis::IamV1::PatchServiceAccountRequest] patch_service_account_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::IamV1::ServiceAccount] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::IamV1::ServiceAccount]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def patch_service_account(name, patch_service_account_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:patch, 'v1/{+name}', options)
+          command.request_representation = Google::Apis::IamV1::PatchServiceAccountRequest::Representation
+          command.request_object = patch_service_account_request_object
+          command.response_representation = Google::Apis::IamV1::ServiceAccount::Representation
+          command.response_class = Google::Apis::IamV1::ServiceAccount
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Sets the Cloud IAM access control policy for a
         # ServiceAccount.
+        # Note: Service accounts are both
+        # [resources and
+        # identities](/iam/docs/service-accounts#service_account_permissions). This
+        # method treats the service account as a resource. Use it to grant members
+        # access to the service account, such as when they need to impersonate it.
+        # This method does not grant the service account access to other resources,
+        # such as projects. To grant a service account access to resources, include
+        # the service account in the Cloud IAM policy for the desired resource, then
+        # call the appropriate `setIamPolicy` method on the target resource. For
+        # example, to grant a service account access to a project, call the
+        # [projects.setIamPolicy](/resource-manager/reference/rest/v1/projects/
+        # setIamPolicy)
+        # method.
         # @param [String] resource
         #   REQUIRED: The resource for which the policy is being specified.
         #   See the operation documentation for the appropriate value for this field.
@@ -947,6 +1097,46 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Restores a deleted ServiceAccount.
+        # This is to be used as an action of last resort.  A service account may
+        # not always be restorable.
+        # @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.
+        # @param [Google::Apis::IamV1::UndeleteServiceAccountRequest] undelete_service_account_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::IamV1::UndeleteServiceAccountResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::IamV1::UndeleteServiceAccountResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def undelete_service_account(name, undelete_service_account_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/{+name}:undelete', options)
+          command.request_representation = Google::Apis::IamV1::UndeleteServiceAccountRequest::Representation
+          command.request_object = undelete_service_account_request_object
+          command.response_representation = Google::Apis::IamV1::UndeleteServiceAccountResponse::Representation
+          command.response_class = Google::Apis::IamV1::UndeleteServiceAccountResponse
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Note: This method is in the process of being deprecated. Use
+        # PatchServiceAccount instead.
         # Updates a ServiceAccount.
         # Currently, only the following fields are updatable:
         # `display_name` .
@@ -1185,7 +1375,10 @@ module Google
         # @param [Boolean] show_deleted
         #   Include Roles that have been deleted.
         # @param [String] view
-        #   Optional view for the returned Role objects.
+        #   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