埋め込み可能なFacebookコンテンツに使用するoEmbedエンドポイント

oEmbedは、ウェブサイトのコンテンツを別のページに埋め込むことができるオープンフォーマットです。oEmbed標準を使用すると、Facebookの投稿や動画を自分のウェブサイトに埋め込むことができます。

エンドポイントURL

公開されている投稿動画の埋め込みコードをリクエストするには、FacebookのAPIエンドポイントを使用します。応答はすべてjson形式になります。{content-url}を投稿または動画のURLに置き換えます。

タイプ エンドポイントURL

投稿

https://www.facebook.com/plugins/post/oembed.json/?url={content-url}

動画

https://www.facebook.com/plugins/video/oembed.json/?url={content-url}

コンテンツURL

公開されているFacebookの投稿と動画には、次のいずれかのURLスキームを使用できます。

  • 投稿:
  • https://www.facebook.com/{page-name}/posts/{post-id}
  • https://www.facebook.com/{username}/posts/{post-id}
  • https://www.facebook.com/{username}/activity/{activity-id}
  • https://www.facebook.com/photo.php?fbid={photo-id}
  • https://www.facebook.com/photos/{photo-id}
  • https://www.facebook.com/permalink.php?story_fbid={post-id}
  • https://www.facebook.com/media/set?set={set-id}
  • https://www.facebook.com/questions/{question-id}
  • https://www.facebook.com/notes/{username}/{note-url}/{note-id}
  • 動画:
  • https://www.facebook.com/{page-name}/videos/{video-id}/
  • https://www.facebook.com/{username}/videos/{video-id}/
  • https://www.facebook.com/video.php?id={video-id}
  • https://www.facebook.com/video.php?v={video-id}

注: Facebookのプラットフォームは常に進化し続けているため、このリストに新たに項目が追加される可能性があります。

たとえば、Facebook開発者向けの動画「How to Share With Just Friends (友達とだけシェアする方法)」を埋め込むためのoEmbedデータを取得する場合には、次のエンドポイントURLを呼び出します。https://www.facebook.com/plugins/video/oembed.json/?url=https%3A%2F%2Fwww.facebook.com%2Ffacebook%2Fvideos%2F10153231379946729%2F

json応答は次のようになります。

{
  "author_name": "Facebook",
  "author_url": "https://www.facebook.com/facebook/",
  "provider_url": "https://www.facebook.com",
  "provider_name": "Facebook",
  "success": true,
  "height": null,
  "html": "<div id=\"fb-root\"></div>\n<script>(function(d, s, id) {\n  var js, fjs = d.getElementsByTagName(s)[0];\n  if (d.getElementById(id)) return;\n  js = d.createElement(s); js.id = id;\n  js.src = \"//connect.facebook.net/en_US/sdk.js#xfbml=1&amp;version=v2.9\";\n  fjs.parentNode.insertBefore(js, fjs);\n}(document, 'script', 'facebook-jssdk'));</script><div class=\"fb-video\" data-href=\"https://www.facebook.com/facebook/videos/10153231379946729/\"><div class=\"fb-xfbml-parse-ignore\"><blockquote cite=\"https://www.facebook.com/facebook/videos/10153231379946729/\"><a href=\"https://www.facebook.com/facebook/videos/10153231379946729/\">How to Share With Just Friends</a><p>How to share with just friends.</p>Posted by <a href=\"https://www.facebook.com/facebook/\">Facebook</a> on Friday, December 5, 2014</blockquote></div></div>",
  "type": "video",
  "version": "1.0",
  "url": "https://www.facebook.com/facebook/videos/10153231379946729/",
  "width": "100%"
}

パラメータ

パラメータはすべてURLエンコードして送信する必要があります。

パラメータ 説明

url

投稿または動画のURL(必須)

maxwidth

埋め込まれるリソースの幅の最大値(任意)maxheightパラメータはサポートされませんので、ご注意ください。これは、埋め込みコードがレスポンシブであり高さは幅によって異なるためです。

callback

呼び出されるJSONコールバック(任意)

omitscript

trueに設定した場合、埋め込みコードにはスクリプトタグは含まれません(任意)