フィードダイアログ

フィードダイアログをアプリに追加することにより、人々がそれぞれのストーリーにコメントを付けてタイムラインに公開できるようにすることができます。

フィードダイアログでストーリーをシェアするためにアクセス許可の拡張を依頼する必要はありません。

統合

このダイアログは、Facebook SDK for Javascript/iOS/Androidで、URLへの完全リダイレクトを実行することによって使用できます。このダイアログをトリガーするために使用できるサンプルコードスニペットを以下に示します。

JavaScript

フィードダイアログをトリガーするには、FB.ui関数を呼び出します。その際に、methodパラメーターの値としてfeedを使用します。

FB.ui({
  method: 'feed',
  link: 'https://developers.facebook.com/docs/'
}, function(response){});

iOS

Open Graphストーリーの公開もできるiOSシェアダイアログガイドをご覧ください。

Android

Open Graphストーリーの公開もできるAndroidシェアダイアログガイドについて詳細をご確認ください。

URLリダイレクション

https://www.facebook.com/dialog/feed?
  app_id=145634995501895
  &display=popup
  &link=https%3A%2F%2Fdevelopers.facebook.com%2Fdocs%2F
  &redirect_uri=https://developers.facebook.com/tools/explorer

注

[あなたのタイムラインに投稿できる人]の設定を[自分だけ]に設定している人のタイムラインに、別の人がフィードダイアログを使って投稿しようとすると、「投稿できない」というエラーになります。

パラメーター

注: アプリでiTunesやGoogle Playストアへのリンク、またはFacebookプロフィールやページへのリンクをシェアしても、下記のパラメーターを使ってシェアで指定した画像や説明は投稿されません。代わりに、WebクローラーでアプリストアまたはFacebookページから直接スクレイピングしたアプリ情報の一部が投稿されます。これには画像が含まれない場合があります。iTunesやGoogle Playへのリンクのシェアをプレビューするには、シェアデバッガーにリンクのURLを入力します。

パラメーター	説明
`app_id`	アプリの一意の識別子。必須。
`redirect_uri`	利用者がダイアログでボタンをクリックした後にリダイレクトされるURL。URLリダイレクトを使用する場合は必須です。
`display`	ダイアログをどのようにレンダリングするかを指定します。 URLリダイレクトダイアログの実装を使用している場合は、Facebook.com内でフルページ表示になります。この表示タイプは`page`と呼ばれます。 iOS用またはAndroid用Facebook SDKを使用してダイアログを呼び出すと、このタイプが自動的に指定され、デバイスに適した表示タイプが選択されます。 Facebook SDK for Javascriptを使用している場合、アプリにログインしている利用者に対してはモーダル`iframe`タイプ、Facebook.comのゲーム内で使用している利用者に対しては`async`、その他の利用者に対しては`popup`ウィンドウがデフォルトになります。Facebook SDK for Javascriptを使用している場合、必要なら`popup`タイプまたは`page`タイプを強制適用することもできます。モバイルウェブアプリでは、必ず`touch`表示タイプがデフォルトになります。
`from`	メッセージ投稿者のID。これを指定しない場合のデフォルトは、その時点の人になります。指定する場合、その人か、またはその人が管理するページのIDでなければなりません。
`to`	このストーリーの公開先となるプロフィールID。これを指定しない場合のデフォルト値は`from`です。相手のIDの友達もあなたのアプリを使っていなければなりません。
`link`	この投稿に添付されたリンク。
`source`	この投稿に添付されているメディアファイル(SWFかMP3のどちらか)のURL。SWFの場合、動画サムネイル提供のための`picture`も指定する必要があります。
`ref`	この引数は、少なくとも5つの異なるアイテムで構成されるコンマ区切りリストです。そのそれぞれは、文字集合「0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_」から取られた1文字以上15文字以下の文字列です。各カテゴリはFacebookインサイトで使用され、さまざまなタイプの投稿のパフォーマンスを測定するのに役立ちます。

廃止パラメーター

パラメーター	説明
`post_id`	その人が自分のタイムラインに公開するために投稿したストーリーID。
`properties`	ストリーム添付の中で説明の下に表示されるキー/値ペアのJSONオブジェクト。プロパティごとに1行が含まれます。キーは文字列でなければなりません。値は、文字列か、または`text`と`href`をキーとするJSONオブジェクトです。
`actions`	投稿の「コメント」と「いいね！」リンクの横に表示されるアクションリンクについて記述する単一のオブジェクトを含むJSON配列。含まれているオブジェクトには、キーとして`name`と`link`がなければなりません。
`picture`	この投稿に添付されている写真のURL。写真は200×200ピクセル以上でなければなりません。サイズについて詳しくは、シェアのベストプラクティスに関するドキュメントをご覧ください。
`name`	リンク添付の名前。
`caption`	リンクのキャプション(リンク名の下に表示)。これを指定しない場合、このフィールドにはリンクのURLが自動的に設定されます。
`description`	リンクの説明(リンクキャプションの下に表示)。指定しない場合、このフィールドには、リンクからスクレイピングされた情報(通常はページのタイトル)が自動的に入力されます。
`thumbnail`	アップロードされたローカル画像ファイル(`.jpg`、`.jpeg`、`.gif`、または`.png`)。