Account objects store off of the information that is used for making a Connection to a remote service. Mission Control can be used to establish connections for valid accounts.
Account objects have object paths of the form /org/freedesktop/Telepathy/Account/cm/proto/acct where cm is the Connection Manager name (e.g. gabble, salut) and proto is the protocol name (as used in the object path of a Connection). Account objects implement the interface org.freedesktop.Telepathy.Account.
Settings for an account are managed through D-Bus properties. To reduce D-Bus roundtrips: bulk read the properties with the standard org.freedesktop.DBus.Properties.GetAll method; bulk set properties with the org.freedesktop.Telepathy.Account.UpdateParameters method. Table 3-1 shows the properties of an Account object.
Obtaining connections and managing the online/offline status of accounts is documented in Section 5.2.1 ― From the Account Manager.
|DisplayName||String||The user-visible name of this account. This is how the account is referred to in the user interface, and should be able to be set by the user.||Jabber (firstname.lastname@example.org), Work|
|Icon||String||The name of an icon in the system's icon theme or the empty string to not specify an icon (in which case one may be automatically chosen).||im-msn|
|Enabled||Boolean||Whether or not an account is enabled (whether or not it can be used to go online). N.B. this is different from whether or not it is Valid.||True|
|Nickname||String||The nickname to set on this account for display to other contacts, as set by the user.||Bob McBadgers|
|AutomaticPresence||SimplePresence||The presence status that this account should have if it is brought online.|
|ConnectAutomatically||Boolean||Whether or not the Account Manager should automatically establish a Connection for this account.||True|
|RequestedPresence||SimplePresence||The requested presence for this account.|
|Interfaces||DBus_Interface||A list of the extra interfaces provided by this account.||org.freedesktop.Telepathy.Account.Interface.Avatar|
|Valid||Boolean||Whether this account is considered by the Account Manager to be complete and usable.||True|
|Parameters||Map||A map from connection manager parameter names (as in the ConnectionManager interface) to their values.|
|Connection||Connection||Either the object path of the Connection to this account, or the special value '/' if there is no connection.||/org/freedesktop/Telepathy/Connection/gabble/jabber/bob_40example_2ecom_2fwork|
|ConnectionStatus||integer||If the Connection property is non-empty, the status of that connection.|
|ConnectionStatusReason||integer||The reason for the last change to ConnectionStatus.|
|CurrentPresence||SimplePresence||The actual presence of the account.|
|NormalizedName||String||The normalized user ID of the local user on this account.|