Skip to content

Commit

Permalink
Update FB presets to API v14
Browse files Browse the repository at this point in the history
  • Loading branch information
strohne committed May 28, 2024
1 parent cdb049b commit 59af1cc
Show file tree
Hide file tree
Showing 5 changed files with 61 additions and 61 deletions.
28 changes: 14 additions & 14 deletions apis/Facebook.v13_0.oa3.json → apis/Facebook.v14_0.oa3.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,17 +12,17 @@
},

"info": {
"title": "Facebook Graph API v13.0",
"description": "Please note: though some things might work, the settings are not yet fully compatible with v13.0.\n\nThe Graph API is the primary way to get data into and out of the Facebook platform.",
"title": "Facebook Graph API v14.0",
"description": "Please note: though some things might work, the settings are not yet fully compatible with v14.0.\n\nThe Graph API is the primary way to get data into and out of the Facebook platform.",
"termsOfService": "https://www.facebook.com/policies/",
"version": "13.0"
"version": "14.0"
},
"externalDocs": {
"url":"https://developers.facebook.com/docs/graph-api"
},
"servers": [
{
"url":"https://graph.facebook.com/v13.0"
"url":"https://graph.facebook.com/v14.0"
}
],
"paths":{
Expand Down Expand Up @@ -367,7 +367,7 @@
"get" : {
"summary" : "The feed of posts (including status updates) and links published by this page, or by others on this page. There are other edges which provide more specific sets of posts.",
"externalDocs": {
"url":"https://developers.facebook.com/docs/graph-api/reference/v13.0/page/feed"
"url":"https://developers.facebook.com/docs/graph-api/reference/v14.0/page/feed"
},
"parameters" : [
{
Expand Down Expand Up @@ -890,7 +890,7 @@
"get":{
"summary": "The location Pages that are children of this Page. For example, pages for each restaurant in a chain of restaurants.",
"externalDocs": {
"url":"https://developers.facebook.com/docs/graph-api/reference/v13.0/page/locations"
"url":"https://developers.facebook.com/docs/graph-api/reference/v14.0/page/locations"
},
"parameters" : [
{
Expand Down Expand Up @@ -1421,7 +1421,7 @@
"get" : {
"summary" : "Shows only the posts that were published by this page.",
"externalDocs": {
"url":"https://developers.facebook.com/docs/graph-api/reference/v13.0/page/feed"
"url":"https://developers.facebook.com/docs/graph-api/reference/v14.0/page/feed"
},
"parameters" : [
{
Expand Down Expand Up @@ -1727,7 +1727,7 @@
"get" : {
"summary" : "An individual entry in a profile's feed. The profile could be a user, page, app, or group.",
"externalDocs": {
"url":"https://developers.facebook.com/docs/graph-api/reference/v13.0/post"
"url":"https://developers.facebook.com/docs/graph-api/reference/v14.0/post"
},
"parameters" : [
{
Expand Down Expand Up @@ -1861,7 +1861,7 @@
"get" : {
"summary" : "Comments on a Facebook post.",
"externalDocs": {
"url":"https://developers.facebook.com/docs/graph-api/reference/v13.0/object/comments"
"url":"https://developers.facebook.com/docs/graph-api/reference/v14.0/object/comments"
},
"parameters" : [
{
Expand Down Expand Up @@ -2018,7 +2018,7 @@
"get" : {
"summary" : "Reactions on a Facebook post.",
"externalDocs": {
"url":"https://developers.facebook.com/docs/graph-api/reference/v13.0/object/reactions"
"url":"https://developers.facebook.com/docs/graph-api/reference/v14.0/object/reactions"
},
"parameters" : [
{
Expand Down Expand Up @@ -2074,7 +2074,7 @@
"get" : {
"summary" : "This edge represents any posts where the original object was shared on Facebook.",
"externalDocs": {
"url":"https://developers.facebook.com/docs/graph-api/reference/v13.0/object/sharedposts"
"url":"https://developers.facebook.com/docs/graph-api/reference/v14.0/object/sharedposts"
},
"parameters" : [
{
Expand Down Expand Up @@ -2214,7 +2214,7 @@
"get" : {
"summary" : "This node returns a single comment.",
"externalDocs": {
"url":"https://developers.facebook.com/docs/graph-api/reference/v13.0/comment"
"url":"https://developers.facebook.com/docs/graph-api/reference/v14.0/comment"
},
"parameters" : [
{
Expand Down Expand Up @@ -2295,7 +2295,7 @@
"get" : {
"summary" : "Comments that reply to this comment.",
"externalDocs": {
"url":"https://developers.facebook.com/docs/graph-api/reference/v13.0/object/comments"
"url":"https://developers.facebook.com/docs/graph-api/reference/v14.0/object/comments"
},
"parameters" : [
{
Expand Down Expand Up @@ -2451,7 +2451,7 @@
"get" : {
"summary" : "People who have reacted to this post.",
"externalDocs": {
"url":"https://developers.facebook.com/docs/graph-api/reference/v13.0/object/reactions"
"url":"https://developers.facebook.com/docs/graph-api/reference/v14.0/object/reactions"
},
"parameters" : [
{
Expand Down
41 changes: 0 additions & 41 deletions presets/Facebook-1_Get_page_data_v13_0_.fp4.json

This file was deleted.

41 changes: 41 additions & 0 deletions presets/Facebook-1_Get_page_data_v14_0_.fp4.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
{
"name": "1 Get page data (v14.0)",
"category": "Facebook",
"description": "*Please note: Due to changes in the Facebook API, you can no longer request page metadata with this preset. The special permissions needed can only be obtained by registering an own app and going through the app review (https://developers.facebook.com/docs/app-review/introduction).*\n\n*Facebook additionally introduced the New Page Experience, so that the API is more restricted for pages that have been migrated. See the New Pages Experience Overview: https://developers.facebook.com/docs/pages/new-pages-experience/overview/ *\n\nFetch the most basic information about a Facebook page.\n\n\n**Get started with the preset**\n\n1. After creating or opening a database, add the handle of a Facebook page (e.g. \"Uni.Greifswald.de\") as a seed node using the \"Add Nodes\" button.\n\n2. Load the preset by clicking \"Apply\" in the preset window.\n\n3. Login to Facebook in the Facebook module.\n\n4. Select the seed node and then click the \"Fetch Data\" button.\n\nLearn how to use presets in the wiki: https://github.com/strohne/Facepager/wiki/Presets\n\n\n**Further options**\n\nAbout fields: you can add fields to the fields parameter to fetch more data. For example, add \"likes\" to get to know which pages this page liked. See the Facebook API reference linked below for more options. Notice: If you add more fields, also add them in the column setup to make the data visible in the nodes view.\n\n**Facebook API documentation**\n\nBe aware that APIs are changing constantly. You can always find the latest information in the Facebook API Reference: https://developers.facebook.com/docs/graph-api/reference/page/.",
"module": "Facebook",
"options": {
"auth": "param",
"auth_prefix": "",
"auth_tokenname": "access_token",
"auth_type": "OAuth2",
"auth_uri": "https://www.facebook.com/dialog/oauth",
"basepath": "https://graph.facebook.com/v14.0",
"extension": "",
"key_paging": "paging.next",
"nodedata": null,
"objectid": "id",
"pages": 1,
"paging_type": "url",
"params": {
"<page-id>": "<Object ID>",
"fields": "name, about, location, category, talking_about_count, fan_count"
},
"redirect_uri": "https://www.facebook.com/connect/login_success.html",
"resource": "/<page-id>",
"scope": "",
"token_uri": ""
},
"speed": 200,
"saveheaders": false,
"timeout": 15,
"maxsize": 5,
"columns": [
"name",
"about",
"location.city",
"category",
"fan_count",
"talking_about_count",
"error.message"
]
}
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
{
"name": "2 Get posts (v13.0)",
"name": "2 Get posts (v14.0)",
"category": "Facebook",
"description": "Fetch the last 20 posts of a Facebook page.\n\n\n**Get started with the preset**\n\n1. After creating or opening a database, add the handle of a Facebook page (e.g. \"Uni.Greifswald.de\") as a seed node using the \"Add Nodes\" button.\n\n2. Load the preset by clicking \"Apply\" in the preset window.\n\n3. Login to Facebook in the Facebook module.\n\n4. Select the seed node and then click the \"Fetch Data\" button.\n\nLearn how to use presets in the wiki: https://github.com/strohne/Facepager/wiki/Presets\n\n\n**Some further options**\n\n1. Change the limit-parameter: You can increase the limit-parameter or increade the maximum pages to get more posts. \n\n2. Filtering by date: To filter by date use the parameters \"since\" and \"until\". The until-parameter always has to be one day later, the day starts at 0:00am GMT. For example, set since to \"2019-03-21\" and until to \"2019-03-22\" to limit the result to 21st of March 2019. See https://developers.facebook.com/docs/graph-api/results for further information.\n\n3. Get other fields: If you want more data than message, created_time and updated_time adjust the fields-parameter. Try things such as: attachments, message_tags, story, permalink_url, shares. You will find more fiields in the API reference (see below).\n\n4. Get reactions: If you want data about reactions try adding fields from the reactions preset: comments.limit(0).summary(1), reactions.limit(0).summary(1), reactions.type(LIKE).limit(0).summary(1).as(like), reactions.type(LOVE).limit(0).summary(1).as(love), reactions.type(HAHA).limit(0).summary(1).as(haha), reactions.type(WOW).limit(0).summary(1).as(wow), reactions.type(SAD).limit(0).summary(1).as(sad), reactions.type(ANGRY).limit(0).summary(1).as(angry), likes.limit(0).summary(true) \n\n\n**Facebook API documentation**\n\nBe aware of the API limitations, Facebook provides only up to 600 posts per year for each page. For more information and query options see the API reference: https://developers.facebook.com/docs/graph-api/reference/v13.0/page/feed\n\nTo understand the data contained in a post see https://developers.facebook.com/docs/graph-api/reference/v13.0/post \n\nThe technique to query reactions along with the posts is called field expansion, see https://developers.facebook.com/docs/graph-api/guides/field-expansion",
"description": "Fetch the last 20 posts of a Facebook page.\n\n\n**Get started with the preset**\n\n1. After creating or opening a database, add the handle of a Facebook page (e.g. \"Uni.Greifswald.de\") as a seed node using the \"Add Nodes\" button.\n\n2. Load the preset by clicking \"Apply\" in the preset window.\n\n3. Login to Facebook in the Facebook module.\n\n4. Select the seed node and then click the \"Fetch Data\" button.\n\nLearn how to use presets in the wiki: https://github.com/strohne/Facepager/wiki/Presets\n\n\n**Some further options**\n\n1. Change the limit-parameter: You can increase the limit-parameter or increade the maximum pages to get more posts. \n\n2. Filtering by date: To filter by date use the parameters \"since\" and \"until\". The until-parameter always has to be one day later, the day starts at 0:00am GMT. For example, set since to \"2019-03-21\" and until to \"2019-03-22\" to limit the result to 21st of March 2019. See https://developers.facebook.com/docs/graph-api/results for further information.\n\n3. Get other fields: If you want more data than message, created_time and updated_time adjust the fields-parameter. Try things such as: attachments, message_tags, story, permalink_url, shares. You will find more fiields in the API reference (see below).\n\n4. Get reactions: If you want data about reactions try adding fields from the reactions preset: comments.limit(0).summary(1), reactions.limit(0).summary(1), reactions.type(LIKE).limit(0).summary(1).as(like), reactions.type(LOVE).limit(0).summary(1).as(love), reactions.type(HAHA).limit(0).summary(1).as(haha), reactions.type(WOW).limit(0).summary(1).as(wow), reactions.type(SAD).limit(0).summary(1).as(sad), reactions.type(ANGRY).limit(0).summary(1).as(angry), likes.limit(0).summary(true) \n\n\n**Facebook API documentation**\n\nBe aware of the API limitations, Facebook provides only up to 600 posts per year for each page. For more information and query options see the API reference: https://developers.facebook.com/docs/graph-api/reference/v14.0/page/feed\n\nTo understand the data contained in a post see https://developers.facebook.com/docs/graph-api/reference/v13.0/post \n\nThe technique to query reactions along with the posts is called field expansion, see https://developers.facebook.com/docs/graph-api/guides/field-expansion",
"module": "Facebook",
"options": {
"auth": "param",
"auth_prefix": "",
"auth_tokenname": "access_token",
"auth_type": "OAuth2",
"auth_uri": "https://www.facebook.com/dialog/oauth",
"basepath": "https://graph.facebook.com/v13.0",
"basepath": "https://graph.facebook.com/v14.0",
"extension": "",
"key_paging": "paging.next",
"nodedata": "data",
Expand Down
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
{
"name": "3 Get comments (v13.0)",
"name": "3 Get comments (v14.0)",
"category": "Facebook",
"description": "Fetch the last 20 comments of a post or the last 20 replies to a comment.\n\n\n**Get started with the preset**\n\n1. Before you can use this preset, you have to fetch posts or add Facebook IDs of some posts. See the preset named \"Get posts\".\n\n2. Load the preset by clicking the \"Apply\" button.\n\n3. Login to Facebook in the Facebook module\n\n4. Select post or comment nodes and click the button \"Fetch Data\".\n\n\n**Some hints**\n\n1. Replies: Replies are comments to comments. Thus, you can use the comment preset to get replies to the comments. Alternatively, set the filter parameter to \"stream\" to get replies along with the comments.\n\n2. About the author of comments: you cannot access data about the author of comments (if you are not the owner of the page).\n\n3. Adding fields: When adding fields to the fields-parameter also add them in the column setup to make the data visible in the nodes view.\n\n\n**Facebook API documentation**\n\nSee the reference of the comments edge for further information: https://developers.facebook.com/docs/graph-api/reference/v13.0/object/comments\n\nFor information about available fields see the Facebook API reference: https://developers.facebook.com/docs/graph-api/reference/v13.0/comment\n\n",
"description": "Fetch the last 20 comments of a post or the last 20 replies to a comment.\n\n\n**Get started with the preset**\n\n1. Before you can use this preset, you have to fetch posts or add Facebook IDs of some posts. See the preset named \"Get posts\".\n\n2. Load the preset by clicking the \"Apply\" button.\n\n3. Login to Facebook in the Facebook module\n\n4. Select post or comment nodes and click the button \"Fetch Data\".\n\n\n**Some hints**\n\n1. Replies: Replies are comments to comments. Thus, you can use the comment preset to get replies to the comments. Alternatively, set the filter parameter to \"stream\" to get replies along with the comments.\n\n2. About the author of comments: you cannot access data about the author of comments (if you are not the owner of the page).\n\n3. Adding fields: When adding fields to the fields-parameter also add them in the column setup to make the data visible in the nodes view.\n\n\n**Facebook API documentation**\n\nSee the reference of the comments edge for further information: https://developers.facebook.com/docs/graph-api/reference/v14.0/object/comments\n\nFor information about available fields see the Facebook API reference: https://developers.facebook.com/docs/graph-api/reference/v13.0/comment\n\n",
"module": "Facebook",
"options": {
"auth": "param",
"auth_prefix": "",
"auth_tokenname": "access_token",
"auth_type": "OAuth2",
"auth_uri": "https://www.facebook.com/dialog/oauth",
"basepath": "https://graph.facebook.com/v13.0",
"basepath": "https://graph.facebook.com/v14.0",
"extension": "",
"key_paging": "paging.next",
"nodedata": "data",
Expand Down

0 comments on commit 59af1cc

Please sign in to comment.