アンケートに答える (英語) | 日本語 | サイト ディレクトリ
注意: 一部のページは英語でのみご利用いただけます。

Orkut 用のソーシャル アプリケーションを作成する

Orkut デベロッパー ガイド

(OpenSocial API v0.7)

このガイドでは、orkut 環境でのアプリケーションの構築と管理について説明します。対象読者としては、orkut、ガジェット API、JavaScript について一般的な知識を備えたデベロッパーを想定していますが、必要と思われる箇所では参照情報へのリンクを示します。

Orkut は更新されており、現時点ではバージョン 0.7 の OpenSocial API をサポートしています。このドキュメントにも、更新による変更点が反映されています。New! や Updated! がついている箇所は、コーディング方法が以前のバージョンから変更されたことを表します。

目次

  1. Orkut 環境のアプリケーションについて
    1. Orkut アプリケーションの用語
    2. Orkut アプリケーションの構造
    3. 初めての orkut アプリケーションを作成する
    4. Orkut にアプリケーションをインストールする
    5. Orkut のアプリケーション XML キャッシュをバイパスする
  2. OpenSocial アプリケーション
    1. Orkut クエリストリング パラメータ
    2. 現在のアプリケーション ビューを識別する
    3. Orkut で使用できるビュー
    4. 別のビューに移動する
    5. アプリケーションの ID を取得する
    6. requestNavigateTo() を使用してアプリケーションにデータを渡す
    7. クエリストリングを使用してアプリケーションにデータを渡す
    8. ユーザーの orkut UID を取得する
    9. アプリケーション内のページにリンクする
  3. アクティビティ ストリーム
    1. Orkut のアクティビティ ストリーム ポリシー
  4. プロフィール データ
    1. Orkut のプロフィール データ ポリシー
    2. プロフィール フィールドの一覧
  5. スクラップ拡張アプリケーション
  6. 関連情報

Orkut 環境のアプリケーションについて

アプリケーションの開発手法は、OpenSocial コンテナごとに異なります。このセクションでは、orkut で使用するアプリケーションの開発プロセスについて説明します。

Orkut アプリケーションの用語

このドキュメントでは、orkut での開発手法に関連し、以下の用語を使用します。

アクティビティ ストリーム ある個人からのアクティビティを格納するデータ フィードです。
アプリケーション ガジェットや OpenSocial API を使用して orkut の機能を拡張するサードパーティ コードです。
アプリケーション定義 アプリケーションを定義する XML ファイルです。その構文はガジェット XML に基づいしており、「ガジェット スペック」とも呼ばれます。
アプリケーション ディレクトリ 使用できるアプリケーションの一覧が表示されます。
アプリケーション設定ページ ユーザーがインストールしたアプリケーションの一覧が表示されます。ユーザー自身が、アプリケーションを追加したり削除したりできます。
キャンバス ビュー New! アプリケーションをページ全体に表示するビューです。
左ナビゲーション バー Orkut ページの左側にある、リンクをまとめたバーです。左ナビゲーション バーには、orkut のホームページにログインしているユーザーの一覧が表示されます。ここに、友だちのプロフィールを表示することもできます。
左ナビゲーション リンク 左ナビゲーション バー上のリンクです。他の orkut セクション (たとえばプロフィール) や、OpenSocial アプリケーションのキャンバス ページにリンクできます。
プロフィール ビュー New! ユーザーのプロフィールを表示するアプリケーションのビューです。
ビュー New! アプリケーションを表示する場所です。Orkut では、アプリケーションをキャンバス ビューまたはプロフィール ビューに表示できます。バージョン 0.6 では、ビューのことを「サーフェス」と呼んでいました。

Orkut アプリケーションの構造

Orkut 用のアプリケーションを構築する前に、orkut の新しいアプリケーション プラットフォームについて理解しておくことをお勧めします。Orkut アプリケーションの構造では、orkut でアプリケーションをホストするために追加されたすべての拡張について、サンプルに沿って分かりやすく説明しています。

初めての orkut アプリケーションを作成する

初めて OpenSocial アプリケーションを作成する場合は、Orkut 用 OpenSocial チュートリアルの手順にそって作業することで、OpenSocial API についての理解を深めることができます。このチュートリアルでは、OpenSocial API を使用して単純なギフト贈呈アプリケーションを開発する手順を説明しています。

New! Google ガジェット作成ツールでアプリケーションをホストする

