Instantly share code, notes, and snippets.

Embed
What would you like to do?

Facebook continues to make real-time improvements to its platform to protect people's data. We are making the following changes to maintain trust with people who use our products. These changes are never easy, but by focusing our efforts, we can put stronger protections in place to combat potential abuse. Please find a quick summary of these changes below:

Facebook Login:

  • App review required to ask users to share checkins, likes, photos, videos, events, and groups
  • Following fields are now deprecated and will return empty data: relationship_status, religion, political, friendlists, education, work, about, website, interested_in
  • Following Open Graph permissions are also deprecated and will return empty data: books, fitness, games, music, news, video
  • Taggable friends and mutual friends APIs are now deprecated

Pages API:

  • App review required
  • Page conversations will receive a new thread identifier
  • Require a Page access token with a matching Page for specific endpoints: /agencies, /canvases, /instagram_accounts, /leadgen_forms, /page_backed_instagram_accounts, /promotable_posts, /page/userpermissions
  • Deprecated /checkin_posts API and webhook
  • Remove social context elements: /friends_who_like, /friends_tagged_at, /video_watch_friends, /music_listen_friends
  • App review required to use the following edges: GET /page/events and GET /me/events

Events API:

  • App review required
  • Deprecated content edges on all events: /feed, /posts, /comments, /pictures, /videos, /live_videos, /photos
  • Deprecated user edges on all events: /attending, /interested, /declined, /maybe, /noreply
  • See User Node and Page API sections for details of /events edges on these nodes

Groups API:

  • App review required; API use must meet a specific group admin need
  • Removed some fields returned by edges on groups: to, from, likes, reactions, name_tags, message_tags, with_tags, tags, admin_creator
  • Deprecated APIs that share data about people in groups, including /members, /admins, /owner and a number of undocumented endpoints: /member_requests, /moderators, /former_members, /insights, /links, /tagged

Search API:

  • Deprecated Search API for pages, groups, events, and users

Games:

  • Updated Instant Games context_fetchPlayers API to limit users returned to those who have played in the specified context
  • Deprecated Scores API, Achievements API, /taggable_friends, and /invitable_friends
  • Deprecated /{app-id}/staticresources

App Insights API:

  • Removed age, gender and country information from the app_event metric

Instagram API Platform:

  • Instagram is accelerating the previously announced deprecation of the Instagram API Platform and has lowered rate limits

User Node

  • The following User node fields will no longer return information: about, education, friendlists, interested_in, political, relationship_status, religion, website, work.
  • GET /user/groups and GET /me/groups - This edge no longer returns any fields that contain User identifying information. This applies to all app Users, even app Admins querying their own User ID.
  • App review required to use the following edges: GET /user/events and GET /me/events (apps with user_events permission granted will still require re-review)

Example API Requests & Responses:

/me?fields=relationship_status,political,friendlists,religion,education,work,about,website

{
 "id": {user-id}
}

/{page-id}?fields=context

{
  "id": "<sanitized>"
}

/{event-id}/feed

/{event-id}/posts

/{event-id}/comments

/{event-id}/pictures

/{event-id}/videos

/{event-id}/live_videos

/{event-id}/photos

/{event-id}/attending

/{event-id}/interested

/{event-id}/declined

/{event-id}/maybe

/{event-id}/noreply

{
  "data": []
}

/{group_id}/members

/{group_id}/admins

/{group_id}/owner

{
  "data": [],
  "paging": {
    "cursors": {
      "before": "<sanitized>",
      "after": "<sanitized>"
    }
  }
}

/search?type=page&q=chocolate

{
  "error": {
    "code": 1,
    "error_subcode": 1357045,
    "message": "unknown error (empty response)",
    "type": "http",
  "status": 0
  }
}

/{user-id}/score

/{user-id}/scores

/{app-id}/scores

{
  "error": {
    "message": "(#11) This endpoint has been deprecated.",
    "type": "OAuthException",
    "code": 11,
    "fbtrace_id": "<sanitized>"
  }
}

/{user-id}/achievements

/{app-id}/achievements

{
  "data": []
}

/{user-id}/taggable_friends

/{user-id}/invitable_friends

{
  "data": []
}

/{app-id}/staticresources

{
  "error": {
    "message": "(#100) Tried accessing nonexisting field (staticresources) on node type (Application)",
    "type": "OAuthException",
    "code": 100,
    "fbtrace_id": "<sanitized>"
  }
}

/{app-id}/app_insights/app_event/?aggregateBy=SUM&event_name=fb_ad_network_revenue&breakdowns=['age']

/{app-id}/app_insights/app_event/?aggregateBy=SUM&event_name=fb_ad_network_revenue&breakdowns=['gender']

/{app-id}/app_insights/app_event/?aggregateBy=SUM&event_name=fb_ad_network_revenue&breakdowns=['country']

{
  "error": {
    "message": "(#3011) Currently unavailable",
    "type": "OAuthException",
    "code": 3011,
    "fbtrace_id": "<sanitized>"
  }
}

We never make these platform changes lightly, but at the same time, there's nothing more important to us than privacy and security. We know these changes are not easy and we regret any disruption caused, but we believe these updates will help strengthen trust in our broader developer ecosystem.

For more information about the products affected and some of the reasoning behind these changes, please follow the latest updates on Facebook Developers blog (https://developers.facebook.com/blog/) and the breaking changes doc (https://developers.facebook.com/docs/graph-api/changelog/breaking-changes#4-4-2018).

Please direct any questions below and we will get back to you as soon as possible. For more general or implementation questions regarding the Facebook platform, please visit the Facebook Developer Community Group: https://www.facebook.com/groups/fbdevelopers/.

Facebook would like to thank you and the entire global developer community for working with us to create a better experience for people.

Thank you,

Facebook Developer Support Engineering

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment