Graph API

Версия 2.12

API Graph | API Marketing

Записи в журнале изменений разделяются на следующие категории:

  • Новые функции: новые продукты или услуги, включая новые узлы, поля и границы контекста.
  • Изменения: изменения существующих продуктов или услуг (за исключением упраздненных элементов).
  • Упраздненные элементы: существующие продукты или услуги, которые будут упразднены.
  • Важные изменения за 90 дней: изменения, которые вступят в силу через 90 дней после даты выпуска версии (в эту категорию входят и случаи упразднения элементов).

Категории Новые функции, Изменения и Упраздненные элементы относятся только к этой версии. Категория Важные изменения за 90 дней относится ко всем версиям.

Категория Важные изменения здесь не упоминается, так как она не привязана к определенным выпускам.

API Graph

Выпуск 30 января 2018 г. | Доступно до 5 мая 2020 г. | Запись в блоге

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

Новых функций нет.

Изменения

Webhooks

  • Тема Страницы — свойства sender_name и sender_id заменены одним свойством from в подписках Mentions для Workplace.

Упраздненные элементы

Упраздненных элементов нет.

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

Мероприятия

  • GET /event — для действий GET со следующими полями теперь необходим маркер доступа администратора соответствующего мероприятия.

    • is_draft
    • can_guests_invite
    • guest_list_enabled
    • attending
    • interested
    • declined
    • maybe
    • noreply
    • roles
    • ticket_tiers
    • feed
    • posts
    • comments
    • photos
    • live_videos

    Кроме того, упразднены следующие поля:

    • is_viewer_admin
    • can_viewer_post
  • POST /event — для действий POST теперь необходим маркер доступа администратора соответствующего мероприятия.

  • Объекты мероприятия — для действий GET с такими объектами теперь необходим маркер доступа администратора соответствующего мероприятия. Это повлияет на следующие узлы:

    • GET /post
    • GET /comment
    • GET /photo
    • GET /live_video

Группы

  • GET /group — для действий GET со следующими полями и границами контекста теперь необходим маркер доступа администратора соответствующей группы.

    Поля

    • member_request_count
    • owner
    • privacy
    • updated_time

    Границы контекста

    • GET /albums*
    • GET /admins
    • GET /docs*
    • GET /events*
    • GET /feed*
    • GET /files
    • GET /former_members
    • GET /groups*
    • GET /links*
    • GET /live_videos*
    • GET /member_requests
    • GET /members
    • GET /moderators
    • GET /posts*
    • GET /tagged
    • GET /videos*

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

  • POST /group — для действий POST теперь необходим маркер доступа администратора соответствующей группы.

  • Объекты группы — для запросов GET с такими объектами теперь необходим маркер доступа администратора соответствующей группы. Это повлияет на следующие узлы:

    • GET /album
    • GET /comment
    • GET /doc
    • GET /event
    • GET /live_video
    • GET /photo
    • GET /post

Страницы

  • Отчетность о показах — у метрики organic не будет значений not paid и not viral, а только not paid. Вводится новый набор метрик nonviral, который соответствует прежнему определению метрики organic в версии 2.11 и более ранних. Теперь метрики вычисляются так:

    • все показы = платные показы + органические показы
    • органические показы = вирусные показы + невирусные показы
Это повлияет на следующие конечные точки:
  • GET /page/insights
  • GET /post/insights

  • Статистика — изменились результаты, возвращаемые метриками like и unlike.

    Нижеприведенные метрики like

    • /page/insights/page_fans_by_like_source_unique
    • /page/insights/page_fans_by_like_source

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

    • Ads
    • Other
    • Page Suggestions
    • News Feed
    • Your Page
    • Restored Likes from Reactivated Accounts
    • Search

    Нижеприведенные метрики unlike

    • /page/insights/page_fans_by_unlike_source_unique
    • /page/insights/page_fans_by_unlike_source

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

    • Deactivated or Memorialized Account Removals
    • Suspicious Account Removals
    • Unlikes from Page, Posts, or News Feed
    • Unlikes from Search
    • Underage Account Removals
    • Unlikes from Page Suggestions
    • Other

Видео

  • Видео на Странице — теперь, чтобы поле source возвращало значение для видео на Странице, пользователю, отправляющему запрос, должна быть назначена роль на этой Странице. Это повлияет на следующие конечные точки:

    • GET /video
    • GET /post
    • GET /page/videos
    • GET /page/posts
    • GET /page/feed

API Marketing

Выпуск 30 января 2018 г. | Публикация в блоге

Чтобы узнать об изменениях, ознакомьтесь с этой записью в блоге.