ガジェット XML ファイルを格納するサーバーにアクセスできない場合は、Google ガジェット作成ツールを使用すると、ガジェットをすばやく編集してホストできます。たとえば、「Hello World」アプリケーションをすばやく作成したければ、Google アカウントにログインし (ログインしていないとガジェットを保存できません)、ガジェット作成ツールに次のコードを貼り付けます。 

<?xml version="1.0" encoding="UTF-8" ?>
<Module>
  <ModulePrefs title="Hello World!">
    <Require feature="opensocial-0.7" />
  </ModulePrefs>
  <Content type="html">
    <![CDATA[
      Hello, world!
    ]]>
  </Content>
</Module>

作成したアプリケーションの XML ファイルを開くには、ガジェット作成ツールの右上に表示されているファイル名をクリックします。

ガジェットの XML ファイルへのリンク

これにより、アプリケーション XML がブラウザに表示されます。次のセクションでアプリケーションをインストールする際に、このファイルの URL が必要になります。

ブラウザで表示されるようにアプリケーションの XML が表示される

Google ガジェット作成ツールのプレビュー モードは、ソーシャル アプリケーションでは機能しないことに注意してください。Orkut でコードを動作させるには、上の方法でアプリケーションの URL を取得し、次のセクションの説明にそって操作してください。

Updated Orkut にアプリケーションをインストールする

アプリケーションからソーシャル ネットワーク データにアクセスするには、アプリケーションをコンテナ内部で実行する必要があります。Orkut にはデベロッパー サンドボックスが用意されており、ここから OpenSocial API やその他の新機能にアクセスできます。http://sandbox.orkut.com にアクセスできない (たとえば、サンドボックスにアクセスしようとすると http:/www.orkut.com にリダイレクトされる) 場合は、使用している Orkut アカウントをデベロッパーとしてホワイトリストに登録する必要があります。Orkut Sandbox では、サンドボックスのホワイトリストに登録されている友だちのデータしか返されないため、何人かのデベロッパーを友だちとして登録し、テスト データを得るとよいかもしれません。OpenSocial デベロッパー フォーラムのこのスレッドとこの Orkut コミュニティを利用すると、友だちのネットワークを広げることができます。

[アプリケーションを追加] リンク

Orkut Sandbox 内部でアプリケーション ページに移動するには、Orkut の左ナビゲーション バーの [アプリケーションを追加] をクリックするか、 http://sandbox.orkut.com/MyApps.aspx にアクセスします。

サンプルを初めて実行した場合、[マイ アプリケーション] は空の状態ですが、[URL を指定してアプリケーションを追加:] と表示されているはずです。

アプリケーション ページのアプリケーション追加セクション

このフィールドに作成したアプリケーションの URL を貼り付け、[アプリケーションを追加] ボタンをクリックします。

New! アプリケーションの情報ページが表示されます。このページには、アプリケーションに対する他のユーザーからの評価やコメントが表示されます。このページにも [アプリケーションを追加] ボタンが表示されています。このボタンをクリックすると、このアプリケーションのプロフィールへの追加処理が始まります。

アプリケーションの情報ページ

[アプリケーションの追加を承認] ページが表示されます。このページには、インストール時にこのアプリケーションに付与できる権限の一覧が表示されます。現時点で付与できる権限は以下のとおりです。

1.) プロフィール情報と友だちのリストへのアクセスを許可する2.) 左側のナビゲーション バーにリンクを表示する3.) プロフィール ページにガジェットを表示する4.) オプション - アクティビティ ストリームに情報を登録する

一部の権限は、アプリケーションを正常に機能させるために必ず付与しなければなりません。しかし、アクティビティ ストリームへの登録を許可するかどうかなど、付与するかどうかを選択できる権限もあります。アプリケーションに付与する権限は、オプション権限の横にあるチェックボックスをオンにします。

これらの権限を付与し、アプリケーションをプロフィールにインストールするには、[アプリケーションを追加] ボタンをクリックします。ページ上の一覧にサンプル アプリケーションが追加され、左のナビゲーション バーにアプリケーションへのリンクが表示されます。

新しくインストールしたアプリケーションがアプリケーション ページとサイドバーに表示される

この時点で、左ナビゲーション バーの [プロフィール] をクリックすると、その Orkut のプロフィール ビューに実行中のアプリケーションが表示されます。また、ナビゲーション バーのアプリケーション名をクリックすると、そのアプリケーションのキャンバス ビューに直接移動できます。

