April 4, 2018

Accompanying blog post: API and Other Platform Product Changes

• App Insights API
• Events API
• Facebook Login
• Games
• Groups API
• Invitable Friends API
• Messenger Platform
• Mutual Friends
• Open Graph
• Pages API
• Search API
• Taggable Friends
• Tagged Users
• User Node

App Insights API

The following breakdowns have been removed from the app_event metric:

• age
• country
• gender

Events API

• All apps, including formerly approved apps, must undergo App Review in order to gain access to the API.

• GET /events — You can no longer get the following edges:

  • attending
  • comments
  • declined
  • feed
  • interested
  • live_videos
  • maybe
  • noreply
  • photos
  • pictures
  • posts
  • videos

Facebook Login

• More Stringent Login Review — Apps requesting the following permissions are now subject to heightened scrutiny during Login Review:

  • user_events
  • user_friends
  • user_likes
  • user_managed_groups
  • user_photos
  • user_posts
  • user_tagged_places
  • user_videos

• Deprecated Permissions — The following permissions are deprecated:

  • user_religion_politics
  • user_relationships
  • user_relationship_details
  • read_custom_friendlists
  • user_about_me
  • user_education_history
  • user_work_history
  • user_website
  • user_actions.books
  • user_actions.fitness
  • user_actions.music
  • user_actions.video
  • user_actions.news
  • user_games_activity

Games

• Instant Games context.getPlayersAsync() will only return players who have actively played the game in the current context within the last 90 days.

• Returns Empty Set — The following nodes and edges will now only return empty data sets:

  • /achievement_id
  • /app/achievements
  • /app/scores
  • /user/achievements
  • /user/invitable_friends
  • /user/scores
  • /user/taggable_friends

• Deprecated Edges — The following edges have been removed:

  • /app/staticresources

Groups API

See Corrections below.

• App Review — All apps, including formerly approved apps, must undergo App Review in order to gain access to the API.

• Deprecated Edges and Fields — The following Group node fields and edges have been removed:

  • /group/admins
  • /group/members

• GET /group/albums — You can no longer get the following fields and edges on Albums returned by this edge:

  • from
  • likes
  • reactions

• GET /group/albums?fields=photos — You can no longer get the following fields on Photos in Albums returned by this edge:

  • from
  • likes
  • name_tags
  • reactions
  • tags

• GET /group/docs — You can no longer get the from field on Docs returned by this edge.

• GET /group/files — You can no longer get the from field on Files returned by this edge.

• GET /group/feed — You can no longer get the following fields and edges on Posts returned by this edge:

  • admin_creator
  • from
  • likes
  • message_tags
  • reactions
  • to
  • with_tags

• GET /group/feed?fields=comments — You can no longer get the following fields and edges on Comments on Videos returned by this edge:

  • admin_creator
  • from
  • likes
  • message_tags
  • reactions

• GET /group/events — You can no longer get the following fields and edges on Events returned by this edge:

  • admins
  • attending
  • declined
  • interested
  • live_videos
  • maybe
  • noreply
  • owner
  • pictures
  • posts
  • roles
  • videos

• GET /group/videos — You can no longer get the following fields and edges on Videos returned by this edge:

  • from
  • tags
  • likes
  • reactions

Invitable Friends API

GET operations on the /user/invitable_friends edge will now return an empty data set. The edge will be removed entirely in the near future.

Messenger Platform

Customer Matching via the Send API is now in closed beta, and is no longer accepting applications for new Pages. Pages that have previously been approved to use customer matching via the Send API and the Customer Matching API may continue to use the feature.

Mutual Friends

The Mutual Friends API is no longer available.

Open Graph

The following Open Graph Action types will no longer return information:

• books.rates
• books.reads
• books.quotes
• books.wants_to_read
• fitness.bikes
• fitness.runs
• fitness.walks
• music.listens
• music.playlists
• news.reads
• videos.rates
• videos.wants_to_watch
• videos.watches

Pages API

App Review — All new apps must undergo App Review in order to gain access to the API. App Review will resume in the coming weeks. Once App Review resumes, formerly approved apps or apps that have not been reviewed must undergo App Review or lose access until they are approved.

The /page/checkin-post endpoint and checkins Webhooks has been deprecated.

New scoped_thread_key as the thread identifier for the /page/conversations endpoint and conversation Webhooks payloads. Both scoped_thread_key and thread_id values will work for all related endpoints. After 90 days, the scoped_thread_key and thread_id values will be the same.

The following Social Context Elements have been removed:

• /open-graph-context-id/friends_who_like
• /open-graph-context-id/friends_tagged_at
• /open-graph-context-id/video_watch_friends
• /open-graph-context-id/music_listen_friends

GET /page — GET operations on the following fields and edges now require a Page Access Token of the page:

• /page/agencies
• /page/canvases
• /page/instagram_accounts
• /page/leadgen_forms
• /page/page_backed_instagram_accounts
• /page/promotable_posts
• /page/userpermissions

POST /page — POST operations on the following fields and edges now require a Page Access Token of the page:

• /page/agencies
• /page/page_backed_instagram_accounts
• /page/userpermissions

Search API

You can no longer use the /search endpoint with the following object types:

• event
• group
• page
• user

Taggable Friends API

All endpoints for the Taggable Friends API will now return an empty data set:

• /user/taggable_friends edge
• /user-taggable-friend node

These endpoints will be deprecated in the near future.

Tagged Users

Apps can no longer get photo, video, or post objects for non-app Users who have been tagged by an app User, even if the non-app Users have previously enabled the Posts on my timeline sharing setting in the Apps others use section of their Facebook profile's App Settings. This affects GET operations on these objects, as well as any edges that may return these objects.

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. For a list of these fields, please refer to the Groups API section of the changelog.

Corrections

The following endpoints were erroneously listed and will not be deprecated at this time.

• GET /group?fields=owner