Hi Malaka,
Facebook api having 250+ operations. We reduced it to 114 by considering
below factors
01. Accumulate common URL services to the single operation by considering
the dynamic edges as the parameter.
Ex. getAlbumDetails operation would cover the 5 operations.
02. By looking at the business value of the operation. Very few set of
methods can removed from the list.
Ex.
•. 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
•. createAppAchievements - Register an achievement for a game
•. updateAppAchievements - Update the custom properties of an
achievement registration
•. deleteAppAchievements - Un-register an achievement for a
game
Shall we focus on the audience based operations to reduce the list?
Ex. apps, payment, offers,Groups can be consider as multi user operations.
(subjective)
WDYT..?
Thanks
Indika Kularathne
Malaka Silva wrote
> Hi Indika,
>
> What is the criteria used to select 114 methods and which methods were not
> selected?
>
> Best Regards,
> Malaka
>
>
> On Mon, Jan 20, 2014 at 10:31 PM, indika prasad <
> indika.pra@
> >wrote:
>
>> *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
>>
> Architecture@
>> https://mail.wso2.org/cgi-bin/mailman/listinfo/architecture
>>
>
>
>
> --
>
> Best Regards,
>
> Malaka Silva
> Senior Tech Lead
> M: +94 777 219 791
> Tel : 94 11 214 5345
> Fax :94 11 2145300
> LinkedIn : http://www.linkedin.com/pub/malaka-silva/6/33/77
> Blog : http://mrmalakasilva.blogspot.com/
>
> WSO2, Inc.
> lean . enterprise . middleware
> http://www.wso2.com/
> http://www.wso2.com/about/team/malaka-silva/<http://wso2.com/about/team/malaka-silva/>
>
> Save a tree -Conserve nature & Save the world for your future. Print this
> email only if it is absolutely necessary.
>
> _______________________________________________
> Architecture mailing list
> Architecture@
> https://mail.wso2.org/cgi-bin/mailman/listinfo/architecture
--
View this message in context:
http://wso2-oxygen-tank.10903.n7.nabble.com/Connector-Facebook-tp90890p91153.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