New! 複数のアプリケーションを追加すると、[マイ アプリケーション] ビューの各アプリケーション名の横に矢印が表示されます。これらの矢印をクリックすると、プロフィールに表示するアプリケーションの順序を変更できます。プロフィールに表示されるのは上から 3 つのみのため、プロフィールに表示したいアプリケーションを最上部に配置するようにしてください。

インストールされているアプリケーションを 3 つ以上表示する

Updated Orkut のアプリケーション XML キャッシュをバイパスする

Orkut は、OpenSocial アプリケーション XML をキャッシュして各ファイルのフェッチ回数を抑えることで、帯域幅を節約し、ユーザーの待ち時間を短縮しています。キャッシュは、たくさんのユーザーが同じアプリケーションを要求する状況では有効です。しかし、アプリケーションの開発において、コードを更新してすぐに変更を確認したい場合は、キャッシュが邪魔になることがあります。

このキャッシュ処理を無効にするには、プロフィール ページやアプリケーション キャンバス ページの URL に &bpc=1 を追加します。この「キャッシュ バイパス」パラメータは、orkut がガジェット XML を取得する際に、キャッシュに保持されているバージョンではなく、サーバーから最新バージョンを取得するよう指示するものです。

たとえば、次の URL を表示するとします。

http://sandbox.orkut.com/Application.aspx?uid=XXXXXXXXXXXX&appId=XXXXXXXX

キャッシュをバイパスしたい場合は、これを次のように変更します。

http://sandbox.orkut.com/Application.aspx?uid=XXXXXXXXXXXX&appId=XXXXXXXX&bpc=1

なお、bpc=1 パラメータによって無効にできるのは XML のキャッシュだけです。外部の JavaScript ファイルにリンクしている場合や、gadgets.io.makeRequest の呼び出しを使用している場合のキャッシュは無効になりません。makeRequest キャッシュをバイパスする方法については、opensocial-resources wiki をご覧ください。

&bpc=1 パラメータを指定せずにページを表示しているユーザーは、orkut によってキャッシュが更新されるまでは、新たにページに加えられた変更を表示することができません。このような現象は、通常は変更を加えてから 1 時間以上経過すると解消します。

OpenSocial アプリケーション

ここまで、アプリケーションのインストールと更新の基本について説明しました。ここでは、orkut で堅牢なソーシャル アプリケーションを構築するためのヒントと注意点について説明します。

OpenSocial アプリケーションは、ガジェット技術をベースとした新しいタイプのアプリケーションですが、OpenSocial API をサポートするウェブサイト (コンテナともいいます) から取得したソーシャル データを処理することも可能です。Orkut は OpenSocial コンテナの一例です。このセクションでは、OpenSocial アプリケーションの開発 (特に orkut 環境での開発) を中心に説明します。

Updated Orkut クエリストリング パラメータ

Orkut には、いくつかのクエリストリング パラメータが用意されており、アプリケーションを実行しているコンテキストに関する追加データを入手できます。これらのパラメータは、window.location.href を使用して手動で解析するか、ガジェット便宜関数 gadgets.util.getUrlParameters() を使用して解析できます。次の表に、使用できるパラメータと値の例を示します。

名前 取得方法 値の例
国 gadgets.util.getUrlParameters()["country"] US
言語 gadgets.util.getUrlParameters()["lang"] en-US
オーナー ID gadgets.util.getUrlParameters()["gadgetOwner"] 12345678901234567890
ビューア ID [1] gadgets.util.getUrlParameters()["gadgetViewer"] 12345678901234567890
親 URL gadgets.util.getUrlParameters()["parent"] http://sandbox.orkut.com
ガジェット URL gadgets.util.getUrlParameters()["url"] http://example.com/gadget_specification.xml
ビュー名 gadgets.util.getUrlParameters()["view"] キャンバス
ビュー パラメータ gadgets.util.getUrlParameters()["view-params"] {"foo":12345,"bar":"Bar value"}

[1] ビューアにガジェットがインストールされている場合のみ取得できます。

Updated 現在のアプリケーション ビューを識別する

Orkut では、アプリケーションをキャンバス ビューとプロフィール ビューに表示できます。現在のビューを取得する最も簡単な方法は、アプリケーションのモジュール設定に「views」機能を追加する方法です。

  <ModulePrefs title="Views example"> 
    <Require feature="views" />
  </ModulePrefs>

