http://developers.facebook.com/docs/reference/dialogs/friends/

ユーザに友達を追加するよう促します。すでに友達となる相手からユーザへリクエストが送られている場合は、新しいリクエストは送信されず、送られてきたリクエストの承認を促されます。

Properties

app_id

アプリケーションID。必須ですが、ほとんどのSDKは自動で指定されます。

redirect_uri

Dialogのボタンを押した後にリダイレクトするURLです。必須ですが、ほとんどのSDKは自動で指定されます。

display

表示モードです。wwwサブドメインのデフォルトはwwwで、mサブドメインのデフォルトはwapです。ほとんどのSDKは自動で指定されます。

id

必須です。追加する友達のIDもしくはusernameです。

Return Data

action

友達が追加された場合は1、そうでない場合は0が返る真偽値です。

Usage Notes

既に実世界で繋がりを持っている人同士をFacebook上でも友達にすることを目的とした機能です。実世界で繋がりを持たない人同士を友達登録させるような使い方をするべきではありません。そのような行為を勧めている場合は、この機能の利用を停止させられるかもしれません。

Example

ユーザを下記URLに誘導してください。

http://www.facebook.com/dialog/friends/?
id=brent&
app_id=123050457758183&
redirect_uri=http://www.example.com/response/

こちらをクリックして自身でも試してみてください。ユーザには下記のようなDialogが表示されます。


friends-dialog2

ユーザがAdd Friendをクリックした場合は、下記にリダイレクトされます。

http://www.example.com/response/?action=1

Cancelをクリックした場合は、下記URLへリダイレクトします。

http://www.example.com/response/?action=0