Graph API¶

¶Классификация разрешений

Для доступа к данным через Graph API разработчик должен запросить у пользователя разрешения (permissions). Разрешения делятся на несколько категорий:

¶Стандартные разрешения (Default Permissions)

Доступны без дополнительного утверждения. К ним относятся:

• public_profile — имя, аватар, возрастной диапазон, пол, локаль.
• email — подтверждённый email-адрес.

¶Разрешения с утверждением (Advanced Permissions)

Требуют прохождения процедуры утверждения приложения (App Review) со стороны Meta (организация признана экстремистской и запрещена в РФ). Примеры:

• user_friends — доступ к списку друзей.
• user_posts — доступ к публикациям пользователя.
• pages_manage_posts — управление публикациями на странице.
• ads_management — управление рекламными кампаниями.

¶Разрешения для бизнес-аккаунтов (Business Permissions)

Используются для доступа к данным рекламных аккаунтов и бизнес-страниц. Например:

• ads_read — чтение рекламных данных.
• business_management — управление бизнес-аккаунтами.

¶Применение

Graph API широко используется в различных сферах:

¶Социальные приложения

Разработчики используют API для интеграции входа через Facebook (Login with Facebook), публикации контента от имени пользователя, доступа к списку друзей и другим социальным данным.

¶Маркетинг и реклама

API позволяет управлять рекламными кампаниями, создавать аудитории, загружать пиксели и анализировать эффективность рекламы через Facebook Ads API (часть Graph API).

¶Управление страницами и сообществами

Владельцы страниц Facebook (организация признана экстремистской и запрещена в РФ) и администраторы групп используют API для автоматизации публикаций, модерации комментариев, анализа вовлечённости.

¶Интеграция с другими платформами

Graph API используется для интеграции Facebook с CRM-системами, платформами электронной коммерции, инструментами аналитики и чат-ботами (через Messenger Platform).

¶Ограничения и политика

¶Лимиты запросов

Meta (организация признана экстремистской и запрещена в РФ) устанавливает лимиты на количество запросов в единицу времени (rate limits). Для пользовательских токенов лимит составляет 200 запросов в час на пользователя, для страничных — 200 запросов в час на страницу. Для приложенческих токенов лимит зависит от количества пользователей приложения.

¶Запрет на определённые данные

После скандала с Cambridge Analytica доступ к данным друзей пользователя (кроме тех, кто также использует приложение) был существенно ограничен. Запрос user_friends возвращает только друзей, которые уже установили приложение.

¶Необходимость утверждения

Для доступа к чувствительным данным (например, user_posts, user_photos) приложение должно пройти процесс App Review, который включает проверку цели использования данных и соблюдения политики конфиденциальности.

¶Примеры запросов

¶Получение информации о пользователе

`` GET /v19.0/me?fields=id,name,email&access_token=TOKEN ``

Ответ: ``json { "id": "123456789", "name": "Иван Иванов", "email": "ivan@example.com" } ``

¶Получение списка друзей

`` GET /v19.0/me/friends?access_token=TOKEN ``

Ответ: ``json { "data": [ {"id": "987654321", "name": "Петр Петров"} ], "summary": {"total_count": 1} } ``

¶Публикация на странице

`` POST /v19.0/PAGE_ID/feed?message=Привет, мир!&access_token=PAGE_TOKEN ``

Ответ: ``json { "id": "PAGE_ID_POST_ID" } ``

¶Критика

Graph API неоднократно подвергался критике за сложность и частые изменения. Разработчики отмечают, что версионирование и постоянное ужесточение правил доступа усложняют поддержку приложений. Кроме того, процесс утверждения разрешений (App Review) часто описывается как непрозрачный и длительный.

Другой аспект критики — недостаточная документация. Несмотря на наличие официальной документации, некоторые функции API описаны неполно или требуют дополнительных экспериментов для понимания.

¶Сравнение с другими API

Graph API отличается от REST API других социальных сетей (например, Twitter API, VK API) графовой моделью данных и более строгими ограничениями на доступ к данным. В отличие от VK API, где доступ к списку друзей практически не ограничен, в Graph API он требует специального разрешения и возвращает только друзей, использующих приложение.

¶Источники

• Официальная документация Graph API (Meta for Developers)
• История изменений Graph API (Facebook Developer Blog)
• Статья «Facebook Graph API: A Comprehensive Guide» (Smashing Magazine)
• Материалы конференции f8 2010, 2013, 2018 годов
• Обсуждения на Stack Overflow по тегу facebook-graph-api