Начало работы

В этом документе объясняется, как выполнять вызовы к API Pages для размещения публикаций на Странице.

Прежде чем начать

Вам понадобятся:

• Страница Facebook (это может быть неопубликованная или опубликованная Страница, на которой вы можете выполнять задачу CREATE_CONTENT);
• маркер доступа с этой Странице;
• следующие разрешения:

  • pages_manage_metadata;
  • pages_manage_posts;
  • pages_manage_read_engagement;
  • pages_show_list.

Рекомендации

Шаг 1. Получение ID Страницы

Чтобы получить список ID и маркеров доступа к странице для Страниц Facebook, на которых вы можете выполнять какую-либо задачу, отправьте запрос GET к конечной точке /user_id/accounts, подставив вместо user_id свой ID пользователя.

Пример запроса

curl -i -X GET "https://graph.facebook.com/v21.0/user_id/accounts?access_token=user_access_token"

В случае успеха приложение получит показанный ниже ответ 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. Размещение публикации

Чтобы разместить публикацию, отправьте запрос POST к конечной точке /page_id/feed, подставив вместо page_id ID нужной Страницы и указав в параметре message контент сообщения, а в параметре access_token — маркер доступа к Странице:

Пример запроса

curl -X POST "https://graph.facebook.com/v21.0/page_id/feed" \
     -H "Content-Type: application/json" \
     -d '{
           "message":"your_message_text",
           "access_token":"page_access_token",
         }'

Контент будет сразу же опубликован.

В случае успеха ваше приложение получит следующий ответ JSON с ID публикации:

{
  "id": "page_post_id" 
}

Чтобы посмотреть публикацию, перейдите на свою Страницу Facebook .

Шаг 3. Проверка публикации

Чтобы проверить, была ли размещена публикация на Странице, отправьте запрос GET к конечной точке /page_id/feed:

Пример запроса

      curl -i -X GET "https://graph.facebook.com/v21.0/page_id/feed?access_token=page_access_token"

В случае успеха приложение получит показанный ниже ответ JSON, содержащий массив объектов. Каждый объект содержит ID публикации, контент сообщения и время создания публикации:

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

Использование Graph Explorer

Graph Explorer — это инструмент в пользовательском интерфейсе, позволяющий экспериментировать с различными API Facebook без добавления кода в приложение или на сайт. Вы можете выбирать разрешения, получать маркеры доступа, тестировать методы GET, POST и DELETE, а также получать фрагменты кода этих запросов для Android, iOS, JavaScript, PHP и cURL.

Обратите внимание на то, что для использования Graph Explorer необходим ID приложения Facebook.

Шаг 1. Получение ID Страницы

Выберите разрешения pages_manage_metadata, pages_manage_posts, pages_manage_read_engagement и pages_show_list, которые отображаются в раскрывающемся меню разрешений, задайте для запроса GET конечную точку /me/accounts в поле запроса и нажмите кнопку Отправить.

Нажмите на ID своей Страницы, который отображается непосредственно под ее названием, чтобы скопировать этот ID в поле запроса.

Шаг 2. Публикация от имени Страницы

В раскрывающемся меню Пользователь или Страница выберите маркер доступа к своей Странице. Затем выберите метод POST с запросом к конечной точке /{page-id}/feed, задайте для поля keyпараметров значение message, а для поля value — текст публикации. Нажмите Отправить.

В случае успеха Graph Explorer отобразит ID публикации Страницы.

Зайдите на свою Страницу Facebook, чтобы просмотреть публикацию.

Шаг 3. Проверка публикации

Отправьте запрос GET к конечной точке /page-id/feed.

В случае успеха Graph Explorer покажет время создания публикации, ее текст и ID публикации Страницы.

Дальнейшие действия

Ознакомьтесь с руководством по управлению Страницей Facebook, чтобы узнать, как получать и обновлять информацию о своей Странице Facebook, в том числе сведения о ней, маркеры доступа, заблокированных пользователей и рекомендации пользователей.

Узнайте, как публиковать ссылки, фото и видео на своей Странице.

Дополнительная информация