OpenSocial Code Samples

Welcome, guest Sign In

My Projects
Tools & Services
APIs and Services
- Flickr
- Geo
- Mail
- Search
- Social
- Updates
- YAP
- YQL
Developer Tools
- Hadoop
- YUI
- YSlow
- View all »
Resources
- Blog
- YDN Theater
- Hack U

YDN OpenSocial Code Samples

Prev — Differences Between the 0.7 and 0.8 JavaScript APIs

Chapter 10. Code Examples — Next

OpenSocial Code Samples

The following code samples demonstrate how you might make OpenSocial calls in the Canvas view of a Yahoo! Open Application.

Activities Demo

<script type="text/javascript">

function getViewerActivities() {

var idSpec = opensocial.newIdSpec();
    idSpec.setField(opensocial.IdSpec.Field.USER_ID, opensocial.IdSpec.PersonId.VIEWER);

var req = opensocial.newDataRequest();
    req.add(req.newFetchActivitiesRequest(idSpec), 'activities');
    req.add(req.newFetchPeopleRequest(idSpec), 'people');
    req.send(onLoadViewerActivities);

}

function getViewerFriendsActivities() {

var idSpec = opensocial.newIdSpec();
    idSpec.setField(opensocial.IdSpec.Field.USER_ID, opensocial.IdSpec.PersonId.VIEWER);
    idSpec.setField(opensocial.IdSpec.Field.NETWORK_DISTANCE, 1);

}

function onLoadViewerFriendsActivities(response) {

var html = processResponse(response);

document.getElementById('yap-activity-viewer-friends').innerHTML = html;

}

function onLoadViewerActivities(response) {

var html = processResponse(response);

document.getElementById('yap-activity-viewer').innerHTML = html;

}

function processResponse(response) {

var activities = response.get('activities').getData();
    var people = response.get('people').getData();

return html.join('');

}

gadgets.util.registerOnLoadHandler(function() {
    postActivity();
    getViewerActivities();
    getViewerFriendsActivities();
});

</script>

#yap-status div, .yap-notice, .yap-error {
    background: #ffc;
    padding: 5px 15px 5px;
    margin-bottom: 3px;
}

.yap-error {
    font-style: italic;
    background: #fcc;
}

ul {
    list-style: none;
}

li {
    padding: 3px;
    border: 1px solid #ccc;
    margin-bottom: 3px;
}
</style>

<h1>YAP OpenSocial Activities Demo</h1>

<div id="yap-status">
<div>Posting a sample activity...</div>
</div>

<h3>Your Recent Updates</h3>
<div id="yap-activity-viewer">
<div class="yap-notice">Loading...</div>
</div>

<h3>Your Friend's Recent Updates</h3>
<div id="yap-activity-viewer-friends">
<div class="yap-notice">Loading...</div>
</div>

</div>

Gifts Demo

<!-- 
    A sample YAP 1.0 ready OpenSocial application.
    Adapted from http://code.google.com/apis/opensocial/articles/tutorial/tutorial-0.7.html

Updated for OpenSocial 0.8 and the Yahoo! Application Platform by Reid Burke 5 Sep 2008
    YAP or 0.8 specific comments are annotated with YAPNOTE
    Updated 27 Oct 2008
-->
<script type="text/javascript">

// Original JS code: http://opensocial-resources.googlecode.com/svn/samples/tutorial/tags/api-0.7/gifts_5_streams.js

var globalGivenGifts = {};
var globalViewer = {};
var globalFriends = {};

// YAPNOTE: You may store up to 1K of data per AppData key, up to 1MB total.
// Currently, using gadgets.json.stringify will include properties attached to objects used by Caja
// which take up several hundred bytes. This is a known issue we are working on.
// In this example, we will use a simple comma-seperated format for storing data in a
// single AppData key to save storage space.
function serializeGifts(obj) {
  var out = new Array();
  for (var id in obj) {
    if (id.substr(-3) !== '___') { 
      continue; // YAPNOTE: Skip Caja properties, which always end with a triple underscore
    }
    out.push(id);
    out.push(obj[id]);
  }
  return out.join(',');
}

function updateReceivedList(viewer, data, friends) {
  var viewerId = viewer.getId();
  
  var options = ['a cashew nut', 'a peanut', 'a hazelnut', 'a red pistachio nut'];
  
  var html = new Array();
  html.push('You have received:<ul>');
  friends.each(function(person) {
    var personData = data[person.getId()];
    if (personData) {
      var json = data[person.getId()]['gifts'];

// YAPNOTE: You must be very careful to create well-formed JavaScript when working with Caja.
      // Missing semicolons are a source of common problems, such as this line: 
      //   var gifts = {}
      // should be
      var gifts = {};

if (!json) {
        gifts = {};
      }
      try {
        gifts = unserializeGifts(gadgets.util.unescapeString(json));
      } catch (e) {
        gifts = {};
      }
    
      // YAPNOTE: Be sure to use 'var' whenever appropiate when working in Caja
      // Therefore, this code: 
      //    for (i in gifts) {
      // should be:
      for (var i in gifts) {
        // YAPNOTE: We use alphanumeric GUIDs, so the +i > 0 check should be removed
        // This line:
        //    if (+(i) > 0 && i == viewerId) {
        // should be simply:
        if (i == viewerId) {
          html.push('<li>' + options[gifts[i]] + ' from ' + person.getDisplayName() + '</li>');
        }
      }
    }
  });
  html.push('</ul>');
  document.getElementById('received').innerHTML = html.join('');
}

