OpenSocial API ドキュメント

OpenSocial API は、複数のウェブサイトでソーシャル アプリケーションを作成する一連の共通 API です。OpenSocial API へアクセスする方法には、クライアント側で JavaScript API を使用する方法と、サーバー側で RESTful Data API を使用する方法の 2 種類あります。

JavaScript API

JavaScript API は opensocial.* namespace にあり、次の 3 つの主要な機能領域にアクセスします。

• People - 個人および個人同士の関係についての情報
• Activities -- 個人の行動を投稿したり、最新情報を参照したりする機能
• Persistence - サーバー不要のステートフルなアプリケーションを実現する、シンプルなキー値データ ストア

JavaScript API を使用すると、以下のような作業を行えます。

• サーバー保守が不要なアプリケーションを作成します。
• サーバー側のコンポーネント (オフライン処理や他のウェブサイトからのアクセス用) が組み込まれたアプリケーションを作成します。
• 新しいアプリケーションを作成します。
• 既存のウェブ アプリケーションを、既存のソーシャル ウェブサイトのコンテキストに公開します。
• 既存の Google ガジェットにソーシャル機能を追加します。
• 複数の異なるソーシャル ウェブサイトのコンテキストで動作するアプリケーションを作成します。

JavaScript API は、標準的なウェブ テクノロジーを使用するように設計されています。

• opensocial.* 名前空間にパッケージ化されています。
• 標準的な JavaScript のプログラミング技術とサードパーティ製のライブラリを使用できます。
• AJAX の豊富なインタラクティブ性をサポートする、完全な非同期コールバック システムが組み込まれています。

OpenSocial JavaScript API を使用してアプリケーションを作成するには、スタート ガイド を参照するか、OpenSocial チュートリアル で作成方法を学んでください。

RESTful Data API

RESTful Data API は JavaScript API を補完して、People、Activities、サーバーにあるデータにアクセスできる機能を提供します。

また、RESTful Data API は、標準のウェブ テクノロジーを使用するように作られています。

• サーバー間の通信は、RESTful AtomPub プロトコルに基づきます。
• 認証は OAuth で処理されます。