Tool to Help Developers Upgrade to Graph API v2.0 for Facebook Without Code Changes

Monday, February 9, 2015

Last year Facebook launched Graph API v2.0 and the new Facebook Login. On April 30, all apps will automatically be upgraded to Graph API v2.0 and the new Login. To help developers upgrade and redeploy in December Facebook introduced the ability for developers to use Test Users to see how an app will behave against Graph API v2.x without having to update code.

Now Facebook is launching a button that allows an app to use Graph API v2.0 by default. To make the change, go to the Migration tab of an app's Settings page and simply switch the “Use Graph API v2.0 by default” setting to ON (or OFF to revert your app back to its original state).

Here's what will happen after you enable this migration:

- People who log into your app will see the new Facebook Login dialog which gives them greater control over what information they share. This means people will be able to decline to grant one or more of the permissions you're requesting.

- Only the permissions which remain available in v2.0 will be shown in the login dialog and be useable when making API calls.

- People logging into your app for the first time will be known by an app-scoped user ID. If you enable and then later disable this migration, people who first logged into your app while the migration was enabled will still be known by the same app-scoped ID after the migration is disabled.

- Calls to /me/friends will return the user's friends who also use the app.

For the full list of changes, see the changelog.

If your app relies on some of the features which have changed or been deprecated in v2.0, Facebook suggests you do not enable your migration using this new tool, and instead manually update your app to call Graph API v2.0 or above.

For more information on how to upgrade to v2.0, Facebook has created an Upgrade Guide. If your app is already able to handle these changes, or if you're not using features which have changed, you can now instantly upgrade your app with the flick of a switch.