"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [

]>

<book id="goa" xmlns:xi="http://www.w3.org/2003/XInclude">

  <bookinfo>

    <title>GNOME Online Accounts Reference Manual</title>

    <releaseinfo>Version &version;</releaseinfo>

    <authorgroup>

      <author>

	<firstname>David</firstname>

	<surname>Zeuthen</surname>

	<affiliation>

	  <address>

	    <email>zeuthen@gmail.com</email>

	  </address>

	</affiliation>

      </author>

      <author>

	<firstname>Debarshi</firstname>

	<surname>Ray</surname>

	<affiliation>

	  <address>

	    <email>debarshir@gnome.org</email>

	  </address>

	</affiliation>

      </author>

    </authorgroup>

    <copyright>

      <year>2011 – 2017</year>

      <holder>The GOA Authors</holder>

    </copyright>

    <legalnotice>

      <para>

	Permission is granted to copy, distribute and/or modify this

	document under the terms of the <citetitle>GNU Free

	Documentation License</citetitle>, Version 1.1 or any later

	version published by the Free Software Foundation with no

	Invariant Sections, no Front-Cover Texts, and no Back-Cover

	Texts. You may obtain a copy of the <citetitle>GNU Free

	Documentation License</citetitle> from the Free Software

	Foundation by visiting 

	url="http://www.fsf.org">their Web site</ulink> or by writing

	to:

	<address>

          <street>51 Franklin Street</street>, Suite 500

          <city>Boston</city>, <state>MA</state> <postcode>02110-1335</postcode>

          <country>USA</country>

	</address>

      </para>

      <para>

	Many of the names used by companies to distinguish their

	products and services are claimed as trademarks. Where those

	names appear in any GNOME documentation, and those trademarks

	are made aware to the members of the GNOME project, the names

	have been printed in caps or initial caps.

      </para>

    </legalnotice>

  </bookinfo>

  <xi:include href="xml/goa-overview.xml"/>

  <part id="ref-dbus">

    <title>D-Bus API Reference</title>

    <chapter id="ref-dbus-overview">

      <title>Objects & Names</title>

      <sect1 id="ref-dbus-well-known-name">

        <title>The org.gnome.OnlineAccounts bus name</title>

        <para>

          The D-Bus name <literal>org.gnome.OnlineAccounts</literal>

          on the session bus is used by the GOA daemon, 

          linkend="goa-daemon.8">goa-daemon</link>. If this daemon

          isn't running, it will be started if D-Bus messages are sent

          to the name.

        </para>

      </sect1>

      <sect1 id="ref-dbus-well-known-object">

        <title>The /org/gnome/OnlineAccounts and /org/gnome/OnlineAccounts/Manager objects</title>

        <para>

          The process that owns the well-known D-Bus name 

          linkend="ref-dbus-well-known-name">org.gnome.OnlineAccounts</link>

          on the session bus (typically 

          linkend="goa-daemon.8">goa-daemon</link>) exports an object

          at the well-known path

          <literal>/org/gnome/OnlineAccounts</literal>. This object

          implements the 

          url="http://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-objectmanager">org.freedesktop.DBus.ObjectManager</ulink>

          interface and should be used by clients to discover other

          objects.

        </para>

        <para>

          One of the objects in the

          <literal>/org/gnome/OnlineAccounts</literal> hierarchy

          is an object at the path

          <literal>/org/gnome/OnlineAccounts/Manager</literal> which

          implements the 

          linkend="gdbus-interface-org-gnome-OnlineAccounts-Manager.top_of_page">org.gnome.OnlineAccounts.Manager</link>

          interface.

        </para>

      </sect1>

    </chapter>

    <chapter>

      <title>Core Interfaces</title>

      <xi:include href="../src/goa/goa-generated-doc-org.gnome.OnlineAccounts.Account.xml"/>

      <xi:include href="../src/goa/goa-generated-doc-org.gnome.OnlineAccounts.Manager.xml"/>

    </chapter>

    <chapter>

      <title>Credentials Interfaces</title>

      <xi:include href="../src/goa/goa-generated-doc-org.gnome.OnlineAccounts.OAuthBased.xml"/>

      <xi:include href="../src/goa/goa-generated-doc-org.gnome.OnlineAccounts.OAuth2Based.xml"/>

      <xi:include href="../src/goa/goa-generated-doc-org.gnome.OnlineAccounts.PasswordBased.xml"/>

    </chapter>

    <chapter>

      <title>Service-specific Interfaces</title>

      <xi:include href="../src/goa/goa-generated-doc-org.gnome.OnlineAccounts.Mail.xml"/>

      <xi:include href="../src/goa/goa-generated-doc-org.gnome.OnlineAccounts.Calendar.xml"/>

      <xi:include href="../src/goa/goa-generated-doc-org.gnome.OnlineAccounts.Contacts.xml"/>

      <xi:include href="../src/goa/goa-generated-doc-org.gnome.OnlineAccounts.Chat.xml"/>

      <xi:include href="../src/goa/goa-generated-doc-org.gnome.OnlineAccounts.Documents.xml"/>

      <xi:include href="../src/goa/goa-generated-doc-org.gnome.OnlineAccounts.Maps.xml"/>

      <xi:include href="../src/goa/goa-generated-doc-org.gnome.OnlineAccounts.Music.xml"/>

      <xi:include href="../src/goa/goa-generated-doc-org.gnome.OnlineAccounts.Photos.xml"/>

      <xi:include href="../src/goa/goa-generated-doc-org.gnome.OnlineAccounts.Printers.xml"/>

      <xi:include href="../src/goa/goa-generated-doc-org.gnome.OnlineAccounts.Files.xml"/>

      <xi:include href="../src/goa/goa-generated-doc-org.gnome.OnlineAccounts.Exchange.xml"/>

      <xi:include href="../src/goa/goa-generated-doc-org.gnome.OnlineAccounts.MediaServer.xml"/>

      <xi:include href="../src/goa/goa-generated-doc-org.gnome.OnlineAccounts.Ticketing.xml"/>

      <xi:include href="../src/goa/goa-generated-doc-org.gnome.OnlineAccounts.Todo.xml"/>

    </chapter>

  </part>

  <part id="ref-library">

    <title>Client Library API Reference</title>

    <xi:include href="xml/goaclient.xml"/>

    <xi:include href="xml/goaerror.xml"/>

    <xi:include href="xml/goaversion.xml"/>

    <chapter id="ref-library-generated">

      <title>Generated Code</title>

      <xi:include href="xml/GoaObject.xml"/>

      <xi:include href="xml/GoaObjectManagerClient.xml"/>

      <xi:include href="xml/GoaManager.xml"/>

      <xi:include href="xml/GoaAccount.xml"/>

      <xi:include href="xml/GoaOAuthBased.xml"/>

      <xi:include href="xml/GoaOAuth2Based.xml"/>

      <xi:include href="xml/GoaPasswordBased.xml"/>

      <xi:include href="xml/GoaMail.xml"/>

      <xi:include href="xml/GoaCalendar.xml"/>

      <xi:include href="xml/GoaContacts.xml"/>

      <xi:include href="xml/GoaChat.xml"/>

      <xi:include href="xml/GoaDocuments.xml"/>

      <xi:include href="xml/GoaMaps.xml"/>

      <xi:include href="xml/GoaMusic.xml"/>

      <xi:include href="xml/GoaPhotos.xml"/>

      <xi:include href="xml/GoaFiles.xml"/>

      <xi:include href="xml/GoaExchange.xml"/>

      <xi:include href="xml/GoaMediaServer.xml"/>

      <xi:include href="xml/GoaTicketing.xml"/>

      <xi:include href="xml/GoaTodo.xml"/>

      <xi:include href="xml/GoaReadLater.xml"/>

      <xi:include href="xml/GoaPrinters.xml"/>

    </chapter>

  </part>

  <part id="ref-backend-library">

    <title>Backend Library API Reference</title>

    <chapter>

      <title>Core</title>

      <xi:include href="xml/goautil.xml"/>

      <xi:include href="xml/goaprovider.xml"/>

      <xi:include href="xml/goaoauthprovider.xml"/>

      <xi:include href="xml/goaoauth2provider.xml"/>

    </chapter>

  </part>

  <part id="tools-fileformats">

    <title>Tools, File Formats and Manual Pages</title>

    <xi:include href="xml/goa-daemon.xml"/>

  </part>

  <index>

    <title>Index</title>

  </index>

  <chapter id="gio-hierarchy">

    <title>Object Hierarchy</title>

      <xi:include href="xml/tree_index.sgml"/>

  </chapter>

  <xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>

</book>