Version 2.12

Graph API | Marketing API

Graph API

Released January 30, 2018 | Available until May 5, 2020 | Blog Post

• New Features
• Changes
• Deprecations
• 90-Day Breaking Changes

New Features

No new features.

Changes

• Webhooks

Webhooks

• Page Topic — sender_name and sender_id have been replaced with a single from property in Mentions for Workplace subscriptions.

Deprecations

No deprecations.

90-Day Breaking Changes

• Events
• Groups
• Pages
• Videos

Events

• GET /event — GET operations on the following fields now require an access token of an Admin of the Event.

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

  In addition, the following fields have been deprecated:

  • is_viewer_admin
  • can_viewer_post

• POST /event — POST operations now require an access token of an Admin of the Event.

• Event-Owned Objects — GET operations on Event-owned objects now require an access token of an Admin of the Event. This affects the following nodes:

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

Groups

• GET /group — GET operations on the following fields and edges now require an access token of an Admin of the Group:

  Fields

  • member_request_count
  • owner
  • privacy
  • updated_time

  Edges

  • 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*

  In the coming weeks, edges marked with an asterisk (*) will once again allow requests from non-Admin Group members. However, responses will not include User information unless the request is made with an access token of an Admin of the Group.

• POST /group — POST operations now require an access token of an Admin of the Group.

• Group-Owned Objects — GET operations on Group-owned objects now require an access token of an Admin of the Group. This affects the following nodes:

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

Pages

• Impressions Reporting — Redefining the use of organic from not paid, not viral to not paid and introducing a new sets of metrics called nonviral which will match the old definition of organic from and earlier versions. The new relationship:

  • total impressions = paid impressions + organic impressions
  • organic impressions = viral impressions + nonviral impressions

• Insights — Changing the results returned by like and unlike metrics.

  The following like metrics:

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

  now return:

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

  The following unlike metrics:

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

  now return:

  • 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

Videos

• Page-owned videos — The source field will no longer be returned for Page-owned videos unless the User making the request has a role on the owning Page. This affects the following endpoints:

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