Goa – 1.0: org.gnome.OnlineAccounts.Mail D-Bus Interface
Description: Reference for Goa-1.0: org.gnome.OnlineAccounts.Mail D-Bus Interface

#### org.gnome.OnlineAccounts.Mail D-Bus Interface [src]

# org.gnome.OnlineAccounts.Mail

## Description

An account object implements this interface if it provides email-like messaging capabilities.

### Properties

### org.gnome.OnlineAccounts.Mail:EmailAddress

        EmailAddress readable s

The email address for the account or blank if there is no such address or if it isnt’ known or isn’t in a standard format.

### org.gnome.OnlineAccounts.Mail:Name

        Name readable s

`since`: 3.8.0 The full name of the user associated with `org.gnome.OnlineAccounts.Mail:EmailAddress`_.

### org.gnome.OnlineAccounts.Mail:ImapSupported

        ImapSupported readable b

Set to `TRUE` if the messages for the account can be accessed and manipulated using the IMAP protocol.

### org.gnome.OnlineAccounts.Mail:ImapAcceptSslErrors

        ImapAcceptSslErrors readable b

`since`: 3.8.0 Accept SSL/TLS errors caused by invalid certificates.

### org.gnome.OnlineAccounts.Mail:ImapHost

        ImapHost readable s

The IMAP server to use.

This may be in any of a number of recognized formats; an IPv6 address, an IPv4 address, or a domain name. A port override may be specified in the usual way with a colon. Ports may be given as decimal numbers or symbolic names (cf. the /etc/services file).

If a port override is not given, then applications should try to connect to port 993 if `org.gnome.OnlineAccounts.Mail:ImapUseSsl`_ is `TRUE` and port 143 if not.

### org.gnome.OnlineAccounts.Mail:ImapUseSsl

        ImapUseSsl readable b

`since`: 3.8.0 Whether SSL should be used.

This indicates that SSL should be used on a dedicated port.

### org.gnome.OnlineAccounts.Mail:ImapUseTls

        ImapUseTls readable b

Whether TLS should be used.

This indicates that STARTTLS should be used on a standard port after the connection has been established to obtain a secure channel.

### org.gnome.OnlineAccounts.Mail:ImapUserName

        ImapUserName readable s

The user name to use for logging in.

This may be blank if username/password authentication isn’t used or if the user name of the current user should be used.

### org.gnome.OnlineAccounts.Mail:SmtpSupported

        SmtpSupported readable b

Set to `TRUE` if the SMTP protocol can be used to send messages for the account.

### org.gnome.OnlineAccounts.Mail:SmtpAcceptSslErrors

        SmtpAcceptSslErrors readable b

`since`: 3.8.0 Accept SSL/TLS errors caused by invalid certificates.

### org.gnome.OnlineAccounts.Mail:SmtpHost

        SmtpHost readable s

The SMTP server to use.

This may be in any of a number of recognized formats; an IPv6 address, an IPv4 address, or a domain name. A port override may be specified in the usual way with a colon. Ports may be given as decimal numbers or symbolic names (cf. the /etc/services file).

If a port override is not given, then applications should try to connect to port 465 if `org.gnome.OnlineAccounts.Mail:SmtpUseSsl`_ is `TRUE` and port 587 (or 25) if not.

### org.gnome.OnlineAccounts.Mail:SmtpUseAuth

        SmtpUseAuth readable b

`since`: 3.8.0 Whether authentication is needed

This indicates whether the server uses authentication.

### org.gnome.OnlineAccounts.Mail:SmtpAuthLogin

        SmtpAuthLogin readable b

`since`: 3.12.0 Whether LOGIN authentication should be used.

This indicates whether the server uses the LOGIN SASL mechanism for SMTP.

### org.gnome.OnlineAccounts.Mail:SmtpAuthPlain

        SmtpAuthPlain readable b

`since`: 3.12.0 Whether PLAIN authentication should be used.

This indicates whether the server uses the PLAIN SASL mechanism for SMTP.

### org.gnome.OnlineAccounts.Mail:SmtpAuthXoauth2

        SmtpAuthXoauth2 readable b

`since`: 3.12.0 Whether XOAUTH2 authentication should be used.

This indicates whether the server uses the non-standard XOAUTH2 SASL mechanism for SMTP. This is implemented by GMail and Outlook.com.

### org.gnome.OnlineAccounts.Mail:SmtpUseSsl

        SmtpUseSsl readable b

`since`: 3.8.0 Whether SSL should be used.

This indicates that SSL should be used on a dedicated port.

### org.gnome.OnlineAccounts.Mail:SmtpUseTls

        SmtpUseTls readable b

Whether TLS should be used.

This indicates that STARTTLS should be used on a standard port after the connection has been established to obtain a secure channel.

### org.gnome.OnlineAccounts.Mail:SmtpUserName

        SmtpUserName readable s

The user name to use for logging in.

This may be blank if username/password authentication isn’t used or if the user name of the current user should be used.