スタートガイド

このドキュメントでは、ページAPIの呼び出しを使用して自分のページに投稿する方法について説明します。

開始する前に

次のものが必要です。

  • Facebookページ(CREATE_CONTENTタスクを実行可能な公開または非公開のページ)
  • そのページのページアクセストークン
  • 以下のアクセス許可
    • pages_manage_metadata
    • pages_manage_posts
    • pages_manage_read_engagement
    • pages_show_list

ベストプラクティス

API呼び出しをテストする場合は、自分のアクセストークンに設定したaccess_tokenパラメーターを含めることができます。ただし、アプリから安全な呼び出しを行う場合は、アクセストークンクラスを使用してください。

ステップ1. ページIDを入手する

タスクを実行するFacebookページのIDのリストとページアクセストークンを入手するには、/user_id/accountsエンドポイントにGETリクエストを送信します(user_idは自分のユーザーID)。

リクエストの例

読みやすくするためにフォーマットしています。page_idのように、太字でイタリックになっている値は、実際の値に置き換えてください。
curl -i -X GET "https://graph.facebook.com/v19.0/user_id/accounts?access_token=user_access_token"

成功すると、アプリはオブジェクトのID配列を含む次のJSON応答を受け取ります。各オブジェクトには、特定のページに関する情報(名前、ID、短期ページアクセストークン、ページ上で実行可能なタスクなど)が含まれます。

{
  "data": [
    {
      "access_token": "page_access_token",
      "category": "Internet Company",
      "category_list": [
        {
          "id": "2256",
          "name": "Internet Company"
        }
      ],
      "name": "Name of this Page",
      "id": "page_id",
      "tasks": [
        "ANALYZE",
        "ADVERTISE",
        "MODERATE",
        "CREATE_CONTENT"
      ]
    },
...

ステップ2. 投稿を公開する

投稿を公開するには、/page_id/feedエンドポイント(page_idは公開先のページのID)に、POSTリクエストを送信します。その際、messageパラメーターをメッセージの内容に設定し、access_tokenパラメーターをページアクセストークンに設定します。

リクエストの例

読みやすくするためにフォーマットしています。page_idのように、太字でイタリックになっている値は、実際の値に置き換えてください。
curl -X POST "https://graph.facebook.com/v19.0/page_id/feed" \
     -H "Content-Type: application/json" \
     -d '{
           "message":"your_message_text",
           "access_token":"page_access_token",
         }'

投稿はすぐに公開されます。

成功すると、アプリは投稿のIDを含む次のJSON応答を受け取ります。

{
  "id": "page_post_id" 
}

Facebookページにアクセスして投稿を確認します。

ステップ3. 投稿を検証する

ページに公開した投稿を検証するには、GETリクエストを/page_id/feedエンドポイントに送信します。

リクエストの例

読みやすくするためにフォーマットしています。page_idのように、太字でイタリックになっている値は、実際の値に置き換えてください。
      curl -i -X GET "https://graph.facebook.com/v19.0/page_id/feed?access_token=page_access_token"

成功すると、アプリはオブジェクトのID配列を含む次のJSON応答を受け取ります。各オブジェクトには、投稿ID、メッセージの内容、投稿作成時間が含まれます。

{
  "data": [
    {
      "created_time": "2020-03-25T17:33:34+0000",
      "message": "Hello World!",
      "id": "422575694827569_917077345377399"  
    },
...
  ]
}

グラフエクスプローラを使用する

グラフエクスプローラツールは、アプリやウェブサイトにコードを追加することなく、Facebook APIに関する実験を行えるようにするUIです。アクセス許可を選択したり、アクセストークンを入手したり、GETPOST、およびDELETEのメソッドをテストしたり、それらのクエリのAndroid、iOS、JavaScript、PHP、およびcURL用コードスニペットを入手したりすることができます。

注: グラフエクスプローラを使用するには、FacebookアプリIDが必要になります。

ステップ1. ページIDを入手する

pages_manage_metadatapages_manage_postspages_manage_read_engagement、およびpages_show_listのアクセス許可([アクセス許可]ドロップダウンメニューに表示されるもの)を選択し、クエリボックスの中で/me/accountsエンドポイントに対するGETリクエストを設定してから、[送信]をクリックします。

ページの名前のすぐ下に表示されるページIDをクリックすると、IDがクエリボックスに移動します。

ステップ2. ページとして投稿する

[ユーザーまたはページ]ドロップダウンメニューの下から、ページのページアクセストークンを選択します。次に、/{page-id}/feedエンドポイントに対するリクエストを指定したPOSTをメソッドとして設定した後、[パラメーター]keymessageに、またvalueを実際の投稿テキストに設定します。[送信]をクリックします。

成功すると、グラフエクスプローラにページ投稿のIDが表示されます。

投稿を表示するには、自分のFacebookページをご覧ください。

ステップ3. 投稿を検証する

GETリクエストを/page-id/feedエンドポイントに送信します。

成功すると、投稿の作成日時、投稿のテキスト、ページ投稿のIDがグラフエクスプローラに表示されます。

次のステップ

Facebookページの管理ガイドで、ページの詳細、アクセストークン、ブロックしたユーザー、ユーザーレビューなど、Facebookページに関する情報を入手して更新する方法について学びます。

ページにリンク、写真、動画を公開する方法を学びます。