*Introduction*
Facebook is a social utility that connects people with friends and others
who work, study and live around them.
*Connector Summery*
• Connector Name: facebook-connector-1.0.0
• Version: 1.0.0
• Technology: REST/Graph API
• API Version: v1.0
• API URL: https://developers.facebook.com/docs/graph-api/reference/
*Authentication*
oauth2
Selected Methods (114) for version 1.0.0
*Album*: [1]
• getAlbumDetails – Get details of a photo album by album ID,
works with
the following additions to the endpoint:
o / - get all details related to the album
o /photos – get album photo details
o /likes – get details of likes on the album
o /comments – get details of comments on the album
o /picture – get cover photo of the album
• postPhotoToAlbum – Post a photo to an album:
https://developers.facebook.com/blog/post/498/
• createAlbumLike – Create a like for the album
• deleteAlbumLike – Delete the user’s like for the album
• createAlbumComment – Create a comment on the album
• createAlbum – Create an empty album
*App*: [2]
•. getAppDetails – Gets the details of a Facebook application by
app ID,
works with the following additions to the endpoint:
o / - get all details related to the app
o /accounts – get details of test accounts associated
with the application
o /achievements – get details of achievements registered
for the app
o /banned – get list of users banned from using the app
o /groups – get user groups associated with the
application
o /insights – get usage metrics associated with the
application
o /payment_currencies – get currencies associated with
the app
o /picture – get application’s profile picture
o /roles – get developer roles associated with the
application
o /scores – get scores of users on this app
o /staticresources – gets details about a canvas app’s
static resources
o /subscriptions – gets details about the subscriptions
associated with an
app
o /translations – gets details about translated strings
within the app
•. createAppTestAccount – Create a Test User account for the app
•. deleteAppTestAccount – Delete a Test User account created by
the app
•. testAppUserBan – Test whether a particular user is banned by
the app
•. createAppUserBan – Ban a user from using the app
•. deleteAppUserBan – Delete an existing user ban
•. createAppUserGroup – Create a user group owned by the
application
•. deleteAppUserGroup – Delete a user group owned by the
application
•. createAppCurrencyMapping – Create a currency mapping to the
application
•. deleteAppCurrencyMapping – Delete a currency mapping to the
application
•. createAppUserRole – Create a new role for a specific user for
the
application
•. deleteAppUserRole – Delete a specific user’s role for the
application
•. createAppSubscription – Create a subscription to an application
for a
callback URL
•. deleteAppSubscription – Delete a created subscription
•. createAppTranslation – Add translated strings for application
strings
•. deleteAppTranslation – Delete translated strings
•. deleteAppUserScores – Delete all user scores for the application
*Comments*: [3]
•. getCommentDetails – Get a single comment by ID, works with the
following
additions to the endpoint:
o / - get details of this comment
o /comments – get details of comments that are replies to
this comment
o /likes – get details of likes on this comment
•. deleteComment – Delete a single comment by ID
•. createLikeForComment – Create a like for a comment
•. deleteCommentLike – Delete a comment like
*Events*: [4]
•. getEventDetails – Get details of event by ID, with the following
additions to the endpoint:
o / - get details of event
o /attending – get details of users who are attending the
event
o /declined – get details of users who have declined the
event
o /feed – get the wall posts for the event
o /invited – get details of users who have been invited
to the event
o /maybe – get details of users who responded ‘maybe’
o /noreply – get details of users who did not reply to
their invites
o /picture – get profile picture for the event
o /videos – get videos posted to the event
o /photos – get photos posted by the event
•. deleteEvent – Delete the event
•. updateEvent – Updates an existing event by ID
•. createAttendingRSVP – RSVP a user as attending an event
•. createDeclinedRSVP – RSVP a user as declining an event
•. createEventMaybeRSVP – RSVP a user as maybe for an event
•. updateEventProfilePicture – Add a profile picture to an event
•. postEventPhotos – Post photos to an event
•. createPostOnEventWall – Create a post on the event wall
•. createEventInvitation – Send an invitation to the event to a
user
•. deleteEventInvitation – Delete a sent event invitation
•. updateEventTicketURI – Add/update the Ticket URI for the event
*Friend List*: [5]
•. getFriendListDetails – Get details of a user’s friend list by
Friend
List ID
•. deleteFriendList – Delete the friend list specified by the ID
•. addMembersToFriendList – Add the specified members to the
friend list
•. removeMembersFromFriendList – Remove the specified members from
the
friend list
*Groups *: [6]
•. getGroupDetails – Get details of group by ID , with the
following
additions to the endpoint:
o / - get group details
o /docs – get details of documents posted by the group
o /events – get details of events created by the group
o /feed – get the group’s wall posts
o /members – get details of members of the group
o /picture – get the group’s profile picture
•. createGroupEvent – Create an event for the group
•. createGroupPost – Create a post on the group’s wall
•. inviteMemberToGroup – Invite a new member to the group
•. promoteGroupAdmin – Promote a member to group admin
•. removeGroupAdmin – Remove one of the admins of the group
•. setGroupCoverPhoto – Set a group’s cover photo
*Messages *: [7]
•. getMessage – Get a message sent from one user to another by ID
*Milestones (on Pages)* : [8]
•. getPageMilestoneDetails – Get the details of a page’s milestone
by ID
(milestone ID), with the following additions to the endpoint:
o / - get milestone details
o /likes – get likes on the milestone
o /comments – get details of comments made on the
milestone
o /photos – get details of photos attached to the
milestone
•. publishPageMilestone – Publish a new milestone to a page
•. deletePageMilestone – Delete a page milestone by ID
•. updatePageMilestone – Update/edit a page milestone by ID
*Notes *: [9]
•. getNoteDetails – Gets details of a Note on Facebook by its ID,
with the
following additions to the endpoint:
o / - get note details
o /comments – get details of comments on the note
o /likes – get details of likes on the note
•. createNoteComment – Create a comment on a Note
•. createNoteLike – Create a new like on a Note
•. deleteNoteLike – Delete a created like (unlike) on a Note
*Offers *: [10]
•. getOfferDetails – Get an offer made by a page (by offer ID)
*Pages *: [11] Page operations require a page access token
•. getPageDetails – Get details of a page by ID, with the following
additions to the endpoint:
o / - get details of the page
o /admins – get details of page admins
o /albums – get details of albums created by the page
o /blocked – get details of users blocked by the page
o /checkins – get details of checkins made at the page’s
location
o /conversations – get details of a page’s conversations
o /events – get details of events created by a page
o /feed – get the page’s wall posts
o /global_brand_children – get details of child pages of
this page
o /insights – get statistical details about the page
o /locations – get details of location pages associated
with this page
o /milestones – get details of milestones created by this
page
o /notes – get details of notes created by this page
o /offers – get details of offers made by this page
o /picture – get the page’s profile picture
o /photos – get details of photos this page is tagged in
o /posts – get posts made by this page
o /promotable_posts – get details of this page’s
promotable posts
o /questions – get details of questions asked by this page
o /settings – get some controllable settings for this page
o /statuses – get status updates made by this page
o /tabs – get details of application tabs on this page
o /tagged – get details of all posts this page is tagged
in
o /videos – get details of videos uploaded by this page
•. updatePageDetails – Update details of a page
•. updatePageCoverPhoto – Update a page’s cover photo
•. createPageAlbum – Create a new album for the page
•. blockUserFromPage – Block a user from the page
•. unblockUserFromPage – Remove a user block
•. createPageEvent – Create an event by page
•. publishPagePost - Post to a page’s wall (can be link, checkin,
or
status update)
•. createPageMilestone – Create a new milestone for this page
•. addLocationChildPage (requires private API access – partnership
with
Facebook) – Add a location page as a child of this page (create connection
to existing location or create new location)
•. deleteLocationChildPage (requires private API access) – Delete a
location page that is a child of this page (only deletes connection)
•. updateLocationChildPage – (requires private API access) –
Update details
of a location page that is associated with this page
•. createPageNote – Create a new Note for this page
•. createPageOffer – Create an offer for this page
•. updatePagePicture – Update a page’s profile picture
•. addPhotoToPage – Add a new photo to a page
•. updatePageSettings – Change settings for a page
•. createPageAppTab – Creates a new app tab for a page
•. updatePageAppTab – Update an app tab for a page (change app)
•. deletePageAppTab – Deletes an app tab on a page
•. addPageVideo – Add a video to a page (upload)
*Payments *: [12]
•. getPaymentDetails – Get details of a payment made through
Facebook by
payment ID
•. refundPayment – Refund a payment made through Facebook
*Photos *: [13]
•. getPhotoDetails – Get details of a photo published to Facebook
by photo
ID, with the following additions to the endpoint:
o / - get details of photo
o /comments – get details of comments made on the photo
o /likes – get details of likes on the photo
o /picture – the actual picture associated with this
photo resource
o /tags – get details of tags on the photo
•. createPhotoComment – Add a comment to a photo
•. createPhotoLIke – Add a like to app photo
•. deletePhotoLike – Unlike a photo (only available to whitelisted
apps)
•. createPhotoTag - Adds a new tag to a photo
•. updatePhotoTag – Update an existing tag on a photo
•. deletePhotoTag – Delete a photo tag (only available to
whitelisted apps)
*Posts *: [14]
•. getPost – Gets details of a post on Facebook by post ID, with
the
following additions to the endpoint:
o / - get details of the post
o /comments – get details of comments on the post
o /likes – get details of likes on the post
o /insights – get statistical details of activity on this
post
•. createPostComment – Adds a new comment to a post
•. createPostLike – Adds a like to a post
•. deletePostLike – Unlikes a post
*Reviews *: [15]
•. getAppReview – Get a review of a Facebook app by review ID
*Status updates* : [16]
•. getStatusUpdate – Gets details of a Facebook status update by
status ID,
with the following additions to the endpoint:
o / - get details of the status update
o /comments – get details of comments made on this status
update
o /likes – get details of likes on this status update
•. createStatusComment – Adds a comment to a status update
•. createStatusLike – Likes a status update
•. deleteStatusLike – Unlikes a status update
*Threads *: [17] Threads API will soon be replacing messages and inbox
•. getThread – Gets details of a message thread by thread ID, with
the
following additions to the endpoint:
o / - get all details of thread
o /former_participants – get details of people who have
left the thread
o /messages – get the messages in this thread
o /participants – get details of participants in this
thread
o /senders – get details of participants who have sent at
least one
message on the thread
o /tags – get details of tags in the thread
Users : [18]
•. getUserDetails – Gets details of a user by user ID, with the
following
additions to the endpoint:
o / - get user details
o /accounts – get Facebook pages for which this user is
an admin
o /achievements – get user’s game achievements
o /activities – get activities listed on user profile
o /adaccounts – get details of advertising accounts to
which this user has
access
o /albums – get details of the user’s albums
o /applications/developer – get details of applications
for which this
user is a developer
o /apprequests – get outstanding app requests this user
has from apps
o /books – get details of books listed on the user’s
profile
o /checkins – get details of the user’s checkins
o /events – get details of the events the user is
attending
o /family – get details of the user’s family
relationships
o /feed – get the posts on the user’s wall
o /friendlists – get details of the user’s friend lists
o /friendrequests – get details of the user’s incoming
friend requests
o /friends – get details of the user’s friends
o /games – get details of user’s games
o /groups – get details of groups this user is a member
of
o /home – get the person’s news feed
o /inbox – get threads in the user’s inbox
o /interests – get interests on the user’s profile
o /likes – get details of the pages this user has liked
o /links – get details of links this user has posted
o /locations – details of locations that this user has
been tagged in
o /movies – get details of movies that this person has
added to their
profile
o /music – get details of music that this person has
added to their
profile
o /mutualfriends – details of mutual friends between two
people
o /notes – get details of notes this user has created
o /notifications – get details of notifications this user
has received
o /outbox – get the messages in the user’s outbox
o /payment_transactions – get details of Facebook
payments this user has
made
o /permissions – get details of the permissions this user
has granted the
app
o /picture – get the person’s profile picture
o /photos – get the details of photos this user is tagged
in
o /photos/uploaded – get details of photos this user has
uploaded
o /pokes – gets this users pokes
o /posts - gets posts that this user has created
o /questions – gets questions that this user has asked
o /scores – gets scores of this user in Facebook games
o /statuses – gets details of this user’s status updates
o /subscribedto – gets details of users this user is
subscribed to
o /subscribers – gets a list of this user’s subscribers
o /tagged – gets details of posts this user is tagged in
o /television – gets the television shows this user has
added to their
profile
o /videos – gets details of videos this user has been
tagged in
o /videos/uploaded – gets details of videos that this
user has uploaded
•. createUserAchievement – Adds an achievement for a user
•. deleteUserAchievement – Removes a user’s achievement
•. sendUserAppRequest – Sends an app request to other users
•. createUserEvent – Creates a new event
•. createUserPost – Adds a post to the user’s feed
•. createUserFriendList – Creates a new friend list for this user
*Ads API* : [19]
•. getAdAccountDetails – Gets details of an ad account
•. updateAdAccount – Update some fields on an ad account
*Videos *: [20]
•. getVideoDetails – Get a details of a video by Video ID, with the
following additions to the endpoint:
o / - get details of a video
o /picture – get the picture that this video is
represented by
o /comments – get comments on this video
o /likes – get the likes on this video
•. uploadVideo – Upload a video to Facebook
•. createVideoComment – Creates a new comment on a video
•. createVideoLike - Like a video
•. deleteVideoLike – Unlike a video
[1] https://developers.facebook.com/docs/reference/api/album/
[2] https://developers.facebook.com/docs/graph-api/reference/app/
[3] https://developers.facebook.com/docs/reference/api/comment/
[4] https://developers.facebook.com/docs/graph-api/reference/event/
[5] https://developers.facebook.com/docs/graph-api/reference/friendlist
[6] https://developers.facebook.com/docs/reference/api/group/
[7] https://developers.facebook.com/docs/reference/api/message/
[8] https://developers.facebook.com/docs/graph-api/reference/milestone/,
http://www.facebook.com/help/search/?query=milestones
[9] https://developers.facebook.com/docs/reference/api/note/
[10] https://developers.facebook.com/docs/reference/api/offer/
[11] https://developers.facebook.com/docs/reference/api/page/
[12] https://developers.facebook.com/docs/reference/api/payment/
[13] https://developers.facebook.com/docs/reference/api/photo/
[14] https://developers.facebook.com/docs/reference/api/post/
[15] https://developers.facebook.com/docs/reference/api/review/
[16] https://developers.facebook.com/docs/reference/api/status/
[17] https://developers.facebook.com/docs/reference/api/thread/
[18] https://developers.facebook.com/docs/reference/api/user/
[19] https://developers.facebook.com/docs/reference/ads-api/adaccount/
[20] https://developers.facebook.com/docs/reference/api/video/
--
View this message in context:
http://wso2-oxygen-tank.10903.n7.nabble.com/Connector-Facebook-tp90890.html
Sent from the WSO2 Architecture mailing list archive at Nabble.com.
_______________________________________________
Architecture mailing list
[email protected]
https://mail.wso2.org/cgi-bin/mailman/listinfo/architecture
