Facebook APIとは？
Facebook APIは、プラットフォームのデータの入出力を行うための主要な手段として使われる一連のソリューションです。開発者やアプリユーザーがこのネットワークの機能、例えばユーザー情報、写真や動画、メッセージなどにアクセスできるようにします。
ボーナス：数分でFacebookフィードウィジェットを作成しましょう！
Facebook APIキーの取得方法
Facebook APIキーにアクセスしたい場合は、開発者ポータルで既存のFacebookアカウントで登録またはサインアップし、本人確認を承認する必要があります。以下の簡単な手順で進めます：
- ステップ1. ログインまたはアカウント作成
Facebook開発者ポータルにアクセスし、「ログイン」をクリックします。既存のFacebookアカウントでログインするか、新規作成が可能です。
- ステップ2. はじめに
サービス内に入ったら、メインページ右上の「はじめに」を押します。
- ステップ3. アカウントの認証
開発者ツールを使い始めるにはアカウントの承認が必要です。表示されるポップアップで「次へ」を押してください。
電話番号かクレジットカードで認証できます。電話番号の場合は国をドロップダウンから選び、国番号付きの電話番号を入力して「テキストで送信」をクリック。届いたコードを入力し、「認証」を押します。
- ステップ4. アプリを作成する
次に最初のアプリ作成を促されます。FacebookのAPIやアプリの統計はすべて開発者ダッシュボードで管理され、アプリを作成しないとアクセスできません。
- ステップ5. アプリを追加またはアクセストークンを生成する
Facebook APIを使う最も簡単で便利な方法は、ダッシュボードでアプリを追加することです。必要なものを選ぶだけでOKです。
「ツール」→「Graph API Explorer」で、アプリで使いたいAPIのアクセストークンを生成できます。左側のドロップダウンでアプリとトークンの種類を選び、「アクセストークンを生成」をクリック。アプリのページアクセスを承認する必要があります。
Facebook APIの使い方例
主な製品はGraph APIで、これは他のすべてのFacebook APIの基盤となっています。これらはGraph APIの拡張であり、Facebookのすべての製品は何らかの形でこれと連携しています。
Facebook開発者コンソールや提供される製品を使って、どんな活用ができるでしょうか？このソーシャルプラットフォームのコンテンツや機能を使って、ウェブサイトやアプリを大幅にアップグレードできます。
投稿、写真、動画など様々なソーシャルメディアコンテンツをウェブサイトやアプリに表示して、ユーザーの興味を引きつけ、楽しませることが可能です。
ただし、Graph APIを他のユーザーが使う場合、そのユーザーもポップアップで承認する必要があります。ユーザーが認可すると、そのユーザーのアクセストークンがアプリに渡され、Facebookプロフィールの情報を利用できるようになります。
Facebook APIの制限
すべてのAPIタイプには制限があります。アプリのアクセストークンを使ったGraph APIのクエリは、そのアプリのレート制限にカウントされます。1時間あたりの呼び出し回数は以下のように計算されます。1時間あたりの呼び出し回数 = 200 × アプリユーザー数
Facebook APIの連携
このプラットフォームは、Graph APIを基盤とした非開発者向けの既成ソリューションをいくつか提供しています。すべてのFacebookアプリやAPIは基本的にGraph APIのノードの集合体です。つまり、上記のステップ1〜3を完了してアカウントを作成し、ダッシュボードにアクセスする必要があります。以下に一般的に使われるFacebook標準APIアプリケーションを紹介します。
FacebookフィードAPIの種類
FacebookページAPI
このAPIはページの設定、コンテンツ、メトリクスにアクセスできます。ページの投稿やコメント、ページ所有のコンテンツなどを作成・表示可能です。詳細はPages APIドキュメントをご覧ください。ページの管理権限を持つアプリユーザーのトークンが必要です。
Facebook動画API
Facebookが提供するのはVideo APIとLive Video APIの2種類です。どちらもアプリユーザーが管理するページ、グループ、イベントに動画を投稿します。Video APIは短・長動画の投稿に、Live Video APIはライブ配信のスケジューリングやストリーミング、視聴者とのインタラクションに使います。動画やライブ配信を配置する場所に応じて、ページ、グループ、イベントのアクセストークンが必要です。
FacebookイベントAPI
このAPIもGraph APIの機能の一部ですが、Facebookマーケティングパートナーのみ利用可能です。イベントやグループの管理者のアクセストークンが必要です。
FacebookニュースフィードAPI
Facebookニュースフィードにアクセスする方法は2つあります。Graph APIを使うと、ユーザーのステータス更新や投稿、リンクにアクセスできます。詳細はこちら。
また、Public Feed APIは「公開」設定のコンテンツを第三者サービスやウェブサイトに表示可能にします。ただし、このAPIキーは承認されたメディア発行者のみが取得できるため、申請が必要です。
FacebookグループAPIはウェブサイトにコンテンツを表示するためには不要です。Facebookフィードウィジェットを使えば、必要なコンテンツを完全にコントロールできます。
FacebookコミュニティAPI
FacebookコメントAPI
FacebookのコメントへのアクセスはGraph APIを通じて可能です。コメントは様々なコンテンツに付けられるため、対象オブジェクトへのアクセス権が必要です。
FacebookレビューAPI
Graph APIの一部で、推薦を含むオブジェクトを扱います。デフォルトのフィールドには日付、星評価、レビュー本文、ユーザー情報、「ポジティブ」または「ネガティブ」バッジが含まれます。
表示されるレビューをより細かく管理したい場合は、レビューウィジェットをお好みに合わせて調整できます。
FacebookツールAPI
FacebookログインAPI
Facebook APIのログイン例は、多くの登録が必要なウェブサービスで見られます。ユーザーに迅速かつ安全なログイン手段を提供し、ユーザー承認後にプロフィール情報を取得します。このAPIを使うには、アプリの審査とFacebook管理者の承認が必要です。
FacebookプレイスAPI
Places GraphはAndroidとiOS向けのFacebook独自ソリューションです。ユーザーの現在地情報を取得し、場所の検索や発見、位置共有、ジオタグ付けが可能です。ユーザーのアクセストークンが必要で、利用にはFacebook SDKの導入が必要です。
FacebookペイメントAPI
ペイメントAPIは特定アプリ内で行われた支払いの詳細を扱います。Facebookペイメント上で作成・処理され、支払いを作成するアプリのアクセストークンが必要です。
FacebookメッセンジャーAPI
Messenger APIはFacebookメッセンジャーを使ってウェブサイト上に会話チャネルを作るアプリです。開発者はユーザーとのガイド付き会話を構築でき、Send API（FacebookボットAPIとも呼ばれる）を使って自動応答が可能です。これはメッセンジャーがホストされているサーバーのURLにWebhookを送信します。
無料で簡単に設置できるメッセンジャーボタンで、クライアントやウェブサイトの訪問者とつながりましょう！
FacebookマーケティングAPIの種類
Facebook広告API
マーケティングAPIはGraph APIのエンドポイント群で、Facebook広告の最適化を支援します。広告キャンペーン、広告セット、個別広告ユニットの作成・管理が可能です。
FacebookマーケットプレイスAPI
現在、Facebookマーケットプレイスには車両と不動産のカテゴリのみがあります。この機能にアクセスするには開発者アカウントを作成し、ビジネス認証を受ける必要があります。Lead APIと開発者用Webhookを組み合わせてパフォーマンスを向上させることが推奨されます。アプリを作成し、Facebookの審査を受けて承認を得る必要があります。
FacebookアナリティクスAPI
このAPIはモバイル、ウェブ、ボット、オフラインなど複数のチャネルから顧客の行動や経路を追跡・最適化します。実装にはFacebook SDKの統合が必要です。詳細はアナリティクスのヘルプセンターをご覧ください。
FacebookビジネスマネージャーAPI
複数のページ、広告アカウント、アプリケーションを一元管理できます。ビジネスマネージャーではビジネス資産や権限の管理、企業名義でのキャンペーン運用、広告アカウント作成や広告購入が可能です。
最新のAPI変更点
Facebook APIの変更には、バージョンリリースに伴うバージョン管理された変更と、通常のリリース外で行われる非バージョン変更があります。APIのバージョンアップにはAPIアップグレードツールを使います。
最新バージョンは2020年8月にリリースされたv8.0で、以下の機能が追加されました：
- アプリタイプ：ビジネス、ゲーム、なし
- ライブ動画の「いいね！」取得
- Messengerのショップ向けに商品をメッセージとして送るプロダクトテンプレート
前バージョンのv7.0は2020年5月リリースで、2022年8月まで利用可能です。
Facebook APIのステータスとエラー
プラットフォームの状態は2020年10月1日以降良好ですが、リクエスト時に様々なFacebook APIエラーコードが返されることがあります。例えば、エラー400（Bad request）はクエリがサポートされなくなり、新しいアクセストークンの生成が必要なことを示します。主なエラーコードは以下の通りです：
| コード | 名称 |
| 102 | APIセッション |
| 1 | API不明 |
| 2 | APIサービス |
| 3 | APIメソッド |
| 4 | API呼び出し過多 |
| 17 | APIユーザー呼び出し過多 |
| 10 | API権限拒否 |
| 190 | アクセストークン期限切れ |
| 200-299 | API権限（権限により異なる） |
| 341 | アプリ制限到達 |
| 368 | ポリシー違反による一時ブロック |
| 506 | 重複投稿 |
| 1609005 | リンク投稿エラー |
Facebook APIドキュメント
Facebook開発者APIのすべてのドキュメントは、Facebook開発者ポータルのドキュメントセクションで確認できます。Graph APIのルートノード一覧はFacebook APIリファレンスにあります。各APIドキュメントには必要な権限や使い方、実装方法の簡単なチュートリアルが含まれており、「はじめに」や「ガイド」セクションで確認可能です。
