Hey everyone!
Just a heads up that Facebook Graph API version 3.2 will no longer be supported starting May 4, 2021. Where possible data sources using version 3.2 will be upgraded to version 3.3 automatically. A few endpoints will be upgraded to version 10, if possible.
There are some things that we are unable to update for you and may need action on your part. You can find more details about version 3.3: https://developers.facebook.com/docs/graph-api/changelog/version3.3
The biggest change with version 3.3 will be with Page API endpoints.
Starting with v3.3 onwards, for some Page API endpoints a page token is required. An example of the query will look like:
https://graph.facebook.com/v3.3/{page-id}/insights/page_total_actions
If there is no page access token, the data source will have the following error:
{
"error": {
"message": "(#190) This method must be called with a Page Access Token",
"type": "OAuthException",
"code": 190,
"fbtrace_id": "AiA0szKtX7XB1Xa9LhuiVNd"
}
}
Handling Deprecated fields from Page API
The main deprecation from 3.2 to 3.3 are these following deprecated fields from the Page API - posts and feed objects. Instead of requesting the fields directly, you will request a new field called attachments and then use XPath to select the node.
- GET posts — The following fields on the {page_id}/feed, {page_id}/published_posts, {page_id}/posts, and {page_post_id} nodes are deprecated:
- caption
- description
- link
- name
- object_id
- Source
- type
Get these fields' information using the attachments field instead. See the mapping in the table below.
Example:
Before migration:
After migration:
What happens to Klips that use these deprecated fields?
With the fields such as name and description deprecated from /feed and /posts (replaced with the attachment sub-object), existing Klips and the XPath expression used to retrieve name and description will now return an empty string.
This means the XPath will need to be updated in the Klip
Example:
Before
kf:fill_elements(/data,‘name’)
kf:fill_elements(/data,‘link’)
After
kf:fill_elements(/data/attachments/data,‘title’)
kf:fill_elements(/data/attachments/data,‘url’)
IMPORTANT:
- Two of our prebuilt Klips will be automatically updated. Facebook Recent Posts and Facebook Recent Feed
- Please ensure all your Facebook /Posts data sources are returning data correctly after the May 4 date.
- Please verify all your Facebook Klips are displaying properly after the May 4 date.
Let us know if you have any questions, we are here to help!
