%META:TOPICINFO{author="RumiTsekova" date="1167821222" format="1.1" version="1.1"}%
%META:TOPICPARENT{name="VirtuosoAppODS"}%

---++ODS Programmers Guide Web Services

---+++ Table of Contents

%TOC%

---+++ ODS GData Service

Virtuoso's support for the [[GData]] protocol is exposed at a higher application user lever via the ODS suite of applications. This isn't the only entry point for using GData with Virtuoso; it is simply the interface level closest to the typical user.

---++++ Search Service Endpoint Format

[[GData]] services like all web services are exposed via invocation endpoints. The ODS endpoint formats are as follows:
<verbatim>
http://host:port/dataspaces/GData/[<app-realm>[,<app-realm>]]/[-/<tag-expression>]?q=<text-query>&alt=<output-format>
</verbatim>

   * <b>text-query</b>: a string containing words to be matched against the application's searchable content
   * <b>app-realm</b>: a comma-separated list of application names for searching.  This specifies the application type, but does not scope the search to any single wiki or blog. If not specified, the search will be over all ODS applications and accounts.  The following values are supported:  'feeds', 'weblog', 'wiki', 'briefcase', 'mail', 'bookmark', 'photos', 'community', and 'news'. For example:
<verbatim>
http://host:port/dataspaces/GData?q=virtuoso, will search across ODS for content matching pattern: 'virtuoso' 

http://host:port/dataspaces/GData/weblog?q=virtuoso, will search weblog data space for content matching pattern: 'virtuoso' 

http://host:port/dataspaces/GData/weblog,feeds?q=virtuoso will search weblog and feed subscriptions data spaces content matching pattern:  'virtuoso.'
</verbatim>
   * <b>tag-expression</b>: tags connected with '|' (OR) or '/' (AND).  For example:
<verbatim>
http://host:port/dataspaces/GData/-/tag1/tag2 - will search all ODS application data having tags 'tag1' and 'tag2'
http://host:port/dataspaces/GData/-/tag1|tag2 - will search all ODS application data having tags 'tag1' or 'tag2'
http://host:port/dataspaces/GData/weblog/-/tag1|tag2 - will search weblog posts having tags 'tag1' or 'tag2'
</verbatim>
   * <b>output-format</b>: Which kind of feed format to be returned; 'atom' or 'rss'. If not given, ATOM is the default.
<verbatim>
http://host:port/dataspaces/GData/weblog?q=virtuoso&alt=rss, will return blog posts containing the word 'virtuoso' in the RSS 2.0 feed format.
http://host:port/dataspaces/GData/weblog?q=virtuoso ,  will return blog posts containing the word 'virtuoso'  in the  Atom 1.0 feed format.
</verbatim>

---++ Reference

---+++ TABLE 1: GData endpoints by application

|*Application*|*Endpoint URL*|*Detailed documentation*|
|ODS-Weblog| |ODSWeblogProgrammersGuideWebServices|
|ODS-Briefcase|http://host:port/dataspace/services/briefcase/services.wsdl |ODSBriefcaseProgrammersGuideWebServices|
|ODS-Gallery| |ODSGalleryProgrammersGuideWebServices|
|ODS-Wiki| |ODSWikiProgrammersGuideWebServices|
|ODS-Community| |ODSCommunityProgrammersGuideWebServices|
|ODS-Feed Manager| *N/A* |ODSFeedsProgrammersGuideWebServices|
|ODS-Mail| *N/A* |ODSMailProgrammersGuideWebServices|
|ODS-Bookmarks| *N/A* |ODSBookmarkProgrammersGuideWebServices|
|ODS-Discussions| |ODSDiscussionsProgrammersGuideWebServices|
|ODS-Polls| *N/A* |ODSPollsProgrammersGuideWebServices |

CategoryODS CategoryMarketing CategoryGlossary CategoryApplicationServices CategoryProgrammersGuide CategoryWebService