Обзор

Pages API — это набор конечных точек Graph API от Facebook, с помощью которых приложения могут создавать параметры и контент Страницы и управлять ими.

Компоненты

Маркеры доступа

Аутентификация API обрабатывается с помощью маркеров доступа. Для работы большинства конечных точек требуются маркеры доступа к Странице. Они уникальны для каждой Страницы, пользователя приложения и самого приложения, а также имеют срок действия. Получить маркер можно только от пользователя приложения, который является владельцем Страницы или может выполнять задачу на ней.

Чтобы получать маркеры доступа от пользователей приложения, можно реализовать вход через Facebook.

Для Страниц, которые были переключены на новую версию, маркер доступа к Странице теперь требуется для всех доступных конечных точек за следующими исключениями:

Graph API

Если вы еще не работали с Graph API, сначала ознакомьтесь с документацией, чтобы узнать больше о социальном графе Meta.

Вход через Facebook

Вход через Facebook позволяет пользователям входить в приложение, а приложению — запрашивать у пользователей доступ к их данным

Вход через Facebook для компаний

Вход через Facebook для компании — это предпочитаемый метод аутентификации и авторизации для тех поставщиков технологий и разработчиков приложений для бизнеса, которым необходим доступ к объектам своих клиентов.

Функции

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

Упоминания

С помощью @упоминаний ваша Страница может публично отвечать пользователям, оставившим публикацию или комментарий к публикации на вашей Странице.

ID пользователей внутри Страницы

Пользователь, взаимодействующий со Страницей, идентифицируется по ID пользователя внутри Страницы (PSID). PSID — это ID, уникальные для каждой пары пользователя и Страницы. Они применяются конечными точками Pages API и Messenger API. С помощью PSID можно идентифицировать как взаимодействия пользователя со Страницей, так и его открытые переписки в Messenger с ней.

Разрешения

Большинство конечных точек требуют наличия одного или нескольких разрешений, которые пользователи приложения должны предоставлять ему. Обычно это делается посредством входа через Facebook, но может также делаться через Business Manager, если компания заявила права на приложение.

Прежде чем пользователь сможет предоставить приложению в рабочем режиме любое разрешение, связанное со Страницей, приложение должно пройти проверку. Для бизнес-приложений, у которых нет режимов, необходимо одобрить расширенный уровень доступа, чтобы разрешения могли предоставлять пользователи без роли в самом приложении или в компании, заявившей на него права.

Поиск Страниц

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

Ограничения числа обращений

Ограничение числа обращений распространяется на все запросы конечных точек Страниц. Текущее количество вызовов приложения можно проверить на панели приложений.

Задачи

Задачи позволяют пользователям выполнять определенные действия на Странице. Когда пользователь взаимодействует со Страницей через приложение, мы сначала проверяем, разрешено ли ему выполнять задачу, соответствующую этому типу действия.

Отдельным пользователям можно разрешить выполнять следующие задачи:

Задача	Допустимые действия
`ADVERTISE`	Создание рекламы Создание неразмещенных публикаций Страницы Создание рекламы, если со Страницей связан аккаунт Instagram
`ANALYZE`	Просмотр статистики Страницы Определение администратора Страницы, который разместил публикацию или комментарий
`CREATE_CONTENT`	Публикация контента на Странице от ее имени
`MANAGE`	Назначение задач на Странице и управление ими
`MANAGE_LEADS`	Просмотр лидов и управление ими
`MESSAGING`	Отправка сообщений от имени Страницы
`MODERATE`	Ответы на комментарии к публикациям Страницы от ее имени Удаление комментариев к публикациям Страницы Публикация контента в Instagram из Facebook, ответ на комментарии и их удаление, отправка сообщений в Direct, синхронизация контактной информации компании и создание рекламы, если со Страницей связан аккаунт Instagram.
`VIEW_MONETIZATION_INSIGHTS`	Просмотр статистики монетизации

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

Платформа Messenger

Ведите в Messenger переписки со своим клиентам и людям, которых интересует ваша Страница.

Webhooks Meta для Страниц

Получайте уведомления в режиме реального времени, когда пользователь оставляет комментарий или реакцию к публикации на Странице.

Проверка приложения

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

Приложение в режиме разработки может запрашивать любые разрешения, но только от пользователей с ролью в нем.

Принцип работы

Вот типичный процесс доступа к API Pages:

Получите маркер доступа пользователя от пользователя приложения посредством входа через Facebook.
Отправьте запрос к конечной точке /me/accounts, чтобы получить ID Страницы и маркер доступа к Странице, к которой пользователь разрешил приложению доступ.
Сохраните возвращенные ID Страницы и маркер доступа к Странице.
Используйте ID и маркер для запроса к узлу Страницы.

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

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

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