FQLのeventテーブルのドキュメントの和訳です。イベントに関する諸々の情報を取得できます。
以下、2012年8月1日 18:50の変更分までの和訳です。
UserオブジェクトとPageオブジェクトはいずれも /events コネクションを持ち、それぞれに紐づくイベント情報の要約を返します。個々のイベントの詳細についてはイベントIDを基にしてEventオブジェクトへアクセスする事で取得できます。
FQLのeventテーブルから取得する場合は、以下のいずれかが必要となります。
- 一般公開されたイベントへのアクセスには、一般的なアクセストークン
- 任意のユーザが閲覧できる非公開イベントへのアクセスには、ユーザのアクセストークン
- アプリが作成した非公開イベントには、そのイベントを作成したアプリのアクセストークン
- ページが作成した非公開イベントには、そのイベントを作成したページのアクセストークン
Example
Facebook EngineeringページのThe "Pushing millions of lines of code five days a week tech talk"イベントを取得するには、以下のFQLを実行します。
SELECT name, venue, location, start_time FROM event WHERE eid = 209798352393506
Events Timezone Migration Note
Events Timezone移行が完了すると、eventの時刻は常にISO-8601形式の文字列になりますので、data_formatパラメータでの形式指定は効かなくなります。イベントのタイプに従って以下の形式で日時は返されます。
- 日付のみ(e.g., '2012-07-04'): 日付飲み指定されていて、時刻が未定のもの
- 厳密な時刻
(e.g., '2012-07-04T19:00:00-0700'):
UTCからのオフセット値付きで、厳密な開始時刻時刻が指定されているもの。この指定方法が今後のFacebookイベントの日付管理に用いられ、ユーザ
は異なるタイムゾーンでも最適に閲覧できるようになります。
- ローカル時刻 (deprecated, e.g., '2012-07-04T19:00:00'): タイムゾーン情報を持たない旧イベント。この形式は廃止対象ですが、既存のイベントへの互換性を保つため、この形式でも返され続けます。
この移行以前の時刻表記は、Pacific Timeのタイムスタンプです。
Columns
Indexable | Name | Type | Description |
---|---|---|---|
* | eid | 整数 | イベントID |
name | 文字列 | イベント名 | |
pic_small | 文字列 | 小さいサイズのプロフィール画像URL。最大幅は50pxで、最大高さは150pxです。空の場合も有り得ます。 | |
pic_big | 文字列 | 大きいサイズのプロフィール画像URL。最大幅は200pxで、最大高さは600pxです。空の場合も有り得ます。 | |
pic_square | 文字列 | 正方形のプロフィール画像URL。縦横共に50pxです。 | |
pic | 文字列 | 中サイズのプロフィール画像URL。最大幅は100pxで、最大高さは300pxです。空の場合も有り得ます。 | |
host | 文字列 | イベント主催者の名前 | |
description | 文字列 | イベントの説明文 | |
start_time | 時刻 | イベント開始日時(ISO-8601) Events Timezone移行前はタイムスタンプでした。上記Events Timezone Migration Noteをご覧下さい。 | |
end_time | 時刻 | イベント終了日時(ISO-8601) Events Timezone移行前はタイムスタンプでした。上記Events Timezone Migration Noteをご覧下さい。 | |
creator | 整数 | イベント作成者のユーザID | |
update_time | 時刻 | イベント情報の最終更新日時 | |
location | 文字列 | イベントが開催される場所 | |
venue | 文字列 | イベント開催地 | |
privacy | 文字列 | イベントのプライバシー設定。OPEN, CLOSED, SECRETのいずれかを示します。 | |
hide_guest_list | 真偽値 |
| |
hide_guest_list | 真偽値 |
| |
can_invite_friends | bool | 閲覧者が友達を招待できるか | |
all_members_count | int | 招待されているユーザの総数 | |
attending_count | int | 参加予定ユーザの総数 | |
unsure_count | int | "もしかしたら参加"ユーザの総数 | |
declined_count | int | 不参加ユーザの総数 | |
not_replied_count | int | 未返信ユーザの総数 |