Hello,
I just got a ping on facebook about my facebook app (facebook connect). There are a lot of changes coming to the API.
Will these changes affect Facebook Connect and its functionality? Is there anything that administrators should be aware of?
Developer Roadmap
In the spirit of openness and transparency and to adhere to our [URL="https://developers.facebook.com/roadmap/change-policy/"]Breaking Change Policy[/URL="https://developers.facebook.com/roadmap/change-policy/"], we publish this roadmap to help developers plan for changes that may require code modifications. Like all roadmaps, it may shift slightly, but we will share insight into what is happening as details become available. We encourage developers to [URL="https://developers.facebook.com/settings"]subscribe[/URL="https://developers.facebook.com/settings"] to our [URL="https://developers.facebook.com/blog"]blog[/URL="https://developers.facebook.com/blog"], where we announce rollout plans and timing.
July 10, 2013
The following changes can be enabled/disabled using the "July 2013 Breaking Changes" [URL="https://developers.facebook.com/roadmap/migrations"]migration[/URL="https://developers.facebook.com/roadmap/migrations"] until July 10th when they will go into effect permanently for everyone:
New APIs for comment replies
As announced [URL="https://developers.facebook.com/blog/post/2013/04/03/new-apis-for-comment-replies/"]here[/URL="https://developers.facebook.com/blog/post/2013/04/03/new-apis-for-comment-replies/"], this migration enables the updated comment APIs.
Social plugins will require an absolute URL in the 'href' parameter
[URL="https://developers.facebook.com/docs/plugins/"]Social plugins[/URL="https://developers.facebook.com/docs/plugins/"], such as the Like Box and Like Button, will require an absoute URL in the 'href' parameter.
Stream table will throw exception with invalid filter_key
Query [URL="https://developers.facebook.com/docs/reference/fql/stream_filter"]stream_filter[/URL="https://developers.facebook.com/docs/reference/fql/stream_filter"] table for a set of valid stream filters. The [URL="https://developers.facebook.com/docs/reference/fql/stream"]stream[/URL="https://developers.facebook.com/docs/reference/fql/stream"] table will throw an exception if called with an invalid 'filter_key' option.
Removing 'publish_checkins' permissions
Publishing a Checkin object is deprecated in favor of creating an Open Graph story with a [URL="https://developers.facebook.com/docs/opengraph/guides/tagging/#places"]location[/URL="https://developers.facebook.com/docs/opengraph/guides/tagging/#places"] attached. You can also create a Post with a location attached using the 'publish_steam' extended permission.
FQL Checkin table 'page_id' change
We are renaming 'page_id' to 'target_id' for the [URL="https://developers.facebook.com/docs/reference/fql/checkin"]Checkin[/URL="https://developers.facebook.com/docs/reference/fql/checkin"] table.
Removing 'version' field for Groups
We introduced 'version' field to indicate whether the group was created prior to launch of the current groups product in October 2010. We are removing this field as all Groups on Facebook are now the same version. This impacts both [URL="https://developers.facebook.com/docs/reference/api/group/"]Group Graph API[/URL="https://developers.facebook.com/docs/reference/api/group/"] and [URL="https://developers.facebook.com/docs/reference/fql/group"]Group FQL Table[/URL="https://developers.facebook.com/docs/reference/fql/group"].
Photos will no longer return larger sizes than the uploaded version
'images' field in [URL="https://developers.facebook.com/docs/reference/fql/photo"]photos[/URL="https://developers.facebook.com/docs/reference/fql/photo"] and [URL="https://developers.facebook.com/docs/reference/fql/photo"]photo_src[/URL="https://developers.facebook.com/docs/reference/fql/photo"] table will no longer return image sizes larger than the original uploaded version of the photo.
Can not create multiple create actions for the same Open Graph object
We are no longer allowing multiple create actions for the same Open Graph object, as documented [URL="https://developers.facebook.com/docs/opengraph/creating-object-types/"]here[/URL="https://developers.facebook.com/docs/opengraph/creating-object-types/"].
Deprecating 'comments' field from 'stream' FQL table
We are deprecating the 'comments' field from 'stream' FQL table. Please select the 'comment_info' column to fetch the 'can_comment' and 'comment_count' fields (formerly called 'can_post' and 'count'), and use the comment table directly to retrieve the list of comments.
Removing 'xid', 'reply_xid', 'username' and 'comments' from 'comment' FQL table
We are removing the fields on the FQL 'comment' table that were used exclusively for legacy [URL="https://developers.facebook.com/docs/reference/plugins/comments/"]Comments Plugins[/URL="https://developers.facebook.com/docs/reference/plugins/comments/"] -- 'xid', 'reply_xid', 'username' and 'comments'. We now treat comments the same across plugins and within Facebook. Please query for comment replies left on the plugin [URL="https://developers.facebook.com/docs/graphapi/guides/comments/"]the same way[/URL="https://developers.facebook.com/docs/graphapi/guides/comments/"] as you would for other comments.
Removing 'count' from 'comments' Graph API connection
We are removing the undocumented 'count' field on the 'comments' connection in the Graph API. Please request '{id}/comments?summary=true' explicitly if you would like the summary field which contains the count (now called 'total_count')
The following changes will go into effect on July 10, 2013:
Mobile App Install Ads change
We are updating the [URL="https://developers.facebook.com/docs/reference/ads-api/mobile-app-ads/"]Creative Spec[/URL="https://developers.facebook.com/docs/reference/ads-api/mobile-app-ads/"] parameter 'app_platform_type' to 'mobile_store'. The possible values for mobile_store are now "itunes", "itunes_ipad", and "google_play".
Conversion spec and tracking pixel ID changes
We are deprecating the use of 'tracking_pixel_id' when specifying the desire to track a [URL="https://developers.facebook.com/docs/reference/ads-api/offsite-pixels/"]conversion pixel[/URL="https://developers.facebook.com/docs/reference/ads-api/offsite-pixels/"] in an ad. You should instead specify the pixel in the newly launched [URL="https://developers.facebook.com/docs/reference/ads-api/tracking-specs/"]tracking_specs[/URL="https://developers.facebook.com/docs/reference/ads-api/tracking-specs/"] field. We are also deprecating the use of [URL="https://developers.facebook.com/docs/reference/ads-api/conversion-specs/"]conversion specs[/URL="https://developers.facebook.com/docs/reference/ads-api/conversion-specs/"] in bid types that are not optimized for actions (e.g. CPM, CPC, and oCPM when no bid value is placed on actions). You should instead use [URL="https://developers.facebook.com/docs/reference/ads-api/tracking-specs/"]tracking_specs[/URL="https://developers.facebook.com/docs/reference/ads-api/tracking-specs/"] to track conversions for these bid types.
Custom Audiences change
We have changed the targeting spec parameter 'excluded_user_adclusters' to be 'excluded_custom_audiences'. Additionally, the endpoint to create and retrieve your custom audiences is now: https://graph.facebook.com/(act_adac...ustomaudiences.
Accessing link stats change
App access tokens will be required for accessing the [URL="https://developers.facebook.com/docs/reference/fql/link_stat"]link_stat[/URL="https://developers.facebook.com/docs/reference/fql/link_stat"] FQL table. App access tokens will also be required for retrieving data from Graph API endpoint for link stats, ie: https://graph.facebook.com/?id=http://example.com.
Graph API search changes
App access tokens will be required for all search Graph API calls except Places and Pages. Search for application will no longer be supported.
Open Graph apps using custom actions for fitness, books, movies, and TV
As [URL="https://developers.facebook.com/blog/post/2013/03/08/improving-facebook-for-books--movies--tv-and-fitness/"]announced[/URL="https://developers.facebook.com/blog/post/2013/03/08/improving-facebook-for-books--movies--tv-and-fitness/"] in March, any apps that previously used custom actions to represent this type of sharing will need to move common actions by July 10, 2013.
Removing 'page_friends_of_fans' metric
We are removing the metric: 'page_friends_of_fans' from the Insights Dashboard and the [URL="https://developers.facebook.com/docs/reference/api/insights/"]Insights API[/URL="https://developers.facebook.com/docs/reference/api/insights/"].
Removing the ability to "Select All" or "Pre-Select" for Requests
As part of our efforts to improve user sentiment, we have [URL="https://developers.facebook.com/policy/#integration"]updated our platform policy[/URL="https://developers.facebook.com/policy/#integration"] so that apps may not offer a select all option or pre-select multiple recipients to receive requests. Other Request dialog functionality will remain the same.
I just got a ping on facebook about my facebook app (facebook connect). There are a lot of changes coming to the API.
Will these changes affect Facebook Connect and its functionality? Is there anything that administrators should be aware of?
Developer Roadmap
In the spirit of openness and transparency and to adhere to our [URL="https://developers.facebook.com/roadmap/change-policy/"]Breaking Change Policy[/URL="https://developers.facebook.com/roadmap/change-policy/"], we publish this roadmap to help developers plan for changes that may require code modifications. Like all roadmaps, it may shift slightly, but we will share insight into what is happening as details become available. We encourage developers to [URL="https://developers.facebook.com/settings"]subscribe[/URL="https://developers.facebook.com/settings"] to our [URL="https://developers.facebook.com/blog"]blog[/URL="https://developers.facebook.com/blog"], where we announce rollout plans and timing.
July 10, 2013
The following changes can be enabled/disabled using the "July 2013 Breaking Changes" [URL="https://developers.facebook.com/roadmap/migrations"]migration[/URL="https://developers.facebook.com/roadmap/migrations"] until July 10th when they will go into effect permanently for everyone:
New APIs for comment replies
As announced [URL="https://developers.facebook.com/blog/post/2013/04/03/new-apis-for-comment-replies/"]here[/URL="https://developers.facebook.com/blog/post/2013/04/03/new-apis-for-comment-replies/"], this migration enables the updated comment APIs.
Social plugins will require an absolute URL in the 'href' parameter
[URL="https://developers.facebook.com/docs/plugins/"]Social plugins[/URL="https://developers.facebook.com/docs/plugins/"], such as the Like Box and Like Button, will require an absoute URL in the 'href' parameter.
Stream table will throw exception with invalid filter_key
Query [URL="https://developers.facebook.com/docs/reference/fql/stream_filter"]stream_filter[/URL="https://developers.facebook.com/docs/reference/fql/stream_filter"] table for a set of valid stream filters. The [URL="https://developers.facebook.com/docs/reference/fql/stream"]stream[/URL="https://developers.facebook.com/docs/reference/fql/stream"] table will throw an exception if called with an invalid 'filter_key' option.
Removing 'publish_checkins' permissions
Publishing a Checkin object is deprecated in favor of creating an Open Graph story with a [URL="https://developers.facebook.com/docs/opengraph/guides/tagging/#places"]location[/URL="https://developers.facebook.com/docs/opengraph/guides/tagging/#places"] attached. You can also create a Post with a location attached using the 'publish_steam' extended permission.
FQL Checkin table 'page_id' change
We are renaming 'page_id' to 'target_id' for the [URL="https://developers.facebook.com/docs/reference/fql/checkin"]Checkin[/URL="https://developers.facebook.com/docs/reference/fql/checkin"] table.
Removing 'version' field for Groups
We introduced 'version' field to indicate whether the group was created prior to launch of the current groups product in October 2010. We are removing this field as all Groups on Facebook are now the same version. This impacts both [URL="https://developers.facebook.com/docs/reference/api/group/"]Group Graph API[/URL="https://developers.facebook.com/docs/reference/api/group/"] and [URL="https://developers.facebook.com/docs/reference/fql/group"]Group FQL Table[/URL="https://developers.facebook.com/docs/reference/fql/group"].
Photos will no longer return larger sizes than the uploaded version
'images' field in [URL="https://developers.facebook.com/docs/reference/fql/photo"]photos[/URL="https://developers.facebook.com/docs/reference/fql/photo"] and [URL="https://developers.facebook.com/docs/reference/fql/photo"]photo_src[/URL="https://developers.facebook.com/docs/reference/fql/photo"] table will no longer return image sizes larger than the original uploaded version of the photo.
Can not create multiple create actions for the same Open Graph object
We are no longer allowing multiple create actions for the same Open Graph object, as documented [URL="https://developers.facebook.com/docs/opengraph/creating-object-types/"]here[/URL="https://developers.facebook.com/docs/opengraph/creating-object-types/"].
Deprecating 'comments' field from 'stream' FQL table
We are deprecating the 'comments' field from 'stream' FQL table. Please select the 'comment_info' column to fetch the 'can_comment' and 'comment_count' fields (formerly called 'can_post' and 'count'), and use the comment table directly to retrieve the list of comments.
Removing 'xid', 'reply_xid', 'username' and 'comments' from 'comment' FQL table
We are removing the fields on the FQL 'comment' table that were used exclusively for legacy [URL="https://developers.facebook.com/docs/reference/plugins/comments/"]Comments Plugins[/URL="https://developers.facebook.com/docs/reference/plugins/comments/"] -- 'xid', 'reply_xid', 'username' and 'comments'. We now treat comments the same across plugins and within Facebook. Please query for comment replies left on the plugin [URL="https://developers.facebook.com/docs/graphapi/guides/comments/"]the same way[/URL="https://developers.facebook.com/docs/graphapi/guides/comments/"] as you would for other comments.
Removing 'count' from 'comments' Graph API connection
We are removing the undocumented 'count' field on the 'comments' connection in the Graph API. Please request '{id}/comments?summary=true' explicitly if you would like the summary field which contains the count (now called 'total_count')
The following changes will go into effect on July 10, 2013:
Mobile App Install Ads change
We are updating the [URL="https://developers.facebook.com/docs/reference/ads-api/mobile-app-ads/"]Creative Spec[/URL="https://developers.facebook.com/docs/reference/ads-api/mobile-app-ads/"] parameter 'app_platform_type' to 'mobile_store'. The possible values for mobile_store are now "itunes", "itunes_ipad", and "google_play".
Conversion spec and tracking pixel ID changes
We are deprecating the use of 'tracking_pixel_id' when specifying the desire to track a [URL="https://developers.facebook.com/docs/reference/ads-api/offsite-pixels/"]conversion pixel[/URL="https://developers.facebook.com/docs/reference/ads-api/offsite-pixels/"] in an ad. You should instead specify the pixel in the newly launched [URL="https://developers.facebook.com/docs/reference/ads-api/tracking-specs/"]tracking_specs[/URL="https://developers.facebook.com/docs/reference/ads-api/tracking-specs/"] field. We are also deprecating the use of [URL="https://developers.facebook.com/docs/reference/ads-api/conversion-specs/"]conversion specs[/URL="https://developers.facebook.com/docs/reference/ads-api/conversion-specs/"] in bid types that are not optimized for actions (e.g. CPM, CPC, and oCPM when no bid value is placed on actions). You should instead use [URL="https://developers.facebook.com/docs/reference/ads-api/tracking-specs/"]tracking_specs[/URL="https://developers.facebook.com/docs/reference/ads-api/tracking-specs/"] to track conversions for these bid types.
Custom Audiences change
We have changed the targeting spec parameter 'excluded_user_adclusters' to be 'excluded_custom_audiences'. Additionally, the endpoint to create and retrieve your custom audiences is now: https://graph.facebook.com/(act_adac...ustomaudiences.
Accessing link stats change
App access tokens will be required for accessing the [URL="https://developers.facebook.com/docs/reference/fql/link_stat"]link_stat[/URL="https://developers.facebook.com/docs/reference/fql/link_stat"] FQL table. App access tokens will also be required for retrieving data from Graph API endpoint for link stats, ie: https://graph.facebook.com/?id=http://example.com.
Graph API search changes
App access tokens will be required for all search Graph API calls except Places and Pages. Search for application will no longer be supported.
Open Graph apps using custom actions for fitness, books, movies, and TV
As [URL="https://developers.facebook.com/blog/post/2013/03/08/improving-facebook-for-books--movies--tv-and-fitness/"]announced[/URL="https://developers.facebook.com/blog/post/2013/03/08/improving-facebook-for-books--movies--tv-and-fitness/"] in March, any apps that previously used custom actions to represent this type of sharing will need to move common actions by July 10, 2013.
Removing 'page_friends_of_fans' metric
We are removing the metric: 'page_friends_of_fans' from the Insights Dashboard and the [URL="https://developers.facebook.com/docs/reference/api/insights/"]Insights API[/URL="https://developers.facebook.com/docs/reference/api/insights/"].
Removing the ability to "Select All" or "Pre-Select" for Requests
As part of our efforts to improve user sentiment, we have [URL="https://developers.facebook.com/policy/#integration"]updated our platform policy[/URL="https://developers.facebook.com/policy/#integration"] so that apps may not offer a select all option or pre-select multiple recipients to receive requests. Other Request dialog functionality will remain the same.
Comment