views 機能が追加されていると、次のように gadget.util.getCurrentView() 関数を呼び出すことで、現在のビューを取得できます。これにより、gadgets.views.View オブジェクトが current_view 変数に割り当てられます。この呼び出しによって返される可能性のあるビューの一覧については、Orkut で使用できるビューをご覧ください。

次のサンプルは、現在のビューを取得し、返された値に応じて実行するコードを変更する方法を示しています。

  function getViewName() {
    return gadgets.views.getCurrentView().getName();
  }

  if (getViewName() == "canvas") {
    /* Do canvas specific stuff here */
  }

  if (getViewName() == "profile") {
    /* Do profile specific stuff here */
  }

Updated Orkut で使用できるビュー

このセクション内のコードを使用するには、アプリケーションの ModulePrefs セクションに <Require feature="views"> を含めてください。

gadgets.views.getSupportedViews() 関数を呼び出して、使用可能な View オブジェクトを取得します。 

  var supported_views = gadgets.views.getSupportedViews();

getSupportedViews を呼び出すと返されるオブジェクトには、orkut で使用できるすべてのビューを表す gadgets.views.View オブジェクトが、ビュー名でインデックス化された状態で格納されています。

現時点では以下のとおりです。

名前 取得するコード 表示できる唯一のガジェットか
キャンバス supported_views["canvas"] true
プロフィール supported_views["profile"] false
デフォルト supported_views["default"] false

それぞれのビューは、orkut の各ページに対応しています。

  • profile は、ユーザーのプロフィール ビューに対応しています。プロフィール URL は次のようになります。 
    http://sandbox.orkut.com/Profile.aspx?uid=#####
  • canvas は、アプリケーションを最大化したビューに対応しています。キャンバス URL は次のようになります。 
    http://sandbox.orkut.com/Application.aspx?uid=#####&appId=#####
  • default は、どの orkut ビューにも対応していません。このビューは、ガジェットの使用に定義されている複数コンテンツ セクション機能に対応するためのビューです。このビューは、ナビゲーションには使用しないでください。

名前でビューを要求する代わりに、ViewType オブジェクトを使用してビューを取得することもできます。この方法では、ビューの名前を指定することなく、特定のプロパティを備えたビューを取得できます。

次の表に、ViewType の使用方法と、それぞれが orkut のどのビューに対応しているかを示します。

名前 取得するコード 対応する orkut ビュー
DASHBOARD supported_views[gadgets.views.ViewType.DASHBOARD] プロフィール
FULL_PAGE supported_views[gadgets.views.ViewType.FULL_PAGE] キャンバス
POPUP 非対応 非対応 [1]

[1] POPUP は、どの orkut ビューにも対応していません。

Updated 別のビューに移動する

このセクション内のコードを使用するには、アプリケーションの ModulePrefs セクションに <Require feature="views"> を含めてください。

別のビューへのリンクを提供したい場合は、gadgets.views.requestNavigateTo() メソッドに gadgets.views.View オブジェクトを渡す必要があります。Orkut で使用できるビューで説明したように、getSupportedViews() の呼び出しによって返されるいずれかのオブジェクトを使用することも可能です。次に、このメソッドのサンプル コードを示します。

  function navigateTo(dest) {
    var supported_views = gadgets.views.getSupportedViews();
    gadgets.views.requestNavigateTo(supported_views[dest]);
  };

  /**
   * When called, this method asks the container to switch to the canvas
   */
  function gotoCanvas() {
    navigateTo("canvas");
  };

  /**
   * When called, this method asks the container to switch to the profile
   */
  function gotoProfile() {
    navigateTo("profile");
  };

別の方法としては、新しい View オブジェクトを手作業で作成し、それを使用してナビゲーションを開始することもできます。次のサンプル コードでは、新しい gadgets.views.View オブジェクトを作成し、gadgets.views.requestNavigateTo() メソッドに渡しています。

  /**
   * When called, this method asks the container to switch to the canvas
   */
  function gotoCanvas() {
    var canvas_view = new gadgets.views.View("canvas");
    gadgets.views.requestNavigateTo(canvas_view);
  };

  /**
   * When called, this method asks the container to switch to the profile
   */
  function gotoProfile() {
    var profile_view = new gadgets.views.View("profile");
    gadgets.views.requestNavigateTo(profile_view);
  };

Updated アプリケーションの ID を取得する

Orkut では、次の呼び出しを使用して、アプリケーションの ID 番号を取得できます。

  var application_id = gadgets.util.getUrlParameters()["gadgetId"];

