©2009 Google - Code サイト ホーム - 利用規約 - プライバシー ポリシー - サイト ディレクトリ
Google Code が利用できる言語: English - Español - 日本語 - 한국어 - Português - Pусский - 中文(简体) - 中文(繁體)
| 
日本語 | ログイン
このガイドでは、orkut 環境でのアプリケーションの構築と管理について説明します。対象読者としては、orkut、ガジェット API、JavaScript について一般的な知識を備えたデベロッパーを想定していますが、必要と思われる箇所では参照情報へのリンクを示します。
Orkut は更新されており、現時点ではバージョン 0.7 の OpenSocial API をサポートしています。このドキュメントにも、更新による変更点が反映されています。New! や Updated! がついている箇所は、コーディング方法が以前のバージョンから変更されたことを表します。
アプリケーションの開発手法は、OpenSocial コンテナごとに異なります。このセクションでは、orkut で使用するアプリケーションの開発プロセスについて説明します。
このドキュメントでは、orkut での開発手法に関連し、以下の用語を使用します。
| アクティビティ ストリーム | ある個人からのアクティビティを格納するデータ フィードです。 |
|---|---|
| アプリケーション | ガジェットや OpenSocial API を使用して orkut の機能を拡張するサードパーティ コードです。 |
| アプリケーション定義 | アプリケーションを定義する XML ファイルです。その構文はガジェット XML に基づいしており、「ガジェット スペック」とも呼ばれます。 |
| アプリケーション ディレクトリ | 使用できるアプリケーションの一覧が表示されます。 |
| アプリケーション設定ページ | ユーザーがインストールしたアプリケーションの一覧が表示されます。ユーザー自身が、アプリケーションを追加したり削除したりできます。 |
| キャンバス ビュー New! | アプリケーションをページ全体に表示するビューです。 |
| 左ナビゲーション バー | Orkut ページの左側にある、リンクをまとめたバーです。左ナビゲーション バーには、orkut のホームページにログインしているユーザーの一覧が表示されます。ここに、友だちのプロフィールを表示することもできます。 |
| 左ナビゲーション リンク | 左ナビゲーション バー上のリンクです。他の orkut セクション (たとえばプロフィール) や、OpenSocial アプリケーションのキャンバス ページにリンクできます。 |
| プロフィール ビュー New! | ユーザーのプロフィールを表示するアプリケーションのビューです。 |
| ビュー New! | アプリケーションを表示する場所です。Orkut では、アプリケーションをキャンバス ビューまたはプロフィール ビューに表示できます。バージョン 0.6 では、ビューのことを「サーフェス」と呼んでいました。 |
Orkut 用のアプリケーションを構築する前に、orkut の新しいアプリケーション プラットフォームについて理解しておくことをお勧めします。Orkut アプリケーションの構造では、orkut でアプリケーションをホストするために追加されたすべての拡張について、サンプルに沿って分かりやすく説明しています。
初めて OpenSocial アプリケーションを作成する場合は、Orkut 用 OpenSocial チュートリアルの手順にそって作業することで、OpenSocial API についての理解を深めることができます。このチュートリアルでは、OpenSocial API を使用して単純なギフト贈呈アプリケーションを開発する手順を説明しています。
ガジェット 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 がブラウザに表示されます。次のセクションでアプリケーションをインストールする際に、このファイルの URL が必要になります。
Google ガジェット作成ツールのプレビュー モードは、ソーシャル アプリケーションでは機能しないことに注意してください。Orkut でコードを動作させるには、上の方法でアプリケーションの URL を取得し、次のセクションの説明にそって操作してください。
アプリケーションからソーシャル ネットワーク データにアクセスするには、アプリケーションをコンテナ内部で実行する必要があります。Orkut にはデベロッパー サンドボックスが用意されており、ここから OpenSocial API やその他の新機能にアクセスできます。http://sandbox.orkut.com にアクセスできない (たとえば、サンドボックスにアクセスしようとすると http:/www.orkut.com にリダイレクトされる) 場合は、使用している Orkut アカウントをデベロッパーとしてホワイトリストに登録する必要があります。Orkut Sandbox では、サンドボックスのホワイトリストに登録されている友だちのデータしか返されないため、何人かのデベロッパーを友だちとして登録し、テスト データを得るとよいかもしれません。OpenSocial デベロッパー フォーラムのこのスレッドとこの Orkut コミュニティを利用すると、友だちのネットワークを広げることができます。
![[アプリケーションを追加] リンク](/intl/ja/apis/orkut/docs/images/img10.png)
Orkut Sandbox 内部でアプリケーション ページに移動するには、Orkut の左ナビゲーション バーの [アプリケーションを追加] をクリックするか、 http://sandbox.orkut.com/MyApps.aspx にアクセスします。
サンプルを初めて実行した場合、[マイ アプリケーション] は空の状態ですが、[URL を指定してアプリケーションを追加:] と表示されているはずです。
このフィールドに作成したアプリケーションの URL を貼り付け、[アプリケーションを追加] ボタンをクリックします。
New! アプリケーションの情報ページが表示されます。このページには、アプリケーションに対する他のユーザーからの評価やコメントが表示されます。このページにも [アプリケーションを追加] ボタンが表示されています。このボタンをクリックすると、このアプリケーションのプロフィールへの追加処理が始まります。
[アプリケーションの追加を承認] ページが表示されます。このページには、インストール時にこのアプリケーションに付与できる権限の一覧が表示されます。現時点で付与できる権限は以下のとおりです。
一部の権限は、アプリケーションを正常に機能させるために必ず付与しなければなりません。しかし、アクティビティ ストリームへの登録を許可するかどうかなど、付与するかどうかを選択できる権限もあります。アプリケーションに付与する権限は、オプション権限の横にあるチェックボックスをオンにします。
これらの権限を付与し、アプリケーションをプロフィールにインストールするには、[アプリケーションを追加] ボタンをクリックします。ページ上の一覧にサンプル アプリケーションが追加され、左のナビゲーション バーにアプリケーションへのリンクが表示されます。
この時点で、左ナビゲーション バーの [プロフィール] をクリックすると、その Orkut のプロフィール ビューに実行中のアプリケーションが表示されます。また、ナビゲーション バーのアプリケーション名をクリックすると、そのアプリケーションのキャンバス ビューに直接移動できます。
New! 複数のアプリケーションを追加すると、[マイ アプリケーション] ビューの各アプリケーション名の横に矢印が表示されます。これらの矢印をクリックすると、プロフィールに表示するアプリケーションの順序を変更できます。プロフィールに表示されるのは上から 3 つのみのため、プロフィールに表示したいアプリケーションを最上部に配置するようにしてください。
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 時間以上経過すると解消します。
ここまで、アプリケーションのインストールと更新の基本について説明しました。ここでは、orkut で堅牢なソーシャル アプリケーションを構築するためのヒントと注意点について説明します。
OpenSocial アプリケーションは、ガジェット技術をベースとした新しいタイプのアプリケーションですが、OpenSocial API をサポートするウェブサイト (コンテナともいいます) から取得したソーシャル データを処理することも可能です。Orkut は OpenSocial コンテナの一例です。このセクションでは、OpenSocial アプリケーションの開発 (特に 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] ビューアにガジェットがインストールされている場合のみ取得できます。
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 */
}
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 ビューにも対応していません。
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);
};
Orkut では、次の呼び出しを使用して、アプリケーションの ID 番号を取得できます。
var application_id = gadgets.util.getUrlParameters()["gadgetId"];
上に示したスニペットを実行すると、アプリケーションの orkut URL 内の appId パラメータと同じ値が application_id に格納されます。
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 ではプロフィール ビューのどのアプリケーションにデータを渡すかを指定することはできません。したがって、アプリケーションのキャンバス ビューにデータを渡すことができるのは、この方法しかありません。プロフィール ビューに渡されたデータは無視されます。
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() を使用する方法に比べて複雑ですが、この方法で生成したリンクは、外部のウェブサイトやアクティビティ ストリームのエントリにも表示できます。
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 変数には、アプリケーション キャンバスへのリンクの構築に使用する値が格納されています。詳細については、アプリケーション内のページにリンクするをご覧ください。
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 パラメータをどの方法でアプリケーションに渡すかに関係なく機能します。
アクティビティ ストリームを使用すると、ユーザーが orkut アプリケーションを使用中に実行した操作に関する通知を、ユーザーの友だちに送信できます。Orkut のユーザー インターフェイスでは、アクティビティ ストリームは「更新」として表示されます。友だちの更新を表示するには、 http://sandbox.orkut.com/Notifications.aspx にアクセスします。自分の更新を表示するには、 http://sandbox.orkut.com/MyUpdates.aspx にアクセスします。
アプリケーションは、ユーザーのプロフィールの拡張です。つまり、orkut のアクティビティ ストリーム ポリシーも、サイトの他の構成要素 (写真、スクラップブック、プロフィール フィールドなど) と同じです。requestCreateActivity の呼び出しは、以下に示すように状況によって成功する場合と失敗する場合があります。
アクティビティ ストリーム エントリは、以下の場所に表示されます。
[1] 現時点の orkut では、友だちのグループや、重要度に基づく更新の順位付けはサポートされていません。これらの機能は、今後追加される予定です。
[2] 現時点では、orkut のプロフィール ページにイベントの一覧は表示されません。この機能は、今後追加される予定です。
次の表に、どのイベントがどの場所に表示されるかをまとめます。
| イベント タイプ | ホームページおよび「さらに表示」ページ | ユーザーのプロフィール ページ |
|---|---|---|
| ネイティブ イベント | 写真、動画、ステータス、証明書、およびプロフィール フィールドの重要な更新 | 写真、動画、ステータス、証明書、およびプロフィール フィールドのすべての更新 |
| アプリケーションのインストールとアンインストール | 表示されない | 表示される |
| アプリケーションからのイベント | 表示される | 表示される |
アプリケーションからアクティビティ ストリームに大量の更新が登録されないよう、1 つのアプリ ーションが 1 人のユーザーについて 1 日に送信できる更新の数は 3 つに限定されています。なお、この制限は実働環境の orkut (www.orkut.com) にのみ提供されます。スムーズな開発を可能にするため、サンドボックスでのアクティビティ ストリームの更新数に制限はありません。
OpenSocial API を使用すると、orkut のユーザーに関する情報 (プロフィール データ形式) にアクセスできます。これらのデータは、すべてがデフォルトで使用できるわけではありません。ここでは、orkut 上のアプリケーションでどの情報が使用でき、どの情報が使用できるようになる可能姓があり、どの情報が使用できないかを説明します。
アプリケーションからユーザー プロフィール データにアクセスするには、ユーザー自身のプロファイルにアプリケーションをインストールする必要があります。これにより、アプリケーションに対するアクセス権がユーザーに付与されます。
個人情報は、orkut とアプリケーションの間では共有されません。アプリケーションから、orkut ユーザーの電話番号、メール アドレス、誕生日、および住所にアクセスすることはできません。
アプリケーションで使用できるのは、ユーザーが「全員」が使用できることを指定したデータのみです。友だちや友だちの友だちに限定されているデータは、アプリケーションでは使用できません。
ここでは、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 | 使用可能 |
現時点の orkut では、スクラップ拡張アプリケーションはサポートされていません。
ここではorkut 環境でのアプリケーション開発について説明しました。OpenSocial API について詳しく知りたい場合は、OpenSocial API のホーム ページに掲載されているドキュメントや資料をご覧ください。