Facebook Graph API v2.3 is now available to use, adding new login permissions, a new debug mode for developers and updates to Real-time Updates. Along with it, more APIs are being depreciated towards the end of June 2015.
For starters, Facebook is introducing new permissions and changing old ones:
user_posts
Permission – This permission allows an app to access the posts on a person’s Timeline. This includes the someone’s own posts, posts they are tagged in and posts other people make on their Timeline. Previously, this content was accessible with theread_stream
permission. Theuser_posts
permission is automatically granted to anyone who previously hadread_stream
permission.publish_pages
Permission – This new permission is required to publish as a Page. Previouslypublish_actions
was required. People who grantedmanage_pages
andpublish_actions
before v2.3 have automatically been grantedpublish_pages
. If anyone logs in via v2.3, you’ll need to requestpublish_pages
explicitly in addition tomanage_pages
.read_custom_friendlists
Permission – Is the new name forread_friendlists
Login permission. This is to clarify that the permission grants access to a person’s custom friendlists, not the full list of that person’s friends.
On June 28th 2015, the following APIs will be removed:
- Edges and Permissions –
/v2.3/{user_id}/interests
and/v2.3/{user_id}/activities
edges as well asuser_interests
anduser_activities
permissions are deprecated in v2.3. From June 23, 2015 onwards, in all previous API versions, these endpoints will return empty arrays, the permissions will be ignored if requested in the Login Dialog, and will not be returned in calls to the/v2.3/me/permissions
endpoint. - Page RSS Feed endpoint – at
https://www.facebook.com/feeds/page.php
is now deprecated and will stop returning data from June 23, 2015. Developers should call the Graph API’s/v2.3/{page_id}/feed
endpoint instead. This returns JSON rather than RSS/XML. - Social Plugins – The following are now deprecated and will no longer render after June 23, 2015:
- Facepile Plugin
- Recommendations Feed Plugin
- Activity Feed Plugin
In addition to the above, the changelog also indicates a number of changes to video uploads, Page APIs and the API responses. You should check the complete changelog to see what other changes could affect you.