上に示したスニペットを実行すると、アプリケーションの orkut URL 内の appId パラメータと同じ値が application_id に格納されます。

Updated requestNavigateTo() を使用してアプリケーションにデータを渡す

このセクション内のコードを使用するには、アプリケーションの ModulePrefs セクションに <Require feature="views"> が含まれている必要があります。

gadgets.views.requestNavigateTo() の呼び出しを使用している場合は、新しいページに渡すデータを格納するオプション パラメータを指定できます。

次のコードでは、現在のアプリケーションのキャンバス サーフェスに、foo および bar という 2 つのパラメータを渡しています。

  function gotoCanvas(params) {
    var canvas_view = new gadgets.views.View("canvas");
    gadgets.views.requestNavigateTo(canvas_view, params);
  };

  var my_params = {
    foo : 12345,
    bar : "Bar value"
  };

  gotoCanvas(my_params);

ナビゲーションが発生すると、URL は次のようになります。

http://sandbox.orkut.com/Application.aspx?appId=xxxxxx&uid=xxxxxx&appParams=%7B%22foo%22%3A12345%2C%22bar%22%3A%22Bar%20value%22%7D

キャンバスビューでは、次のコードでこれらの値を確認してください。

  var prefs = gadgets.views.getParams();
  var foo = prefs["foo"];
  /* foo contains 12345 */

  var bar = prefs["bar"];
  /* bar contains "Bar value" */

注意 : Orkut ではプロフィール ビューに複数のアプリケーションを含めることができますが、そのためOpenSocial 0.7 API ではプロフィール ビューのどのアプリケーションにデータを渡すかを指定することはできません。したがって、アプリケーションのキャンバス ビューにデータを渡すことができるのは、この方法しかありません。プロフィール ビューに渡されたデータは無視されます。

Updated クエリストリングを使用してアプリケーションにデータを渡す

このセクション内のコードを使用するには、アプリケーションの ModulePrefs セクションに <Require feature="views"> を含める必要があります。

クエリストリングからアプリケーションのキャンバス ビューに、データを渡さなければいけない場合もあります。Orkut では、「appParams」という特別なパラメータを使用して、パラメータ データをアプリケーションに渡すことができます。たとえば、次の URL にアクセスします。

http://sandbox.orkut.com/Application.aspx?appId=xxxxxxxxxxxx&appParams=%7B%20%22hello%22%20%3A%20%22hi%22%20%7D

ここで、xxxxxxxxxxxx はアプリケーションの ID 番号です。この URL にアクセスすると、値として hi が格納された hello というパラメータがアプリケーションに送信されます。このパラメータは、次の方法で取得できます。

  var querydata = gadgets.views.getParams();
  var hello = querydata["hello"];
  /* hello now contains the value "hi" */

%7B%20%22hello%22%20%3A%20%22hi%22%20%7D は、JSON エンコードのオブジェクトを URL エンコードしたもので、orkut では appParams がこのフォーマットになっていることが前提とされます。アプリケーションにデータを渡す URL をカスタム コードとして記述したい場合は、JSON オブジェクトを定義し、このデータをクエリストリングとしてアプリケーションに渡せるようにエンコードする必要があります。

たとえば、値 12345 を変数foo として渡し、値 "Bar value" を変数 bar として渡すには、まずこれらの値を 1 つのオブジェクトにまとめます。 

  var data = { "foo" : 12345,
               "bar" : "Bar value" };

これを JSON ストリングに変換するには、gadgets.json.stringify 関数か、その他の JSON ライブラリを使用します。

  var json_data = gadgets.json.stringify(data);

json_data には、上の 2 つのコード スニペットを実行することで、値 {"foo":12345,"bar":"Bar value"} が格納されます。この値をエスケープしてクエリストリングで使用できるようにするには、encodeURIComponent JavaScript 関数を使用します。

  var url_data = encodeURIComponent(json_data);

url_data には、上に示した 2 つのコード スニペットを実行することで、値 %7B%22foo%22%3A12345%2C%22bar%22%3A%22Bar%20value%22%7D が格納されます。appParams クエリストリング パラメータに格納されたこの値を使用することで、データをアプリケーションに渡すことができます。

  http://sandbox.orkut.com/Application.aspx?appId=xxxxxxxxxxxx&appParams=%7B%22foo%22%3A12345%2C%22bar%22%3A%22Bar%20value%22%7D

