Facebook Open Graph AuthenticationTo Get Access Permission                                   Writer : Seunghyun Seo       ...
Facebook Open Graph AuthenticationContents► Introduction► Access Token► Permission► Graph API► Appendix► References
IntroductionAbstract
Introduction Open Graph is Core Concept in Facebook The Graph API is the core of Facebook  Platform for Development   ► ...
Access TokenPAGE ## | DATE
Access Token Authenticating as an Application allows your application to  obtain an App Access Token. Obtain an App Acce...
Access Token 2012, May, 2 offline_access Permission will be eliminated. Allow Other way.- Handling Expired Access Tokens...
PermissionPAGE ## | DATE
Permission By default, when authorizing your application, a user only  grants your app access to their basic information....
Permission Basic Information   ► Id, name, picture, gender, locale, Friends Connection, Public Data User and Friend Perm...
PermissionUser Permission          Friends Permission          Descriptionuser_about_me            friends_about_me       ...
PermissionUser Permission   Friends Permission   Descriptionuser_groups       friends_groups       Provides access to the ...
PermissionUser Permission             Friends Permission            Descriptionuser_photos                 friends_photos ...
PermissionUser Permission     Friends Permission     Descriptionuser_videos         friends_videos         Provides access...
Permission
Graph API
Graph APIMethod                Description                                 Argument/PROFILE_ID/feed      Publish a new pos...
Graph API Method                     Description                          Argument/EVENT_ID/attending        RSVP "attendi...
Open Graph Object
Open Graph Object List of Open Graph Object Object        Description                        Object       DescriptionAchi...
Open Graph ObjectObject         Description                           Object           DescriptionOrder          An order ...
AppendixChart, Infographics
ChartAchievement Object PropertiesThe achievement(Instance) object represents the achievement achieved by a user for a par...
ChartAlbum Object Properties#1If an app lets a user choose an album when uploading photos, the app should check the can_up...
ChartAlbum Object Properties#2 Object        Description                        Permission          Return ValueCover_Phot...
ChartAlbum Object ConnectionsThe Album object has the following connections. Connections give Specific URL for to obtain J...
ChartCheckin Object Properties#1A Checkin represents a single visit by a user to a location. The User and Page objects hav...
ChartCheckin Object Properties#2 Object        Description                        Permission          Return ValueCreated_...
ChartCheckin Object ConnectionsThe Album object has the following connections. Connections give Specific URL for to obtain...
ChartComment Object Properties#1A comment on Feed Object         Description                         Permission     Return...
ChartComment Object Properties#2 Object         Description                           Permission     Return Value User_lik...
ChartDomain Object PropertiesA web site domain within the Graph API. To register your own Domain, you must claim your doma...
ChartEvent Object Properties#1A Checkin represents a single visit by a user to a location. The User and Page objects have ...
ChartEvent Object Properties#2 Object       Description                      Permission          Return ValueEnd_time     ...
ChartEvent Object Connections#1 Name        Description                     Permission          Return ValueFeed        Th...
ChartEvent Object Connections#2 Name        Description                       Permission          Return ValueMaybe       ...
ChartFriendList Object Properties Object         Description                                              Permission      ...
Infographics
ReferencesPapers
PapersFacebook Developer Pagehttps://developers.facebook.com/http://ogp.me
Upcoming SlideShare
Loading in …5
×

Facebook permission

1,951
-1

Published on

0 Comments
2 Likes
Statistics
Notes
  • Be the first to comment

No Downloads
Views
Total Views
1,951
On Slideshare
0
From Embeds
0
Number of Embeds
0
Actions
Shares
0
Downloads
14
Comments
0
Likes
2
Embeds 0
No embeds

No notes for slide

