シェアダイアログ

シェアダイアログを使用すると、利用者は個々のストーリーを自分のタイムライン、友達のタイムライン、グループに向けて投稿したり、Messengerで非公開のメッセージとして送信したりできます。シェアダイアログはFacebookログインや追加のアクセス許可が必要ないため、ウェブでのシェアを最も簡単に実現する方法です。

このドキュメントではウェブでシェアダイアログを実装する方法について説明します。モバイルアプリでシェアダイアログを実装するには、iOSでのシェアとAndroidでのシェアをご覧ください。

次に、ユーザーのタイムラインへのリンクをシェアするシェアダイアログの例を示します。

上記の自分のタイムラインでシェアの画像は、シェア対象のオーディエンスを選ぶためのドロップダウンリストから選択します。シェア対象のオーディエンスを選ぶためのドロップダウンリストは、Cookieを使ってログインしていないブラウザーでは表示されません。アプリがシェアダイアログではなくフィードダイアログを使用している場合、またはiframeウェブビューを使用している場合も同様です。

Facebookにシェアしているページのウェブ管理者は、Open Graphメタタグを含めてFacebookと再シェアするストーリーをカスタマイズします。コンテンツがFacebookに表示される方法をコントロールするには、ウェブサイトのマークアップでOpen Graphタグを使うことが重要です。詳しくは、ウェブ管理者向けシェア機能ガイドをご覧ください。

URLリダイレクションを使用してシェアする

URLリダイレクションを使用してリンクをシェアするには、次のコードを使用してください。読みやすくするために、改行を入れています。このコードを使う際には、改行を削除してください。

https://www.facebook.com/dialog/share?
  app_id=145634995501895
  &display=popup
  &href=https%3A%2F%2Fdevelopers.facebook.com%2Fdocs%2F
  &redirect_uri=https%3A%2F%2Fdevelopers.facebook.com%2Ftools%2Fexplorer

JavaScript用Facebook SDKを使用してシェアする

シェアダイアログは、shareメソッドパラメーターを指定したFB.ui関数を使用すれば、JavaScript用Facebook SDKでも使用できます。シェアダイアログを開くには、次のコードスニペットを使用します。

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

試してみてください。

パラメーター

シェアダイアログのパラメーターは、次のとおりです。

パラメーター	説明	必須ですか?
`app_id`	アプリの一意の識別子。	はい。SDKを使用すると自動的に提供されます。
`display`	シェアダイアログをどのようにレンダリングするか。 URLリダイレクション – `display` 値は`page`です。シェアダイアログはFacebook.com内ではページ全体に表示されます。 JavaScript用Facebook SDK – display値は、次のいずれかになります。アプリにログインしている利用者の場合は、モーダルの`iframe` Facebook.comのゲーム内で使用する場合は、`async` その他の場合は、`popup`ウィンドウ JavaScript用Facebook SDKを使用する際は、必要であれば`popup`タイプを強制適用できます。モバイルウェブアプリ – `display`値は常に`touch`です。 iOS用Facebook SDKまたはAndroid用Facebook SDK – SDKが、自動的に`display`を指定しデバイスに適切なdisplayタイプを選びます。	はい。SDKを使用すると自動的に提供されます。
`hashtag`	シェアするコンテンツに追加されるハッシュタグ。シェアダイアログでハッシュタグを削除できます。ハッシュタグにはハッシュ記号を含める必要があります(例: `#facebook`)。デフォルト値は`null`です。	いいえ
`href`	シェアするリンク。デフォルト値は現在のURLです。	SDKを使用する場合は必須です。
~~`redirect_uri`~~ 廃止内容	~~利用者がシェアダイアログのボタンをクリックした後にリダイレクトされるURL。~~	~~はい。SDKを使用すると自動で提供されます。~~
~~`mobile_iframe`~~ 廃止内容	~~`true`を指定すると、シェアダイアログがウェブサイト上のiframe内に開きます。このオプションはモバイルでのみ使用可能(デスクトップでは使用不可)~~	~~`false`~~

応答データ

応答は、ユーザーがFacebookログインを使用してアプリにログインしている場合にだけ行われます。

パラメーター	説明
`error_message`	エラーメッセージ。

参考情報

シェアのベストプラクティス