OpenSocial Intro

OpenSocial’s goal: ,[object Object]

The social internet ,[object Object],[object Object],[object Object]

The social internet Some social websites...

The social internet ,[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

The social internet Many social networks...

The social internet ,[object Object],[object Object],[object Object],[object Object],[object Object]

The social internet Lots of social apps...

Need for a social API ,[object Object]

A day in the life of a social app developer

Introduction to OpenSocial ,[object Object],[object Object],[object Object],[object Object],[object Object],In China:

The OpenSocial APIs ,[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

Gadgets ,[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

Gadgets ,[object Object],[object Object],[object Object],[object Object]

Gadgets ,[object Object],[object Object],[object Object],Containers and gadget servers are both run by the social network, but do not need to be on the same machine, or even domain.

Gadgets ,[object Object],[object Object],[object Object],[object Object],<?xml version="1.0" encoding="UTF-8" ?> <Module> <ModulePrefs title="Hello World!"> <Require feature="dynamic-height" /> </ModulePrefs> <Content type="html"><![CDATA[ <h1>Hello World</h1> <style type="text/css"> h1 { color: #dd0000; } </style> <script type="text/javascript“> alert(“Hello More!”); </script> ]]> </Content></Module> Live Demo

Gadgets ,[object Object],[object Object],[object Object],[object Object],[object Object]

Gadgets ,[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],<?xml version="1.0" encoding="UTF-8" ?> <Module> <ModulePrefs title="Hello World!"> <Require feature="dynamic-height" /> </ModulePrefs> <Content type="html"> <![CDATA[ ... ]]> </Content> </Module> Live Demo

Gadgets ,[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

Gadgets ,[object Object],[object Object]

Gadgets ,[object Object],[object Object],[object Object],[object Object],<?xml version="1.0" encoding="UTF-8" ?> <Module> <ModulePrefs title="Hello World!"> <Require feature=“views" /> </ModulePrefs> <Content type="html" view="home" > <![CDATA[ ... ]]> </Content> <Content type="html" view="canvas" > <![CDATA[ ... ]]> </Content> </Module> Live Demo

Gadgets <?xml version="1.0" encoding="UTF-8" ?><Module> <ModulePrefs title="Hello Social!"> <Require feature="opensocial-0.8" /> </ModulePrefs> <Content type="html"> <![CDATA[ ... ]]> </Content> </Module> The OpenSocial JavaScript API is a gadget feature, too! Live Demo

Making Gadgets Social ,[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

The OpenSocial JavaScript API ,[object Object],[object Object]

The OpenSocial JavaScript API ,[object Object],[object Object],[object Object],[object Object],[object Object],function request() { var req = opensocial.newDataRequest(); req.add(req.newFetchPersonRequest("OWNER"), "get_owner"); req.add(req.newFetchPersonRequest("VIEWER"), "get_viewer"); req.add(req.newFetchActivitiesRequest("VIEWER"), "vactivities"); req.add(req.newFetchPersonAppDataRequest("OWNER", "*"), "odata"); ... req.send ( response );}; function response (data) { ... }; gadgets.util.registerOnLoadHandler(request);

The OpenSocial JavaScript API ,[object Object],[object Object],[object Object],[object Object],[object Object],function response(data) { if ( data.hadError() ) { if ( data.get("get_owner").hadError() ) { ... } if ( data.get("get_viewer").hadError() ) { ... } ... } var owner = data.get ( "get_owner"). getData (); var viewer = data.get( "get_viewer"). getData (); };

The OpenSocial JavaScript API Working with people: ,[object Object]

The OpenSocial JavaScript API Request one person: req.add(req.newFetchPersonRequest( idspec , opt_params ), "key"); ,[object Object],[object Object],newFetchPersonRequest responses: var owner = data.get("key").getData(); alert(owner.getDisplayName()); ,[object Object],[object Object]

The OpenSocial JavaScript API Methods available on an OpenSocial Person: ,[object Object],[object Object],[object Object],[object Object],[object Object],Live Demo

The OpenSocial JavaScript API ,[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],An OpenSocial Person's fields: ,[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

The OpenSocial JavaScript API Request many people: var idspec = opensocial.newIdSpec({ “ userId” : “OWNER”, “groupId” : “FRIENDS”}); req.add(req.newFetchPeopleRequest( idspec , opt_params ), "key"); ,[object Object],[object Object],Process the response: var owner_friends = data.get("key").getData(); owner_friends.each(function (person) { alert(person.getDisplayName()); }); ,[object Object],Live Demo

The OpenSocial JavaScript API Working with data: ,[object Object],[object Object],[object Object],[object Object]

The OpenSocial JavaScript API Set persistent data: req.add(req.newUpdatePersonAppDataRequest( idspec , key , value )); ,[object Object],[object Object],[object Object]

The OpenSocial JavaScript API Fetch persistent data: var idspec = opensocial.newIdSpec({ "userId" : "OWNER", "groupId" : "SELF" }); req.add(req.newFetchPersonAppDataRequest( idspec , keys ), "key"); req.add(req.newFetchPersonRequest("OWNER"), "ownerkey"); ,[object Object],[object Object],[object Object],newFetchPersonAppDataRequest responses: var app_data = data.get("key").getData(); var value = app_data[owner.getId()][key];

The OpenSocial JavaScript API Fetch persistent data: { "1234567890" : { "key1" : "value1" }, "2345678901" : { "key1" : "value2" } } ,[object Object],{ "1234567890" : { "key1" : "value1" } } ,[object Object],{ "1234567890" : { "key1" : "value1", "key2" : "value2" } } ,[object Object],Live Demo

The OpenSocial JavaScript API Working with activities: ,[object Object],[object Object],[object Object],orkut MySpace hi5

The OpenSocial JavaScript API Post an activity: function postActivity( text ) { var params = {}; params[opensocial.Activity.Field.TITLE] = text ; var activity = opensocial.newActivity (params); opensocial.requestCreateActivity (activity, opensocial.CreateActivityPriority.HIGH, callback); }; ,[object Object],[object Object],[object Object],Live Demo

RESTful and RPC protocols ,[object Object]

RESTful and RPC protocols ,[object Object],[object Object],[object Object],[object Object]

RESTful and RPC protocols ,[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

RESTful and RPC protocols ,[object Object],[object Object],/people/{guid}/@all ,[object Object],Example - People: /people/{guid}/@friends ,[object Object],/people/{guid}/@self ,[object Object],/people/@me/@self ,[object Object],/people/@supportedFields ,[object Object]

RESTful and RPC protocols ,[object Object],[object Object],[object Object],[object Object],fields={-join|,|field}. filterBy={fieldname} filterOp={operation}filterValue={value} updatedSince={xsdDateTime} networkDistance={networkDistance} count={count} sortBy={fieldname} sortOrder={order} startIndex={startIndex} format={format} Querystring parameters customize requests:

RESTful and RPC protocols <person xmlns=" http://ns.opensocial.org/2008/opensocial "> <id></id> <displayName></displayName> <name> <unstructured>Jane Doe</unstructured></name> <gender>female</gender> </person> REST responses (Person): {"id" : "example.org:34KJDCSKJN2HHF0DW20394", "displayName" : "Janey", "name" : {"unstructured" : "Jane Doe"}, "gender" : "female"} JSON: XML:

RESTful and RPC protocols REST responses (Person): AtomPub: <entry xmlns=" http://www.w3.org/2005/Atom "> <content type="application/xml"> <person xmlns=" http://ns.opensocial.org/20 08/opensocial "> <name> <unst ructured>Jane Doe</unstructured> </name> <gender>female</gender></person> </content> <title/> <updated>2003-12-13T18:30:02Z</updated> <author/> <id>urn:guid:example.org:34KJDCSKJN2HHF0DW20394</id> </entry>

RESTful and RPC protocols ,[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

RESTful and RPC protocols ,[object Object],[object Object],[object Object]

RESTful and RPC protocols ,[object Object],[object Object],[object Object],[object Object],POST /rpc HTTP/1.1 Host: api.example.org Authorization: <Auth token> Content-Type: application/json { "method" : "people.get", "id" : "myself" "params" : { "userid" : "@me", "groupid" : "@self" }} Example - Fetch current user: ,[object Object],HTTP/1.x 207 Multi-Status Content-Type: application/json { "id" : "myself" "result" : { "id" : "example.org:34KJDCSKJN2HHF0DW20394", "name" : { "unstructured" : "Jane Doe"}, "gender" : "female" }} ,[object Object]

RESTful and RPC protocols Authentication: Both protocols use OAuth to identify users and apps. Depending on what the application needs to do, it can use two-legged or three-legged OAuth. ,[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

RESTful and RPC protocols ,[object Object],[object Object],Sample: Login, get thumbnail and friends. OpenSocialClient c = new OpenSocialClient("myspace.com"); c.setProperty(OpenSocialClient.Properties.REST_BASE_URI, "http://api.myspace.com/v2/"); c.setProperty(OpenSocialClient.Properties.CONSUMER_SECRET, <MYSPACE_SECRET>); c.setProperty(OpenSocialClient.Properties.CONSUMER_KEY, <MYSPACE_APP_KEY>); c.setProperty(OpenSocialClient.Properties.VIEWER_ID, <YOUR_MYSPACE_ID>); OpenSocialPerson p = c.fetchPerson(<YOUR_MYSPACE_ID>); OpenSocialField f = p.getField("thumbnailUrl"); System.out.println(f.getStringValue()); Collection<OpenSocialPerson> friends = c.fetchFriends(<YOUR_MYSPACE_ID>); for (OpenSocialPerson friend : friends) { System.out.println(friend.getDisplayName()); }

OpenSocial Intro

Recommended

Recommended

More Related Content

What's hot

What's hot (20)

Similar to OpenSocial Intro

Similar to OpenSocial Intro (20)

More from Pamela Fox

More from Pamela Fox (20)

Recently uploaded

Recently uploaded (20)

OpenSocial Intro