この方法は、requestNavigateTo() を使用してアプリケーションにデータを渡すで説明した requestNavigateTo() を使用する方法に比べて複雑ですが、この方法で生成したリンクは、外部のウェブサイトやアクティビティ ストリームのエントリにも表示できます。

ユーザーの orkut UID を取得する

OpenSocial ID 番号とは別に、ユーザーは orkut UID を取得しなければならないときがあります。たとえば、orkut UID を使用すると、別のユーザーのコンテキストにあるキャンバス ページへのリンクを生成できます。Orkut UID を取得するには、ユーザーのプロフィール URL を解析して UID パラメータを抽出します。

注意 : この方法は orkut 専用で、他の OpenSocial コンテナでは使用できません。このデータを orkut 限定の機能に使用する場合を除き、この方法は使用しないようにしてください。

  function request() {
    var req=opensocial.newDataRequest();
    req.add(req.newFetchPersonRequest("VIEWER"), "viewer");
    req.send(response);
  };

  function response(data) {
    var viewer = data.get("viewer").getData();
    var profile_url = viewer.getField(opensocial.Person.Field.PROFILE_URL);
    var regex = /uid=([^&#]+)/;
    var result = profile_url.match(regex);
    if (result.length == 2) {
      var uid = result[1];
      /* uid now contains the viewer's orkut UID */
    } else {
      /* there was a problem getting the UID */
    }
  };

  request();

uid 変数には、アプリケーション キャンバスへのリンクの構築に使用する値が格納されています。詳細については、アプリケーション内のページにリンクするをご覧ください。

Updated アプリケーション内のページにリンクする

このセクション内のコードを使用するには、アプリケーションの ModulePrefs セクションに <Require feature="views"> を含める必要があります。

ここまでに説明した方法を組み合わせることで、アプリケーション内の別のページにリンクした URL を作成できます。たとえば、アプリケーションに「about」ページへのリンクを表示するとします。その場合はまず、次のようなリンクを動的に作成する必要があります。

  http://sandbox.orkut.com/Application.aspx?appId=XXXXXXXX&uid=YYYYYYYY&appParams=%7B%22page%22%3A%22about%22%7D

ここで、XXXXXXXX はアプリケーション ID (アプリケーションの ID を取得するを参照)、YYYYYYYY はリンク先となるユーザーの orkut UID (ユーザーの orkut UID を取得するを参照) です。このフォーマットの URL は、次の方法で構築できます。

  function makeLink(page, app_id, uid) {
    return [ gadgets.util.getUrlParameters()["parent"], 
             "/Application.aspx?appId=", 
             app_id, 
             "&uid=",
             uid,
             "&appParams=%7B%22page%22%3A%22", 
             page,
             "%22%7D"].join("");
  };
  
  /* stored_app_id should be initialized to the application ID - Check the 
   * "Obtaining the application's ID" section for details on
   * obtaining this.
   * stored_uid should be initialized to the user's orkut UID - Note that 
   * is _not_ the same as the opensocial ID number!  Check the 
   * "Getting a user's orkut UID" section for details on 
   * obtaining this. */

  var about_url = makeLink("about", stored_app_id, stored_uid);

これらのリンクは、ユーザーのアクティビティ ストリームや外部のウェブサイトに出力できます。

URL を生成せず、単にユーザーを「about」ページにリダイレクトしたい場合は、次のように追加のパラメータ データを指定して gadgets.views.requestNavigateTo() を呼び出します。

  function gotoPage(to_page) {
    var canvas_view = new gadgets.views.View("canvas");
    var params = {};
    params["page"] = to_page;
    gadgets.views.requestNavigateTo(canvas_view, params);
  };

  gotoPage("about");

アプリケーションに表示するページを選択するには、page パラメータの値をオンにします。

  var page = gadgets.views.getParams()["page"]; 
  
  if (page == "about") {
    renderAboutPage();
  } else {
    renderNormalPage();
  }

このコードは、page パラメータをどの方法でアプリケーションに渡すかに関係なく機能します。

New! アクティビティ ストリーム

アクティビティ ストリームを使用すると、ユーザーが orkut アプリケーションを使用中に実行した操作に関する通知を、ユーザーの友だちに送信できます。Orkut のユーザー インターフェイスでは、アクティビティ ストリームは「更新」として表示されます。友だちの更新を表示するには、 http://sandbox.orkut.com/Notifications.aspx にアクセスします。自分の更新を表示するには、 http://sandbox.orkut.com/MyUpdates.aspx にアクセスします。

New! Orkut のアクティビティ ストリーム ポリシー

アプリケーションは、ユーザーのプロフィールの拡張です。つまり、orkut のアクティビティ ストリーム ポリシーも、サイトの他の構成要素 (写真、スクラップブック、プロフィール フィールドなど) と同じです。requestCreateActivity の呼び出しは、以下に示すように状況によって成功する場合と失敗する場合があります。

  • オーナーが自分自身のプロフィール上で実行されているアプリケーションを操作しているときは、アクティビティを登録できます。その結果として生成されるアクティビティ ストリーム エントリは、オーナーのアクティビティ ストリームに登録されます。
  • ユーザーが友だちのプロフィール上でアプリケーションを操作しているとき、または友だちがオーナーのプロフィール上でアプリケーションを操作しているときは、アクティビティを登録することはできません。

アクティビティ ストリーム エントリは、以下の場所に表示されます。

  • ユーザーのホームページおよび「さらに表示」ページ。この一覧には、ユーザーの友だちからのエントリが含まれます。これらのイベントは重要度に応じてフィルタリングされます。また、ユーザーが友だちのグループでイベントをフィルタリングすることも可能です。[1]
  • ユーザーのプロフィール ページ。この一覧には、ユーザー自身の更新が含まれます。[2]

[1] 現時点の orkut では、友だちのグループや、重要度に基づく更新の順位付けはサポートされていません。これらの機能は、今後追加される予定です。
[2] 現時点では、orkut のプロフィール ページにイベントの一覧は表示されません。この機能は、今後追加される予定です。

次の表に、どのイベントがどの場所に表示されるかをまとめます。

イベント タイプ ホームページおよび「さらに表示」ページ ユーザーのプロフィール ページ
ネイティブ イベント 写真、動画、ステータス、証明書、およびプロフィール フィールドの重要な更新 写真、動画、ステータス、証明書、およびプロフィール フィールドのすべての更新
アプリケーションのインストールとアンインストール 表示されない 表示される
アプリケーションからのイベント 表示される 表示される

アプリケーションからアクティビティ ストリームに大量の更新が登録されないよう、1 つのアプリ ーションが 1 人のユーザーについて 1 日に送信できる更新の数は 3 つに限定されています。なお、この制限は実働環境の orkut (www.orkut.com) にのみ提供されます。スムーズな開発を可能にするため、サンドボックスでのアクティビティ ストリームの更新数に制限はありません。

New! プロフィール データ

OpenSocial API を使用すると、orkut のユーザーに関する情報 (プロフィール データ形式) にアクセスできます。これらのデータは、すべてがデフォルトで使用できるわけではありません。ここでは、orkut 上のアプリケーションでどの情報が使用でき、どの情報が使用できるようになる可能姓があり、どの情報が使用できないかを説明します。

New! Orkut のプロフィール データ ポリシー

アプリケーションからユーザー プロフィール データにアクセスするには、ユーザー自身のプロファイルにアプリケーションをインストールする必要があります。これにより、アプリケーションに対するアクセス権がユーザーに付与されます。

個人情報は、orkut とアプリケーションの間では共有されません。アプリケーションから、orkut ユーザーの電話番号、メール アドレス、誕生日、および住所にアクセスすることはできません。

アプリケーションで使用できるのは、ユーザーが「全員」が使用できることを指定したデータのみです。友だちや友だちの友だちに限定されているデータは、アプリケーションでは使用できません。

New! プロフィール フィールドの一覧

ここでは、OpenSocial で使用できるすべてのプロフィール データの一覧と、それぞれのフィールドの orkut アクセス ポリシーを示します。ポリシーは、以下の 3 つに分けて示します。

使用可能 ユーザーがこのフィールドのプライバシーを「share with everyone」に設定した場合、データをアプリケーションで使用できます。
未実装 このフィールドは、将来的に利用可能になる予定です。
個人情報 このフィールドは、アプリケーションでは使用できません。

全般プロフィール フィールド

Orkut フィールド OpenSocial フィールド Orkut アクセス ポリシー
名 NAME (GIVEN_NAME) 使用可能
姓 NAME (FAMILY_NAME) 使用可能
性別 GENDER 使用可能
パートナー関係 RELATIONSHIP_STATUS 使用可能
誕生日 DATE_OF_BIRTH 個人情報
誕生年 DATE_OF_BIRTH 個人情報
市区町村 CURRENT_LOCATION および ADDRESSES 使用可能
都道府県 CURRENT_LOCATION and ADDRESSES 使用可能
郵便番号 CURRENT_LOCATION および ADDRESS 個人情報
使用する言語 LANGUAGES_SPOKEN 使用可能
中学・高校 SCHOOLS 未実装
短大/大学 SCHOOLS 未実装
会社名 JOBS 未実装
興味 LOOKING_FOR 未実装

公開プロフィール フィールド

Orkut フィールド OpenSocial フィールド Orkut アクセス ポリシー
子供 CHILDREN 未実装
民族 ETHNICITY 未実装
宗教 RELIGION 未実装
政治的立場 POLITICAL_VIEWS 使用可能
ユーモア HUMOR 使用可能
性的嗜好 SEXUAL_ORIENTATION 未実装
ファッション FASHION 使用可能
タバコ SMOKER 未実装
お酒 DRINKER 未実装
ペット PETS 未実装
生活 LIVING_ARRANGEMENT 使用可能
出身地 ADDRESSES 未実装
ウェブ ページ URLS 使用可能
自己紹介 ABOUT_ME 使用可能
熱中していること INTERESTS 使用可能
スポーツ SPORTS 使用可能
活動 ACTIVITIES 使用可能
本 BOOKS 使用可能
音楽 MUSIC 使用可能
テレビ番組 TV_SHOWS 使用可能
映画 MOVIES 使用可能
料理 FOOD 使用可能

連絡先プロフィール フィールド

Orkut フィールド OpenSocial フィールド Orkut アクセス ポリシー
メインのメール アドレス EMAILS 個人情報
予備のメール アドレス EMAILS 個人情報
Google トーク IM 非対応 非対応
IM ユーザー名 非対応 非対応
自宅電話 PHONE_NUMBERS 個人情報
携帯電話 PHONE_NUMBERS 個人情報
SMS PHONE_NUMBERS 個人情報
Address ADDRESSES および CURRENT_LOCATION 個人情報
市区町村 ADDRESSES および CURRENT_LOCATION 使用可能
都道府県 CURRENT_LOCATION および ADDRESSES 使用可能
郵便番号 ADDRESSES および CURRENT_LOCATION 個人情報

学歴/仕事プロフィール フィールド

Orkut フィールド OpenSocial フィールド Orkut アクセス ポリシー
学歴 非対応 非対応
中学・高校 SCHOOLS 未実装
短大/大学 SCHOOLS 未実装
専攻 非対応 非対応
学位 非対応 非対応
年度 SCHOOLS (END_DATE) 未実装
職業 JOBS 未実装
業種 JOBS (FIELD) 未実装
サブ業種 JOBS (SUB_FIELD) 未実装
会社名 JOBS (NAME) 未実装
会社のウェブ ページ JOBS (WEBPAGE) 未実装
役職 JOBS (TITLE) 未実装
職務内容 JOBS (DESCRIPTION) 未実装
勤務先のメール アドレス EMAILS 個人情報
勤務先の電話番号 PHONE_NUMBERS 個人情報
仕事上のスキル 非対応 非対応
仕事上の興味 JOB_INTERESTS 未実装

パーソナル プロフィール フィールド

Orkut フィールド OpenSocial フィールド Orkut アクセス ポリシー
プロフィールのタイトル 非対応 非対応
よく言われる第一印象 非対応 非対応
身長 BODY_TYPE (HEIGHT) 未実装
瞳の色 BODY_TYPE (EYE COLOR) 未実装
髪の色 BODY_TYPE (HAIR_COLOR) 未実装
体型 BODY_TYPE (BUILD) 未実装
刺青/ピアス 非対応 非対応
外見 非対応 非対応
チャーム ポイント 非対応 非対応
好きなこと TURN_ONS 使用可能
嫌いなこと TURN_OFFS 使用可能
理想的な最初のデート 非対応 非対応
過去の付き合いから学んだこと 非対応 非対応
人生に欠かせない 5 つのもの 非対応 非対応
寝室にあるもの 非対応 非対応
理想のタイプ ROMANCE 使用可能

Updated スクラップ拡張アプリケーション

現時点の orkut では、スクラップ拡張アプリケーションはサポートされていません。

関連情報

ここではorkut 環境でのアプリケーション開発について説明しました。OpenSocial API について詳しく知りたい場合は、OpenSocial API のホーム ページに掲載されているドキュメントや資料をご覧ください。