FacebookのGraph API(その9・Eventオブジェクト)

  • 投稿日:
  • by
  • カテゴリ:

FacebookのGraph APIのその9として、Eventオブジェクトを紹介します。

1.Eventオブジェクトの概要

Eventオブジェクトは、イベントを表すオブジェクトです。

公開されているイベントの情報を得る場合は、アクセストークンが必要です。
ユーザーが属している非公開のグループの情報を得るには、そのユーザーのuser_eventsのPermissionが必要です。
また、ユーザーの友達が属している非公開のグループの情報を得るには、そのユーザーのfriends_eventsのPermissionが必要です。

例えば、https://graph.facebook.com/331218348435にアクセスすると、以下のようにFacebook Developer Garage Austinのイベントの情報を得ることができます。

{
  "id": "331218348435", 
  "owner": {
    "name": "Julia Lam", 
    "id": "2503747"
  }, 
  "name": "Facebook Developer Garage Austin - SXSW Edition", 
  "description": "Join the Facebook team and local developers for a deep dive into the latest and most exciting ways developers are building with Facebook technologies.  \n\nCome to learn, stay to make friends!\n\nTentative Agenda:\n2:00 - 2:30 PM - Registration\n2:30 - 3:30 PM - Learn the latest from Facebook and local developers\n3:30 - 5:30 PM - Drink with friends!  Stay and mingle with your developer community.\n\n*Come early!  Drink tickets and t-shirts provided to the first 300 attendees.  Cash bar provided for all attendees.\n\nTopics & Speakers:\n--Multi-Platform Social Games (Gareth Davis, Facebook) \n--Increasing Mobile Engagement with Facebook Connect (Josh Williams, Gowalla)\n--Facebook Integration with Seesmic (or How to Build Community Using Octopus Balls...) (John Yamasaki, Seesmic)\n--Going multi-platform: the brave new world beyond facebook.com (Sebastien de Halleux, Playfish / EA Interactive)\n--Socially Connected Exploding Gems Everywhere...Excellent! (Jon David, PopCap Games)\n\n* Emceed by Austin local: whurley, Chaotic Moon Studios\n* All are welcome to attend, no badge is required.\n* If you can't make it in person, you can join the live stream, beginning at 2:00 PM CST, here: http://ustream.tv/fbplatform  \n\n***DAYLIGHT SAVINGS STARTS SUNDAY AT 2 AM, PLEASE ADJUST YOUR CLOCKS ACCORDINGLY***", 
  "start_time": "2010-03-14T14:00:00", 
  "end_time": "2010-03-14T17:30:00", 
  "location": "The Phoenix", 
  "venue": {
    "street": "409 Colorado St.", 
    "city": "Austin", 
    "state": "Texas", 
    "country": "United States"
  }, 
  "privacy": "OPEN", 
  "updated_time": "2010-04-13T15:29:40+0000", 
  "type": "event"
}

2.Eventオブジェクトのフィールド

Eventオブジェクトには以下のようなフィールドがあります。

フィールド名概要戻り値
idEventのID文字列
ownerEventを作成したユーザーid/nameフィールドがあるオブジェクト
nameEventの名前文字列
descriptionEventの概要文字列
start_timeEventの開始日時ISO-8601日付形式の文字列
end_timeEventの終了日時ISO-8601日付形式の文字列
locationEventの場所文字列
venueEventの場所street/city/state/zip/country/latitude/logitudeフィールドがあるオブジェクト
privacyEventの公開設定OPEN/CLOSED/SECRETのいずれか
updated_timeEventの更新日時ISO-8601日付形式の文字列

3.Eventオブジェクトのつながり

Eventオブジェクトから、以下のようなつながりの情報を得ることができます。
例えば、https://graph.facebook.com/331218348435/attendingにアクセスすると、Facebook Developer Garage Austinに参加するユーザーの情報を得ることができます。

名前概要戻り値
feedウォールのメッセージPostオブジェクトの配列
noreplyイベントへの返事をしていないユーザーid/name/rvsp_statusフィールドがあるオブジェクトの配列
invitedイベントに招待されたユーザーid/name/rvsp_statusフィールドがあるオブジェクトの配列
attendingイベントに参加するユーザーid/name/rvsp_statusフィールドがあるオブジェクトの配列
maybeイベントへの参加が未定のユーザーid/name/rvsp_statusフィールドがあるオブジェクトの配列
declinedイベントに参加しないユーザーid/name/rvsp_statusフィールドがあるオブジェクトの配列
pictureイベントのプロフィール画像プロフィール画像のアドレスへリダイレクト