It's been nearly a year since we announced Graph API v2.0, the new Login, and a Login Review process where we look at and approve any permissions that your app requests beyond public profile, e-mail and friend list. We also announced that all apps requesting these additional permissions must undergo review by April 30, 2015, when we will deprecate Graph API v1.0. That deadline is approaching, and your app may break if you have not been approved for the permissions you're using, or if you haven't upgraded your app to call Graph API v2.0 or greater.
Here are some tips to prevent your apps from breaking after April 30th, 2015.
Submit your app for Login Review now
During Login Review, people on our review team actually use your app to see if the permissions you're requesting are used to improve the user experience, and is tied to a direct purpose within your app.
- Login Review is mandatory if your app asks for more than public_profile, email and user_friends permissions.
- For apps created after April 30th, 2014, Login Review is already being enforced. Apps created before April 30th, 2014 must complete review by April 30th, 2015.
- Decisions from Login Review take effect only after the April 30th, 2015 deadline, which means unapproved permissions will not be taken away until that date. After April 30th, 2015, only approved permissions will appear in the Login Dialog and accessible via API calls to the Graph API. Your app may break if it is expecting unapproved permissions.
- Login Review best practices include only asking for permissions you use; testing your app end to end; providing step by step instructions for the reviewer; checking your app against our Platform Policies for compliance; and sending a screencast video.
Upgrade to Graph API v2.0 and the new Facebook Login
Graph API v2.0 contains some important changes from v1.0. Your app will automatically be upgraded after April 30th, 2015, but to prevent unexpected behaviors, we suggest you update all of your app's API calls well before that date. To help you upgrade, we've built tools to make it easy to see how your app behaves against v2.0:
- You can create v2.0-only Test Users and use these to login to your app to see how it will behave against Graph API v2.0.
- You can upgrade your entire app to v2.0 without code changes — just by flipping a switch in your app's dashboard. But don't forget that you still have to submit your app for Login Review.
- For a subset of apps, we are rolling out a feature that defaults admins, developers, and testers to Graph API v2.0 starting February 26, 2015. You'll receive a Dev Alert if your app is part of this feature and instructions on how to opt out. This feature will not affect public users of your app — only people listed in the role sections of your app's dashboard.
Get Started Now
Submitting for Login Review and upgrading to Graph API v2.0 or greater can happen independently. It doesn't matter which one you do first, or you can do both in parallel.
With the migration deadline coming up on April 30, 2015, we strongly encourage you to plan ahead so that you have enough time to submit your apps for Login Review as well as to third party marketplaces such as Google Play and the App Store.