Facebook permission

  1. 1. Facebook Open Graph AuthenticationTo Get Access Permission Writer : Seunghyun Seo Contact: tgnice@nchovy.com tgnice@programming.or.kr
  2. 2. Facebook Open Graph AuthenticationContents► Introduction► Access Token► Permission► Graph API► Appendix► References
  3. 3. IntroductionAbstract
  4. 4. Introduction Open Graph is Core Concept in Facebook The Graph API is the core of Facebook Platform for Development ► Open Graph Theory Authentication ► Facebook authentication enables your app to interact with the Graph API on behalf of Facebook users and provides a powerful single-sign on mechanism across Web, mobile, and desktop apps. Tools For Developer ► Insights, Graph API Explorer, JavaScript Test Console, Test Users, URL Linter .
  5. 5. Access TokenPAGE ## | DATE
  6. 6. Access Token Authenticating as an Application allows your application to obtain an App Access Token. Obtain an App Access Token. ► The API will respond with a query-string formatted string of the form. ► You should parse this string, and use the value in the access_token parameter to to the API. ► App access tokens do not expire unless you refresh you apps App Secret. Make requests to the API. ► An app access token allows you to make requests as an application, not a user. ► To retrieve the details of your application, perform an HTTP GET. ► To read your applications insights data, perform an HTTP GET. String Format ► Https://[REDIRECTURL]#access_token=[ACCESS_TOKEN]
  7. 7. Access Token 2012, May, 2 offline_access Permission will be eliminated. Allow Other way.- Handling Expired Access Tokens. Currently the long-lived user access_token will be valid for 60 days while the short-lived user access_tokens are valid from 1 to 2 hours.
  8. 8. PermissionPAGE ## | DATE
  9. 9. Permission By default, when authorizing your application, a user only grants your app access to their basic information. If you want to read additional data or write data to Facebook, you need to request additional permissions. In the various authentication flows, you should specify the additional permissions you require using the scope parameter. To see which additional permissions you can request, and the access they offer you, see the Permissions reference.
  10. 10. Permission Basic Information ► Id, name, picture, gender, locale, Friends Connection, Public Data User and Friend Permissions Extended Permissions ► Individually user-revocable. Open Graph Permission ► To Publish Action Page Permission ► Manage User’s Page
  11. 11. PermissionUser Permission Friends Permission Descriptionuser_about_me friends_about_me Provides access to the "About Me" section of the profile in the about propertyuser_activities friends_activities Provides access to the users list of activities as the activities connection(belong to Likes)user_birthday friends_birthday Provides access to the birthday with year as the birthday propertyuser_checkins friends_checkins Provides read access to the authorized users check-ins or a friends check-ins that the user can see. This permission is superseded by user_status for new applications as of March, 2012.user_education_history friends_education_history Provides access to education history as the education propertyuser_events friends_events Provides access to the list of events the user is attending as the events connection
  12. 12. PermissionUser Permission Friends Permission Descriptionuser_groups friends_groups Provides access to the list of groups the user is a member of as the groups connectionuser_hometown friends_hometown Provides access to the users hometown in the hometown propertyuser_interests friends_interests Provides access to the users list of interests as the interests connection(belong to Likes)user_likes friends_likes Provides access to the list of all of the pages the user has liked as the likes connectionuser_location friends_location Provides access to the users current location as the location propertyuser_notes friends_notes Provides access to the users notes as the notes connection
  13. 13. PermissionUser Permission Friends Permission Descriptionuser_photos friends_photos Provides access to the photos the user has uploaded, and photos the user has been tagged inuser_questions friends_questions Provides access to the questions the user or friend has askeduser_relationships friends_relationships Provides access to the users family and personal relationships and relationship statususer_relationship_details friends_relationship_detail Provides access to the users relationship preferences suser_religion_politics friends_religion_politics Provides access to the users religious and political affiliationsuser_status friends_status Provides access to the users status messages and check-ins. Please see the documentation for the location_post. you were t agged in the Post, a friend was tagged in the Post, you authore d the Post, a friend authored the Post
  14. 14. PermissionUser Permission Friends Permission Descriptionuser_videos friends_videos Provides access to the videos the user has uploaded, and videos the user has been tagged in(belong to Likes)user_website friends_website Provides access to the users web site URLuser_work_history friends_work_history Provides access to work history as the work propertyemail N/A Provides access to the users primary email address in the email property. Do not spam users. Your use of email must comply both with Facebook policies and with the CAN-SPAM Act.
  15. 15. Permission
  16. 16. Graph API
  17. 17. Graph APIMethod Description Argument/PROFILE_ID/feed Publish a new post on the given profiles message, picture, link, name, caption, feed/wall description, source, place, tags/OBJECT_ID/comments Comment on the given object (if it has a message /comments connection)/OBJECT_ID/likes Like the given object (if it has a /likes none connection) Everything have object ID. But, There is no object in “Comment likes”. it just show like count./PROFILE_ID/notes Publish a note on the given profile message, subject/PROFILE_ID/links Publish a link on the given profile link, message, picture, name, caption, description/PROFILE_ID/events Create an event name, start_time, end_time Format ► Https://graph.facebook.com/ID/Connection?access_token=[ACCESSTOKEN] ► Connection that you can use is Explained by Chart
  18. 18. Graph API Method Description Argument/EVENT_ID/attending RSVP "attending" to the given event none/EVENT_ID/maybe RSVP "maybe" to the given event none/EVENT_ID/declined RSVP "declined" to the given event none/PROFILE_ID/albums Create an album name, message/ALBUM_ID/photos Upload a photo to an album message, source, place (multipart/form-data)/PROFILE_ID/checkins Create a check-in at a location coordinates, place, message, tags represented by a Page Before 2012. 5. 2. Your Wall is Yours, but post that made of others is not your permission. That is not yours. it has friends Permission After 2012. 5.2. Facebook Change Privacy Policy. Removed offline Permission. And You can Access Friend’s Post in Your Wall.
  19. 19. Open Graph Object
  20. 20. Open Graph Object List of Open Graph Object Object Description Object DescriptionAchievement Instance for an achievement for a Album A Photo Album userApplication An Application Registered on Checkin A checkin made Through Facebook Facebook Platform Place or the Graph APIComment A Comment on a Graph API object Domain A Website Domain within the Graph APIEvent A Facebook Event FriendList A Facebook Friend List. This object represents the list itself and not the members of the list.Group A Facebook Group Insight Statistics About Applications, Pages, or DomainLink A Shared Link Message A message in a ThreadNote A Facebook Note Offer An Offer Published by a Page
  21. 21. Open Graph ObjectObject Description Object DescriptionOrder An order object associated with Page A Facebook Page facebook creditPhoto An Individual Photo within an Post An Individual entry in a profile’s feed AlbumQuestion A Question Asked by a user, as QuestionOption An Option Aloowed as an answer to a represented in the graph API questionReview A Review for an application Status message A status message on a user’s wallSubscription A subscription to an application to Thread A message thread get real-time updates an Graph object typeuser A user profile video An individual video
  22. 22. AppendixChart, Infographics
  23. 23. ChartAchievement Object PropertiesThe achievement(Instance) object represents the achievement achieved by a user for a particular app. Object Description Permission Return Value Id Id of the achievement(instance) app or user String(Single object is Always String) access_token From The user who achieved the app or user JSON Object containing(id, name) achievement access_token Created_time Time at which the achievement app or user String containing an ISO-8601 date time was achieved access_token Application The application in which the user app or user JSON Object containing(id, name) achieved the achievement access_token Achievement The achievement object that the app or user JSON Object containing(id, url, type, title) user achieved access_token likes likes received by the story app or user JSON Object contained[count of likes, access_token JSON Object Array containing(id, name) ] comments Comments received by the app or user JSON Object containing Comments achievement story access_token Object(count of comment, JSON Object From, message, Created time)
  24. 24. ChartAlbum Object Properties#1If an app lets a user choose an album when uploading photos, the app should check the can_upload flag to be sure thatthe app is allowed to add new photos to the album.Object Description Permission Return ValueId The Album ID Any valid access_token String(Single object is Always String) or user_photos or friend_photosFrom The Profile that created this Album Any valid JSON Object containing(id, name) access_tokenName The Title of the Album Any valid access_token or String user_photos or friend_photosDescription The Descriprtion of the album the same as above StringLocation The Location of the Album StringLink A Link to this Album on Facebook String(Valid URL)
  25. 25. ChartAlbum Object Properties#2 Object Description Permission Return ValueCover_Photo A Link to this Album on Facebook the same as above StringPrivacy The Privacy Setting for the String AlbumCount The Number of Photos in this String AlbumType The Type of the Album String( Profile , Mobile Wall, Normal )Created_Time The Time the Photo Album was String containing an ISO-8601 date time initially createdUpdated_Time The Last Time the Photo Album String containing an ISO-8601 date time was updatedCan_Uploaded Determines whether the UID can Boolean upload to the album and returns true
  26. 26. ChartAlbum Object ConnectionsThe Album object has the following connections. Connections give Specific URL for to obtain JSONObject. Name Description Permission Return ValuePhotos The Photos caontained in this Any valid JSON Array Object of Photo album access_token or user_photos or friend_photosLikes The Likes made on this album the same as above JSON Object Containing(id, from, message, created_time)Comments The Comments made on this JSON Array Object Containing(id, name) albumPictures The Album’s cover Photo, the HTTP 302 redirect to URL of the albums first picture uploaded to an album cover picture becomes the cover photo for the album.
  27. 27. ChartCheckin Object Properties#1A Checkin represents a single visit by a user to a location. The User and Page objects have checkin connections. Thebehavior of Checkins is affected by the "Include Checkins with Statuses" migration setting. Object Description Permission Return Value Id The checkin ID user_checkins String(Single object is Always String) From The ID and name of the user who the same as JSON Object containing(id, name) made the checkin above Tags The users the author tagged in the JSON Array Object containing(id, name) checkin place Information about the Facebook JSON Object containing[id, name, Page that represents the location of JSON Object location containing(latitude, the checkin longitude)] Application Information about the application JSON Object containing(id, name, that made the checkin Canvas name, namespace)
  28. 28. ChartCheckin Object Properties#2 Object Description Permission Return ValueCreated_time The time the checkin was the same as above String containing an ISO-8601 date time createdLike Users who like the checkin JSON Array Object containing(id, name)Message The Message the user added to String the checkinComments All of the Comments on this link JSON Array Object containing(id, from, message, created_time)Type The Type of this object; always String return checkin
  29. 29. ChartCheckin Object ConnectionsThe Album object has the following connections. Connections give Specific URL for to obtain JSONObject. Name Description Permission Return ValueComments All of the comments on this user_checkins or JSON Array Object Containing(id, from, checkin. friends_checkins as message, created_time) appropriateLikes Users who like this checkin. user_checkins or JSON Object Containing(id, name) friends_checkins as appropriate
  30. 30. ChartComment Object Properties#1A comment on Feed Object Description Permission Return ValueId The Facebook ID of the comment generic String(Single object is Always String) access_tokenFrom The user that created the comment the same as JSON Object containing(id, name) aboveMessage The comment text StringCreated_Time The timedate the comment was String containing an ISO-8601 date time createdLikes The number of times this comment Integer was liked
  31. 31. ChartComment Object Properties#2 Object Description Permission Return Value User_likes This Field is returned only if the Generic String(always true) authenticated user likes this access_token comment type The Type of this object; always Generic String returns comment access_tokenComment Object ConnectionsThe Comment object has the following connections.Name Description Permission Return Valuelikes All of the likes on this comment Any valid JSON Array Object Containing(id, name) access_token
  32. 32. ChartDomain Object PropertiesA web site domain within the Graph API. To register your own Domain, you must claim your domain name usingFacebook Insights. Object Description Permission Return Value Id The ID of the domain No access_token String(Single object is Always String) required name The name of the domain No access_token String(Single object is Always String) required
  33. 33. ChartEvent Object Properties#1A Checkin represents a single visit by a user to a location. The User and Page objects have checkin connections. Thebehavior of Checkins is affected by the "Include Checkins with Statuses" migration setting. Object Description Permission Return Value Id The event ID generic String(Single object is Always String) access_token, user_events or friends_events Owner The profile that created the event the same as JSON Object containing(id, name) above Name The event title String(Single object is Always String) Description The long-form description of the String(Single object is Always String) event Start_time The start time of the event, as you String containing an ISO-8601 date time want it to be displayed on facebook
  34. 34. ChartEvent Object Properties#2 Object Description Permission Return ValueEnd_time The end time of the event, as the same as above String containing an ISO-8601 date time you want it to be displayed on facebookLocation The location for this event Stringvenue The location of this event JSON Array Object containing(id, street, city, state, zip, country, latitude, longitude )Privacy The visibility of this event String(OPEN,CLOSED,SECRET)Update_time The last time the event was String containing an ISO-8601 date time updated
  35. 35. ChartEvent Object Connections#1 Name Description Permission Return ValueFeed This events wall. any valid JSON Array of POST Object access_token, user_events or friends_eventsNoreply All of the users who have been the same as above JSON Object Containing(id, name, not yet responded to their rsvp_status) invitation to this event.Invited All of the users who have been JSON Object Containing(id, name, invited to this event. rsvp_status)Attending All of the users who are JSON Object Containing(id, name, attending this event. rsvp_status)
  36. 36. ChartEvent Object Connections#2 Name Description Permission Return ValueMaybe All of the users who have been the same as above JSON Object Containing(id, name, responded "Maybe" to their rsvp_status) invitation to this event.Decline All of the users who declined JSON Object Containing(id, name, their invitation to this event. rsvp_status)Picture The events profile picture. Returns a HTTP 302 with the URL of the events picturevideo The videos uploaded to an event. valid user JSON Array of Video Object access_token
  37. 37. ChartFriendList Object Properties Object Description Permission Return ValueID The friend list ID read_friendlists String(always true)Name The name of the friend list the same as above StringList_type The type of the friends list; Possible values are: String close_friends, acquaintances, restricted, user_created, education, work, current_city or familyFriendList Object ConnectionsThe Comment object has the following connections.Name Description Permission Return ValueMember All of the users who are read_friendlists JSON Array Object Containing(id, name) members of this list.
  38. 38. Infographics
  39. 39. ReferencesPapers
  40. 40. PapersFacebook Developer Pagehttps://developers.facebook.com/http://ogp.me
  1. A particular slide catching your eye?

    Clipping is a handy way to collect important slides you want to go back to later.

×