http://developers.facebook.com/docs/reference/api/checkin/
チェックインを検索したり、読み込んだり、投稿することが可能です。全てのチェックインには、グラフ上のオブジェクトを示すチェックインIDが割り当てられています。そしてそれらのチェックインは、関連するFacebook PageやOpen Graph protocolページと結びついています。
ユーザのチェックインを取得するには、user_checkinsパーミッションを得る必要があります。ユーザの友人のチェックインを取得するには、friend_checkinsパーミッションが必要です。
チェックインを検索したり、読み込んだり、投稿することが可能です。全てのチェックインには、グラフ上のオブジェクトを示すチェックインIDが割り当てられています。そしてそれらのチェックインは、関連するFacebook PageやOpen Graph protocolページと結びついています。
ユーザのチェックインを取得するには、user_checkinsパーミッションを得る必要があります。ユーザの友人のチェックインを取得するには、friend_checkinsパーミッションが必要です。
下記へのアクセスでチェックイン情報を取得できます。
チェックインを投稿するには、ユーザの位置座標とPlace IDと、オプションで追加情報(リンクや写真など)をPOST送信します。(オプションの詳細は、
GET https://graph.facebook.com/[checkin_id]
Or you can GET checkin information from individual places or users:
もしくは、個々の場所やユーザを基に取得することも可能です。
GET https://graph.facebook.com/[user id]/checkinsユーザやユーザの友達の直近のチェックインを検索できます。
GET https://graph.facebook.com/[page id]/checkins
GET https://graph.facebook.com/search?type=checkin&access_token=ACCESS_TOKEN任意の位置の近くのplaceを検索するには、下記のようにします。(距離の単位はメートルです)
GET https://graph.facebook.com/search?q=pizza&type=place¢er=lat,long&distance=1000
Properties
Name | Description | Permissions | Returns |
id | チェックインID |
| JSON string |
from | IDと、チェックインを作成したユーザ名 |
| チェックイン作成者のnameとFacebook idを含んだJSONオブジェクト |
tags | チェックインに対してタグ付けされたユーザ |
| チェックインにタグ付けされたユーザ情報のリスト |
place | チェックインの位置に紐づけられたFacebook Pageの情報 |
| ページのid,name,locationを含むJSONオブジェクト |
message | チェックインに対してユーザが足したメッセージ |
| JSON string |
application | チェックインを作成したアプリケーションの情報 |
| アプリケーションのname,idを含んだJSONオブジェクト |
created_time | チェックインが作成された時刻 |
| IETF RFC 3339形式のdatetime |
Publishing
publish_checkins
パーミッションが必要になります。チェックインを投稿するには、ユーザの位置座標とPlace IDと、オプションで追加情報(リンクや写真など)をPOST送信します。(オプションの詳細は、
http://graph.facebook.com/PROFILE_ID/checkinsなど
ユーザのチェックインにPOSTするのと似ています。)curl -F 'access_token=...' \
-F 'message=The coffee is just meh.' \
-F 'place=PAGE_ID' \
-F 'coordinates={"latitude":"...", "longitude": "..."}' \
-F 'tags=USER_ID1, USER_ID2' \
https://graph.facebook.com/me/checkins