diff options
author | Xavier Claessens <xavier.claessens@collabora.co.uk> | 2012-05-08 11:12:28 +0200 |
---|---|---|
committer | Xavier Claessens <xavier.claessens@collabora.co.uk> | 2012-05-09 14:59:34 +0200 |
commit | 38151925c854b2051ddf6118d882457c806c897f (patch) | |
tree | 442bd9b32d64891092f02e9e9bb8123800546ea0 /spec | |
parent | 542bbe9e034e63ba0ffc54d703367689bdc061da (diff) | |
download | telepathy-glib-38151925c854b2051ddf6118d882457c806c897f.tar.gz |
Update Connection.Interface.Contacts spec
Diffstat (limited to 'spec')
-rw-r--r-- | spec/Connection_Interface_Contacts.xml | 58 |
1 files changed, 58 insertions, 0 deletions
diff --git a/spec/Connection_Interface_Contacts.xml b/spec/Connection_Interface_Contacts.xml index 1020190d4..748933aa6 100644 --- a/spec/Connection_Interface_Contacts.xml +++ b/spec/Connection_Interface_Contacts.xml @@ -186,6 +186,64 @@ <tp:error name="org.freedesktop.Telepathy.Error.Disconnected"/> </tp:possible-errors> </method> + + <method name="GetContactByID" + tp:name-for-bindings="Get_Contact_By_ID"> + <tp:added version="0.UNRELEASED"/> + <tp:docstring> + Return any number of contact attributes for the given identifier. + <tp:rationale> + This is for a single identifier to make it simpler to use for the most + common use case. For multiple contacts case, + <tp:member-ref>GetContactAttributes</tp:member-ref> should be used. + </tp:rationale> + </tp:docstring> + + <arg direction="in" name="Identifier" type="s"> + <tp:docstring> + An identifier representing a contact. + </tp:docstring> + </arg> + + <arg direction="in" name="Interfaces" type="as" + tp:type="DBus_Interface[]"> + <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> + <p>A list of strings indicating which D-Bus interfaces the calling + process is interested in. All supported attributes from these + interfaces, whose values can be obtained without additional network + activity, will be in the reply.</p> + <p>See <tp:member-ref>GetContactAttributes</tp:member-ref> for + details.</p> + </tp:docstring> + </arg> + + <arg direction="out" name="Handle" type="u" tp:type="Contact_Handle"> + <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> + <p>The contact's handle, as returned by <tp:dbus-ref + namespace="ofdT.Connection">RequestHandles</tp:dbus-ref></p> + </tp:docstring> + </arg> + + <arg direction="out" type="a{sv}" name="Attributes" + tp:type="Single_Contact_Attributes_Map"> + <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> + <p>All supported attributes of the contact on + the given interfaces that can be returned without network + round-trips. If contact attributes are not immediately known, the + behaviour is defined by the interface; the attribute should either + be omitted from the result or replaced with a default value.</p> + + <p>The contact's attributes will always include at least the + identifier that would be obtained by inspecting the handle + (<code>org.freedesktop.Telepathy.Connection/contact-id</code>).</p> + </tp:docstring> + </arg> + + <tp:possible-errors> + <tp:error name="org.freedesktop.Telepathy.Error.Disconnected"/> + <tp:error name="org.freedesktop.Telepathy.Error.InvalidHandle"/> + </tp:possible-errors> + </method> </interface> </node> <!-- vim:set sw=2 sts=2 et ft=xml: --> |