Что такое API Facebook?
API Facebook — это набор решений, используемых в качестве основного способа получения данных на платформе и из нее. Он позволяет разработчикам и пользователям приложений получать доступ к функциональным возможностям этой сети: пользовательской информации, фотографиям и видео, новостям и многому другому.
БОНУС: создайте свой виджет Facebook Feed всего за несколько минут!
Как получить ключ API Facebook.
Если вы хотите получить доступ к ключу API Facebook, вам следует зарегистрироваться на портале разработчиков или войти в систему с помощью существующей учетной записи Facebook и подтвердить свою личность. Для этого потребуется выполнить всего несколько простых шагов:
- Шаг 1. Войдите в систему или создайте учетную запись
Перейдите на портал Facebook для разработчиков и нажмите «Войти». Вы можете войти в систему с помощью существующей учетной записи Facebook или создать новую.
- Шаг 2. Начало работы
После того, как вы окажетесь в сервисе, нажмите «Начать работу» в правом верхнем углу главной страницы.
- Шаг 3. Подтвердите учетную запись
Для работы с инструментами разработчика вам необходимо подтвердить свою учетную запись. Нажмите «Продолжить» во всплывающем окне.
Вы можете подтвердить свою учетную запись с помощью своего номера телефона или кредитной карты. Чтобы сделать это с помощью номера телефона, выберите свою страну в раскрывающемся меню, введите свой номер телефона, включая код страны, и нажмите «Отправить как текст». Введите полученный код в поле и нажмите «Подтвердить».
- Шаг 4. Создание приложения
Затем сервис предложит вам создать ваше первое приложение. Все API Facebook и статистика приложений собираются на панели разработчика и не могут быть доступны без создания приложения.
- Шаг 5. Добавьте приложения или сгенерируйте токены доступа для собственных нужд
Самый простой и удобный способ использовать API Facebook — добавить приложения непосредственно на панель управления. Просто выберите тот, который соответствует вашим потребностям.
Перейдите в Tools — Graph API Explorer, чтобы сгенерировать токены доступа для различных типов API, которые вы хотите использовать в своем приложении. Выберите приложение и нужный вам тип токена из раскрывающегося меню в левой части экрана. Затем нажмите «Сгенерировать токен доступа». Вы должны одобрить доступ приложения к вашей странице.
Как использовать примеры API Facebook
Основным продуктом является API Graph, который служит основой для всех других типов API Facebook. По сути, они являются расширениями API Graph, и все продукты Facebook взаимодействуют с ним тем или иным образом.
Каковы некоторые применения консоли разработчика Facebook и представленных там продуктов? Существует множество способов улучшить ваш веб-сайт или приложение, используя контент и некоторые функции этой социальной платформы.
Вы можете отображать различные типы контента социальных сетей — посты, изображения, видео — на вашем веб-сайте или в вашем приложении, чтобы вовлекать и развлекать пользователей.
Но обратите внимание, что если API Graph будет реализован для использования другими пользователями, им также придется сначала согласиться во всплывающем окне. Только после того, как пользователь авторизуется, приложение получает токен доступа от этого пользователя и может использовать его информацию из его профиля Facebook.
Ограничения API Facebook
Помните, что каждый тип API всегда имеет ограничения. Запросы API Graph, сделанные с токеном доступа приложения, учитываются в лимите запросов этого приложения. Количество вызовов приложения — это количество запросов, которые оно может сделать в течение одного часа, и рассчитывается следующим образом:Вызовы в течение одного часа = 200 * Количество пользователей приложения
Интеграция API Facebook
Платформа предлагает несколько готовых решений для не-разработчиков на основе своего API Graph. Все приложения и API Facebook по сути представляют собой серию или набор узлов API Graph. Это означает, что вам все равно нужно будет выполнить шаги 1–3 выше, чтобы создать учетную запись и получить доступ к панели управления. Ниже описаны наиболее часто используемые стандартные приложения API Facebook.
Типы API лент Facebook
API страницы Facebook
Этот тип API обеспечивает доступ к настройкам, контенту и показателям страницы. Он позволяет создавать и отображать публикации, комментарии со страницы, собственный контент страницы и многое другое. Все подробности можно найти в документации API страниц. Не забывайте, что вам нужен токен от пользователя приложения, который владеет или может выполнить требуемую задачу на Странице.
Facebook Video API
Facebook предоставляет два типа — Video API и Live Video API. Оба публикуют видео на Странице, в Группе или на Событии, управляемом пользователем приложения. Video API предназначен для публикации коротких и длинных видео на одной или нескольких Страницах и Группах. Live Video API, в свою очередь, используется для планирования прямой трансляции, потоковой передачи видео в профиль пользователя, группу или на событие, а также для взаимодействия с наблюдающей аудиторией. И, конечно же, вам понадобятся токены доступа для страниц, групп или событий или их комбинации, в зависимости от того, где вы хотите разместить свое видео или прямую трансляцию.
Facebook API Events
Этот тип API также представлен как функциональность Graph API, но он доступен только партнерам по маркетингу Facebook. Он также требует токена доступа от администратора события или группы, создавшего это событие.
Facebook News Feed API
У вас есть два способа доступа и использования ленты новостей Facebook. Описанный API Graph предоставляет возможность доступа к отдельной пользовательской ленте с обновлениями статуса и чтения API сообщений и ссылок, опубликованных пользователями или другими лицами в профиле. Для получения дополнительной информации см. здесь.
Существует также API Public Feed, который позволяет отображать контент, помеченный как «Public», на стороннем сервисе или веб-сайте. Однако этот тип ключа API предоставляется только одобренным издателям медиа, поэтому вы должны сначала подать заявку.
Вам не нужен API группы Facebook для отображения их контента на вашем веб-сайте. Используйте Виджет ленты Facebook! Это дает вам полный контроль над необходимым вам контентом.
API сообщества Facebook
API комментариев Facebook
Доступ к комментариям на Facebook можно получить через API Graph. Поскольку комментарии можно оставлять под различными типами контента, вам необходимо получить доступ к объекту для работы с комментариями на нем.
API отзывов Facebook
Эта часть API Graph представляет объекты, содержащие рекомендацию. Стандартные поля включают дату, рейтинг в звездах, текст отзыва, информацию о пользователе и значок «положительный» или «отрицательный».
Если вам нужен больший контроль над отображаемыми отзывами, вы можете настроить плагин отзывов в соответствии со своими предпочтениями.
API инструментов Facebook
API входа в Facebook
Пример входа в API Facebook можно увидеть во многих веб-сервисах, требующих регистрации. Это предоставляет пользователям быстрый и безопасный способ входа на веб-сайт или в приложение. Этот API собирает токены доступа пользователей для получения информации об их профилях, что возможно только после одобрения пользователя. Если вы хотите использовать этот тип API, ваше приложение должно быть рассмотрено и одобрено администрацией Facebook.
Facebook Places API
API Places Graph — это отдельное решение Facebook, доступное только для платформ Android и iOS. Оно позволяет вашему приложению извлекать информацию о текущих местоположениях пользователей. Оно также позволяет искать и находить места, делиться местоположениями и геотегировать. API Places также требует получения токенов доступа от пользователей. Для интеграции и работы с API Places вам сначала нужно получить Facebook SDK для вашего приложения.
Facebook Payments API
API Payments содержит сведения о платеже, сделанном в определенном приложении. Эти платежи создаются в Facebook Payments и обрабатываются на основе платформы. Этот тип API также требует токена доступа для приложения, которое создает платеж.
Facebook Messenger API
API Messenger — это приложение, которое позволяет вам организовать канал общения на вашем сайте через Facebook Messenger. Решение API Messenger также позволяет разработчику устанавливать управляемые беседы с пользователями. Это позволяет Messenger автоматически отвечать на запросы пользователей с помощью API Send (также известного как API бота Facebook), который отправляет веб-перехватчики на URL-адрес сервера, на котором размещен Messenger.
Оставайтесь на связи со своими клиентами и аудиторией веб-сайта с помощью бесплатной и простой в установке кнопки Messenger!
Типы API маркетинга Facebook
API рекламы Facebook
API маркетинга представляет собой набор конечных точек API Graph которые помогают оптимизировать рекламу на Facebook. API рекламы Facebook позволяет пользователям создавать и управлять рекламными кампаниями, группами объявлений и отдельными рекламными блоками.
API Marketplace Facebook
В настоящее время на Facebook Marketplace существуют только категории «Транспортные средства» и «Недвижимость». Чтобы использовать этот раздел платформы Facebook, вам необходимо создать учетную запись разработчика и подтвердить свой бизнес. Это решение предлагает использование API лидов вместе с веб-хуками разработчиков для лучшей производительности. Для этого вам необходимо создать свое приложение, как описано в этой статье, и отправить его в Facebook для проверки и одобрения.
API Analytics Facebook
Это решение помогает отслеживать и оптимизировать поведение и путь ваших клиентов через мобильные устройства, веб-сайты, ботов, офлайн-ресурсы и другие ресурсы. Для его реализации необходимо интегрировать Facebook SDK с вашим приложением или веб-сайтом. Для получения дополнительной информации см. Справочный центр Analytics.
Facebook Business Manager API
Этот тип API помогает управлять несколькими страницами, рекламными аккаунтами и приложениями в одном месте. В Business Manager вы можете связать бизнес-активы и разрешения для управления разрешениями, запускать кампании от имени бизнеса, создавать рекламные аккаунты и запускать рекламу.
Последние изменения API
Изменения API Facebook включают версионные изменения — те, которые вводятся с выпуском новой версии API. Существуют также неверсионные изменения, которые вводятся вне обычных выпусков. Для обновления до более высокой версии API Facebook существует специальный инструмент обновления API.
Последняя версия — v8.0, выпущенная в августе 2020 года. Теперь она включает:
- Типы приложений — Business, Gaming и None
- Получайте лайки для прямых трансляций
- Шаблон продукта в Messenger для магазинов для отправки продуктов в виде сообщений
Предыдущая версия v7.0, выпущенная в мае 2020 года, будет доступна до августа 2022.
Состояние и ошибки API Facebook
Текущее состояние платформы является здоровым с 1 октября 2020 года. Однако иногда запросы приводят к различным ответам об ошибках API Facebook с соответствующими кодами ошибок. Например, ошибка API Facebook 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 | Ошибка публикации Ссылка |
Документация по API Facebook
Документацию по всем типам API для разработчиков Facebook можно найти в разделе Документы портала разработчиков Facebook. Полный список корневых узлов API Graph можно найти в разделе Справочник по API Facebook. Каждая документация API включает в себя краткое руководство по требуемым разрешениям, а также по использованию и внедрению. Вы можете найти их в разделах «Начало работы» и «Как сделать» каждой конкретной документации.
