OpenSocial API 概述

本文翻译自http://code.google.com/apis/opensocial/docs/

我们可以通过两种方法访问 OpenSocial API ：在客户端可以使用JavaScript；在服务器端可以使用RESTful API。

JavaScript API

JavaScript API 集中于 opensocial.* namespace ，它提供了三个方面的功能：

• People -- 关于个人信息和人们之间的关系
• Activities -- 使我们能够查看并编辑人们的活动的更新情况
• Persistence -- 通过一个简单的键-值存储结构，使应用程序无需与服务器频繁交互(a simple key-value data store to allow server-free stateful applications)。

使用JavaScript API，我们可以达到以下目的：

• 无需维护自己的服务器即可构建自己的应用程序
• 构建包含服务器端组件(用于离线处理，或访问其他网站)的应用程序
• 构建全新的应用程序
• 在已有的SNS网站内容中使用现有的Web Applications
• 向已有的Google Gadgets中添加社交功能
• 构建能在不同的SNS网站中运行的应用程序

JavaScript API 使用的是标准的 Web 技术：

• 在opensocial.* namespace 中封装了一系列方法
• 可以使用任意的标准 JavaScript 程序设计技术，以及第三方提供的 JavaScript 库
• 为了支持富 AJAX 交互，该 JavaScript API 包含了一整套非同步回调机制

RESTful Data APIs

RESTful Data APIs 提供了与 JavaScript API 互补的功能，使我们能够在自己的服务器上访问people, activities，以及其他数据。

RESTful data APIs 也使用了标准的 Web 技术：

• 服务器间基于 RESTful AtomPub 协议进行交互
• 通过 OAuth 进行用户验证