Graph API

Версия 2.5

API Graph | API Marketing

API Graph версии 2.5

Выпуск: 7 октября 2015 г. | Доступно до: 12 апреля 2018 г.

Срок действия этой версии истек 12 апреля 2018 г. Чтобы обновить приложения до этой даты, используйте инструмент обновления API. Подробнее об обновлении приложений см. в этом руководстве.

Новые функции

Страницы

  • Разрешения

    • Для работы запроса GET {user_id}/accounts теперь требуется разрешение manage_pages либо pages_show_list — новое разрешение в версии 2.5.
    • Для запросов POST {page_id}/call_to_actions и POST/DELETE {call-to-action-id} требуется новое разрешение pages_manage_cta, введенное в версии 2.5.

  • Управление призывами к действию. Теперь Страницы могут управлять призывами к действию с помощью следующих запросов:

    • GET page/call_to_actions или GET {call-to-action-id} для чтения призыва к действию;
    • POST page/call_to_actions для добавления призыва к действию на страницу;
    • POST {call-to-action-id} для обновления;
    • DELETE {call-to-action-id} для удаления призыва к действию Страницы.

  • Узел Place. Добавлено новое поле для узла Place:

    • overall_rating — средний рейтинг на основании общедоступных отзывов о месте.

Видео

  • Загрузка видео. Мы добавили следующие параметры:

    • slideshow_spec — генерирует видео на основе слайд-шоу с использованием загруженных изображений.
    • secret — используется, чтобы опубликованные видео не появлялись в ленте новостей, хронике или на Странице Facebook, а также не отображались в поиске. Видео можно просматривать и публиковать только с использованием постоянной ссылки. Только для пользователей страницы.
    • social_actions — разрешает или запрещает использовать социальные действия Facebook, например ставить "Нравится", комментировать и публиковать скрытое видео. Только для пользователей страницы.

  • Редактирование видео. Мы добавили следующие параметры:

    • publish_to_videos_tab — публикация общедоступного видео только на вкладке "Видео". В ленте новостей и хронике это видео не публикуется.
    • publish_to_news_feed — публикация общедоступного видео в ленте новостей, хронике и на вкладке "Видео".

Изменения

Страницы

  • Конечная точка публикаций с тегами. Конечная точка GET /{page-id}/tagged содержит все общедоступные публикации, в которых страница не отмечена тегом. Требуется маркер доступа страницы с разрешением manage_pages.

Публикации

  • story_tags теперь возвращает не объект, а массив.

Пользователи

  • Запрос GET /{user-id}?fields=address возвращает ошибку. Поле address, доступное в предыдущих версиях и возвращающее пустое значение, начиная с версии 2.5 будет возвращать ошибку.

Webhooks (ранее — обновления в режиме реального времени)

  • Автоматическое отключение подписок. Если в течение 7 дней происходит сбой URL обратного вызова, мы автоматически отключаем подписки на Webhooks. Их можно включить повторно, используя запрос POST к /subscriptions. Это изменение не применяется к платным подпискам.

  • Обновление существующих подписок. Существующие подписки на Webhooks можно изменить с помощью API /subscriptions. POST /subscriptions изменит подписку для указанной темы, не перезаписывая существующие поля. Чтобы удалить конкретные поля из своей подписки, укажите параметр fields в вызове DELETE /subscriptions.

Упразднения

  • Упразднений нет.

Важные изменения за 90 дней

Страницы

  • Формат URI приложений вкладки Страницы. Поддержка формата URI https://www.facebook.com/{vanity}?v={app_id} прекратится через 90 дней после выпуска этой версии. Используйте https://www.facebook.com/{vanity}?sk={app_id} или https://www.facebook.com/{vanity}/{app_id}.

Webhooks

  • Обновления в режиме реального времени только через HTTPS. Создавать новые подписки с URL обратного вызова в формате, отличном от HTTPS, невозможно. Это относится к обновлениям User, Page, App и Payment.