console.log(globalGivenGifts);

function giveGift() {
  var nut = document.getElementById('nut').value;
  var friend = document.getElementById('person').value;
  
  globalGivenGifts[friend] = nut;
  var json = serializeGifts(globalGivenGifts);
  
  var req = opensocial.newDataRequest();

// YAPNOTE: DataRequest.PersonId is now IdSpec.PersonId in 0.8
  // Therefore, this code:
  //    req.add(req.newUpdatePersonAppDataRequest(opensocial.DataRequest.PersonId.VIEWER, 'gifts', json));
  // is now:
  req.add(req.newUpdatePersonAppDataRequest(opensocial.IdSpec.PersonId.VIEWER, 'gifts', json));

// YAPNOTE: For Person requests, specify a string ID as the first argument:
  //    req.add(req.newFetchPersonRequest('VIEWER'), 'viewer');
  // Although that code would work, the semantically correct way is to use IdSpec.PersonId when possible:
  req.add(req.newFetchPersonRequest(opensocial.IdSpec.PersonId.VIEWER), 'viewer');

// YAPNOTE: For fetch People and AppData requests, specify an IdSpec object (not a string ID) as the first argument.
  // In 0.7, VIEWER_FRIENDS is no longer available. Instead, use NETWORK_DISTANCE
  // Therefore, this code:
  //   req.add(req.newFetchPeopleRequest('VIEWER_FRIENDS'), 'viewerFriends');
  //   req.add(req.newFetchPersonAppDataRequest('VIEWER', 'gifts'), 'data');
  //   req.add(req.newFetchPersonAppDataRequest('VIEWER_FRIENDS', 'gifts'), 'viewerFriendData');
  // is now:
  var idSpec = opensocial.newIdSpec();
  idSpec.setField(opensocial.IdSpec.Field.USER_ID, opensocial.IdSpec.PersonId.VIEWER);
  var idSpecFriends = opensocial.newIdSpec();
  idSpecFriends.setField(opensocial.IdSpec.Field.USER_ID, opensocial.IdSpec.PersonId.VIEWER);
  idSpecFriends.setField(opensocial.IdSpec.Field.NETWORK_DISTANCE, 1); // YAPNOTE: Groups aren't supported in YAP v1. If you don't specify one, we assume you want friends

req.add(req.newFetchPeopleRequest(idSpecFriends), 'viewerFriends');
  req.add(req.newFetchPersonAppDataRequest(idSpec, 'gifts'), 'data');
  req.add(req.newFetchPersonAppDataRequest(idSpecFriends, 'gifts'), 'viewerFriendData');

req.send(onLoadFriends);
  
  postActivity(nut, friend);
}

function makeOptionsMenu() {
  var options = ['a cashew nut', 'a peanut', 'a hazelnut', 'a red pistachio nut'];
                 
  var html = new Array();
  html.push('<select id="nut">');
  for (var i = 0; i < options.length; i++) {
    html.push('<option value="' + i + '">' + options[i] + '</option>');
  }
  html.push('</select>');
  document.getElementById('gifts').innerHTML = html.join('');
}

function loadFriends() {
  var req = opensocial.newDataRequest();

req.send(onLoadFriends);
}

function onLoadFriends(data) {
  var viewer = globalViewer = data.get('viewer').getData();
  var viewerFriends = data.get('viewerFriends').getData();
  var giftData = data.get('data').getData();
  var viewerFriendData = data.get('viewerFriendData').getData();
  var friends = new Array();

// YAPNOTE: Be sure to use 'var' whenever appropiate when working in Caja
  // Therefore, this code: 
  //    html = new Array();
  // should be:
  var html = new Array();
  html.push('<select id="person">');
  viewerFriends.each(function(person) {
    html.push('<option value="' + person.getId() + '">' + person.getDisplayName() + "</option>");
    
    friends[person.getId()] = person.getDisplayName();
  });
  html.push('</select>');
  document.getElementById('friends').innerHTML = html.join('');
  
  globalFriends = friends;
  updateGiftList(viewer, giftData, friends);
  updateReceivedList(viewer, viewerFriendData, viewerFriends);
}

function init() {
  loadFriends();
  makeOptionsMenu();
}

gadgets.util.registerOnLoadHandler(init);
</script>

#yap-status div, .yap-notice, .yap-error {
    background: #ffc;
    padding: 5px 15px 5px;
    margin-bottom: 3px;
}

.yap-error {
    font-style: italic;
    background: #fcc;
}

ul {
    list-style: none;
}

li {
    padding: 3px;
    border: 1px solid #ccc;
    margin-bottom: 3px;
}
</style>

<div id='yap-app'>
<h1>Gift Giving!</h1>
<div id='give'>
<form id='gift_form'>


Give <span id='gifts'></span> to <span id='friends'></span>. <a href="#" onclick='giveGift();'>Give!</a>
</form>
</div>
<div id='given'></div>


<div id='received'></div>
</div>

OpenSocial Code Samples

Activities Demo

Gifts Demo

Table of Contents