Posts
ターゲット、またはID に基づいてターゲットへの投稿を作成、削除、およびクエリします。ターゲットに基づいてコメントを挿入したり、ID に基づいて削除することもできます。このテーブルには認証が必要です。
テーブル固有の情報
Facebook のPosts は、ユーザーのプロフィールフィードへの投稿です。投稿は、ユーザー、ページ、アプリケーション、グループ、またはイベントに対して行うことができます。
Note： Facebook API の非推奨仕様により、ユーザープロファイルが定義された、またはデフォルトのターゲットであるComments、Photos、Posts、およびVideos ビューへのクエリは、以下のフィールドのデータを返さなくなりました。
- comments
- message_tags
- reactions
- sharedposts
- story
- story_tags
- to
- via
Select
投稿を選択する際にターゲットを指定することができます。ターゲットは、投稿の対象になるページなどの有効なエンティティを表します。ターゲットを指定しなかった場合は、認証ユーザーがターゲットとして使用されます。例えば、ページからの投稿を取得するには、次のステートメントを使用します。
SELECT * FROM Posts WHERE Target = 'PageId'
投稿ID がわかっている場合は、ID を指定するだけで特定の投稿に関する情報を取得できます。次に例を示します。
SELECT * FROM Posts WHERE Id = 'PostId'
投稿をクエリする場合は、CreatedTime またはUpdatedTime のいずれかを指定してエレメントを取得できます。次に例を示します。
SELECT * FROM Posts WHERE Target = 'facebook' AND CreatedTime >= '1/1/2012' AND CreatedTime <= '2/1/2012'
挿入
投稿を挿入するには、投稿のTarget とMessage を指定する必要があります。次に例を示します。
INSERT INTO Posts (Message, Target) VALUES ('My New Post', 'PageId')
Link またはObjectId カラムを使用して写真の投稿を作成します。Link カラムでは、投稿を追加する画像のアクセス可能なURL を指定します。また、動画の投稿も作成できます。
INSERT INTO Posts (Message, Target, Link) VALUES ('My New Post', 'PageId', 'http://imagerepo.net/testimage.png)'
INSERT INTO Posts (Message, Target, Link) VALUES ('My New Post', 'PageId', 'http://samplevideos.net/newmovie.mp4)'
Link カラムにローカルファイルを設定してメディアをアップロードすることもできます。この機能を使用するには、UploadLinkedMedia をtrue に設定してください。
INSERT INTO Posts (Message, Target, Link) VALUES ('From Local', 'PageId', 'file://D://test/sample.mp4')
ObjectId カラムでは、アカウント内の未公開の写真のID を指定します。公開せずに写真をアップロードするには、UploadPhoto ストアドプロシージャを使用します。Video Id はサポートされていません。
INSERT INTO Posts (Message, Target, ObjectId) VALUES ('My New Post', 'PageId', '43572')
更新
Facebook は、投稿の更新を許可していません。
削除
投稿を削除するには、投稿のID を指定してDELETE ステートメントを発行します。Facebook では、アプリによって作成された投稿だけをそのアプリを使用して削除できます。
Columns
| Name | Type | ReadOnly | Description |
| ID [KEY] | String | True |
投稿のID。 |
| Target | String | False |
投稿を取得するターゲットのID またはユーザー名、または投稿先のターゲットのID またはユーザー名。これには、イベント、グループ、ページ、またはユーザーを指定できます。 |
| FromId | String | True |
投稿を行ったユーザーのID。 |
| FromName | String | True |
投稿を行ったユーザーの名前。 |
| FromPicture | String | True |
投稿を行ったユーザーの写真。 |
| FromCategory | String | True |
投稿を行ったユーザーのカテゴリ。FromCategory は、他のFrom* フィールドが選択されていない場合にのみ取得できます。 |
| ToData | String | True |
投稿先のユーザーの集計。 |
| Message | String | False |
投稿のメッセージ。投稿の挿入時にはメッセージが必要です。 |
| MessageTags | String | True |
メッセージ内でタグ付けされたユーザー、ページなどのオブジェクトの集計。 |
| Attachments | String | True |
投稿の添付ファイルの集計。 |
| Picture | String | False |
投稿に含まれる写真へのリンク。 |
| FullPicture | String | False |
投稿に含まれる元の写真へのリンク。Picture にリストされたものは、リサイズされた小さな写真の場合があります。 |
| Icon | String | True |
投稿のタイプを表すアイコンへのリンク。 |
| Actions | String | True |
投稿に対して実行できるアクション（コメント、いいね！など）の集計。 |
| CommentsCount | Integer | True |
投稿に対するコメントの数。 |
| LikesCount | Integer | True |
投稿がいいね！された回数。 |
| SharesCount | Integer | True |
投稿が共有された回数。 |
| PlaceId | String | False |
投稿に関連付けられた場所がある場合は、そのID。 |
| PlaceName | String | True |
投稿に関連付けられた場所がある場合は、その名前。 |
| ApplicationId | String | True |
この投稿が行われたアプリケーションのID。 |
| ApplicationName | String | True |
この投稿が行われたアプリケーションの名前。 |
| ApplicationCanvasName | String | True |
エンティティの作成に使用されたアプリケーションに関する情報。 |
| ApplicationNamespace | String | True |
エンティティの作成に使用されたアプリケーションに関する情報。 |
| Story | String | True |
ユーザーから意図せず生まれた記事。例えば、2人のユーザーが友達になったときに生まれた記事です。このような記事を取得するには、アプリで［最近のニュースフィード記事を含める］移行オプションを有効にする必要があります。read_stream アクセス許可が必要です。 |
| StoryTags | String | True |
記事に関連付けられたオブジェクト（ユーザー、ページなど）の集計。 |
| LikesData | String | True |
いいね！データの集計。 |
| CommentsData | String | True |
この投稿に対するコメントの集計。 |
| CreatedTime | Datetime | True |
投稿の作成時刻。 |
| UpdatedTime | Datetime | True |
投稿が最後に更新された時刻。 |
Pseudo-Columns
SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。 詳細については、WHERE 句のセクションを参照してください。
| Name | Type | Description |
| TaggedUser | String |
これをID またはユーザー名に設定すると、指定されたユーザーがタグ付けされている投稿が取得されます。read_stream アクセス許可が必要です。 |
| LocationUser | String |
これをID またはユーザー名に設定すると、ユーザーがタグ付けされている場所が取得されます。user_photos およびuser_status アクセス許可が必要です。 |
| Link | String |
投稿に添付するリンク。投稿の作成には、Link カラムまたはMessage カラムのいずれかが必要です。 |