| Package | com.myflashlab.air.extensions.fb |
| Class | public class Permissions |
| Inheritance | Permissions  Object |
Here you will find all the facebook permissions you may ask your app users. please note that some of these permissions are providing your app with personal information from your users and Facebook may require you data usage if you are using them. so, please make sure you are asking for real permissions that you will actually need them for your app logic.
Common permissions are Permissions.public_profile,
Permissions.user_friends and Permissions.email
to learn more about permissions, check https://developers.facebook.com/docs/facebook-login/permissions/v2.4#reference
| Constant | Defined By | ||
|---|---|---|---|
| email : String = email [static]
Provides access to the person's primary email address via the email property on the user object. | Permissions | ||
| manage_pages : String = manage_pages [static]
Enables your app to retrieve Page Access Tokens for the Pages and Apps that the person administrates. | Permissions | ||
| public_profile : String = public_profile [static]
Provides access to a subset of items that are part of a person's public profile. | Permissions | ||
| publish_actions : String = publish_actions [static]
Provides access to publish Posts, Open Graph actions, achievements, scores and other activity on behalf of
a person using your app. | Permissions | ||
| publish_pages : String = publish_pages [static]
When you also have the manage_pages permission, gives your app the ability to post, comment and like as
any of the Pages managed by a person using your app. | Permissions | ||
| read_custom_friendlists : String = read_custom_friendlists [static]
Provides access to the names of custom lists a person has created to organize their friends. | Permissions | ||
| read_insights : String = read_insights [static]
Provides read-only access to the Insights data for Pages, Apps and web domains the person owns. | Permissions | ||
| read_mailbox : String = read_mailbox [static]
Provides the ability to read the messages in a person's Facebook Inbox through the inbox edge and the
thread node. | Permissions | ||
| read_page_mailboxes : String = read_page_mailboxes [static]
Provides the ability to read from the Page Inboxes of the Pages managed by a person. | Permissions | ||
| user_about_me : String = user_about_me [static]
Provides access to a person's personal description (the 'About Me' section on their Profile) through the bio
property on the User object. | Permissions | ||
| user_actions_books : String = user_actions.books [static]
Provides access to all common books actions published by any app the person has used. | Permissions | ||
| user_actions_fitness : String = user_actions.fitness [static]
Provides access to all common Open Graph fitness actions published by any app the person has used. | Permissions | ||
| user_actions_music : String = user_actions.music [static]
Provides access to all common Open Graph music actions published by any app the person has used. | Permissions | ||
| user_actions_news : String = user_actions.news [static]
Provides access to all common Open Graph news actions published by any app the person has used which
publishes these actions. | Permissions | ||
| user_actions_video : String = user_actions.video [static]
Provides access to all common Open Graph video actions published by any app the person has used which
publishes these actions. | Permissions | ||
| user_birthday : String = user_birthday [static]
Access the date and month of a person's birthday. | Permissions | ||
| user_education_history : String = user_education_history [static]
Provides access to a person's education history through the education field on the User object. | Permissions | ||
| user_events : String = user_events [static]
Provides read-only access to the Events a person is hosting or has RSVP'd to. | Permissions | ||
| user_friends : String = user_friends [static]
Provides access the list of friends that also use your app. | Permissions | ||
| user_games_activity : String = user_games_activity [static]
Provides access to read a person's game activity (scores, achievements) in any game the person has played. | Permissions | ||
| user_groups : String = user_groups [static]
Enables your app to read the Groups a person is a member of through the groups edge on the User object. | Permissions | ||
| user_hometown : String = user_hometown [static]
Provides access to a person's hometown location through the hometown field on the User object. | Permissions | ||
| user_likes : String = user_likes [static]
Provides access to the list of all Facebook Pages and Open Graph objects that a person has liked. | Permissions | ||
| user_location : String = user_location [static]
Provides access to a person's current city through the location field on the User object. | Permissions | ||
| user_managed_groups : String = user_managed_groups [static]
Enables your app to read the Groups a person is an admin of through the groups edge on the User object. | Permissions | ||
| user_photos : String = user_photos [static]
Provides access to the photos a person has uploaded or been tagged in. | Permissions | ||
| user_posts : String = user_posts [static]
Provides access to the posts on a person's Timeline. | Permissions | ||
| user_relationship_details : String = user_relationship_details [static]
Provides access to a person's relationship interests as the interested_in field on the User object. | Permissions | ||
| user_relationships : String = user_relationships [static]
Provides access to a person's relationship status, significant other and family members as fields on the
User object. | Permissions | ||
| user_religion_politics : String = user_religion_politics [static]
Provides access to a person's religious and political affiliations. | Permissions | ||
| user_status : String = user_status [static]
Provides access to a person's statuses. | Permissions | ||
| user_tagged_places : String = user_tagged_places [static]
Provides access to the Places a person has been tagged at in photos, videos, statuses and links. | Permissions | ||
| user_videos : String = user_videos [static]
Provides access to the videos a person has uploaded or been tagged in. | Permissions | ||
| user_website : String = user_website [static]
Provides access to the person's personal website URL via the website field on the User object. | Permissions | ||
| user_work_history : String = user_work_history [static]
Provides access to a person's work history and list of employers via the work field on the User object. | Permissions | ||
| Constant |
public static const email:String = email
Provides access to the person's primary email address via the email property on the user object. Do not spam users. Your use of email must comply with both Facebook policies and with the CAN-SPAM Act.
Note, even if you request the email permission it is not guaranteed you will get an email address. For example, if someone signed up for Facebook with a phone number instead of an email address, the email field may be empty
| manage_pages | Constant |
public static const manage_pages:String = manage_pages
Enables your app to retrieve Page Access Tokens for the Pages and Apps that the person administrates. Apps need both manage_pages and publish_pages to be able to publish as a Page.
If your app requests this permission Facebook will have to review how your app uses it. You can grant this permission on behalf of people listed within the Roles section of your App's Dashboard without review by Facebook.
If you want to use the Facebook Plugin for Wordpress (or a similar tool) to publish blog posts to your Facebook page, you do not need to submit for review as long as all those for whom you want to publish are listed in the Roles section of your App's Dashboard.
When submitting for review, please make sure your instructions are easily reproducible by our team. For example, if your Page Management Tool has its own authentication system, please ensure you provide a working login (such as a username/password) to allow our review team to use your tool and test this functionality.
| public_profile | Constant |
public static const public_profile:String = public_profile
Provides access to a subset of items that are part of a person's public profile. A person's public profile refers to the following properties on the user object by default:
id, name, first_name, last_name, link, gender, locale, timezone, updated_time, verified
Your app may use this permission without review from Facebook.
| publish_actions | Constant |
public static const publish_actions:String = publish_actions
Provides access to publish Posts, Open Graph actions, achievements, scores and other activity on behalf of a person using your app.
Because this permission lets you publish on behalf of a user please read the Platform Policies to ensure you understand how to properly use this permission.
Your app does not need to request the publish_actions permission in order to use the Feed Dialog, the Requests Dialog or the Send Dialog
If your app requests this permission Facebook will have to review how your app uses it.
| publish_pages | Constant |
public static const publish_pages:String = publish_pages
When you also have the manage_pages permission, gives your app the ability to post, comment and like as any of the Pages managed by a person using your app.
Apps need both manage_pages and publish_pages to be able to publish as a Page.
Publishing as an individual personal account is not possible with this permission. To post as an individual, please see the publish_actions permission
If your app requests this permission Facebook will have to review how your app uses it.
| read_custom_friendlists | Constant |
public static const read_custom_friendlists:String = read_custom_friendlists
Provides access to the names of custom lists a person has created to organize their friends. This is useful for rendering an audience selector when someone is publishing stories to Facebook from your app.
This permission does not give access to a list of person's friends. If you want to access a person's friends who also use your app, you should use the user_friends permission.
This permission also does not give the list of friends who are part of a friendlist. It only gives access to the names of the lists.
If your app requests this permission Facebook will have to review how your app uses it
| read_insights | Constant |
public static const read_insights:String = read_insights
Provides read-only access to the Insights data for Pages, Apps and web domains the person owns.
If your app requests this permission Facebook will have to review how your app uses it
| read_mailbox | Constant |
public static const read_mailbox:String = read_mailbox
Provides the ability to read the messages in a person's Facebook Inbox through the inbox edge and the thread node.
If your app requests this permission Facebook will have to review how your app uses it
| read_page_mailboxes | Constant |
public static const read_page_mailboxes:String = read_page_mailboxes
Provides the ability to read from the Page Inboxes of the Pages managed by a person. This permission is often used alongside the manage_pages permission.
This permission does not let your app read the page owner's mailbox. It only applies to the page's mailbox.
If your app requests this permission Facebook will have to review how your app uses it
| user_about_me | Constant |
public static const user_about_me:String = user_about_me
Provides access to a person's personal description (the 'About Me' section on their Profile) through the bio property on the User object. This permission does not give access to a person's public profile data. A person's name, profile picture, locale, age range and gender are included by default with the public_profile permission.
If your app requests this permission Facebook will have to review how your app uses it
| user_actions_books | Constant |
public static const user_actions_books:String = user_actions.books
Provides access to all common books actions published by any app the person has used. This includes books they've read, want to read, rated or quoted.
If your app requests this permission Facebook will have to review how your app uses it
| user_actions_fitness | Constant |
public static const user_actions_fitness:String = user_actions.fitness
Provides access to all common Open Graph fitness actions published by any app the person has used. This includes runs, walks and bikes actions.
If your app requests this permission Facebook will have to review how your app uses it
| user_actions_music | Constant |
public static const user_actions_music:String = user_actions.music
Provides access to all common Open Graph music actions published by any app the person has used. This includes songs they've listened to, and playlists they've created.
If your app requests this permission Facebook will have to review how your app uses it
| user_actions_news | Constant |
public static const user_actions_news:String = user_actions.news
Provides access to all common Open Graph news actions published by any app the person has used which publishes these actions. This includes news articles they've read or news articles they've published.
If your app requests this permission Facebook will have to review how your app uses it
| user_actions_video | Constant |
public static const user_actions_video:String = user_actions.video
Provides access to all common Open Graph video actions published by any app the person has used which publishes these actions. This includes videos they've watched, videos they've rated and videos they want to watch.
If your app requests this permission Facebook will have to review how your app uses it
| user_birthday | Constant |
public static const user_birthday:String = user_birthday
Access the date and month of a person's birthday. This may or may not include the person's year of birth, dependent upon their privacy settings and the access token being used to query this field.
Please note most integrations will only need age_range which comes as part of the public_profile permission.
If your app requests this permission Facebook will have to review how your app uses it.
When submitting for review, please be clear as to why age_range is not sufficient for your use case
| user_education_history | Constant |
public static const user_education_history:String = user_education_history
Provides access to a person's education history through the education field on the User object.
If your app requests this permission Facebook will have to review how your app uses it
| user_events | Constant |
public static const user_events:String = user_events
Provides read-only access to the Events a person is hosting or has RSVP'd to.
If your app requests this permission Facebook will have to review how your app uses it.
| user_friends | Constant |
public static const user_friends:String = user_friends
Provides access the list of friends that also use your app. These friends can be found on the friends edge on the user object.
In order for a person to show up in one person's friend list, both people must have decided to share their list of friends with your app and not disabled that permission during login. Also both friends must have been asked for user_friends during the login process.
Your app may use this permission without review from Facebook.
| user_games_activity | Constant |
public static const user_games_activity:String = user_games_activity
Provides access to read a person's game activity (scores, achievements) in any game the person has played.
If your app requests this permission Facebook will have to review how your app uses it
| user_groups | Constant |
public static const user_groups:String = user_groups
Enables your app to read the Groups a person is a member of through the groups edge on the User object. This permission does not allow you to create groups on behalf of a person. It is not possible to create groups via the Graph API.
If your app requests this permission Facebook will have to review how your app uses it.
| user_hometown | Constant |
public static const user_hometown:String = user_hometown
Provides access to a person's hometown location through the hometown field on the User object. This is set by the user on the Profile.
If your app requests this permission Facebook will have to review how your app uses it.
| user_likes | Constant |
public static const user_likes:String = user_likes
Provides access to the list of all Facebook Pages and Open Graph objects that a person has liked. This list is available through the likes edge on the User object.
If your app requests this permission Facebook will have to review how your app uses it.
| user_location | Constant |
public static const user_location:String = user_location
Provides access to a person's current city through the location field on the User object. The current city is set by a person on their Profile. The current city is not necessarily the same as a person's hometown.
If your app requests this permission Facebook will have to review how your app uses it.
| user_managed_groups | Constant |
public static const user_managed_groups:String = user_managed_groups
Enables your app to read the Groups a person is an admin of through the groups edge on the User object. This permission does not allow you to create groups on behalf of a person. It is not possible to create groups via the Graph API. This does not let you read the groups a user is just a member of.
If your app requests this permission Facebook will have to review how your app uses it
| user_photos | Constant |
public static const user_photos:String = user_photos
Provides access to the photos a person has uploaded or been tagged in. This is available through the photos edge on the User object.
If your app requests this permission Facebook will have to review how your app uses it.
| user_posts | Constant |
public static const user_posts:String = user_posts
Provides access to the posts on a person's Timeline. Includes their own posts, posts they are tagged in, and posts other people make on their Timeline.
If your app requests this permission Facebook will have to review how your app uses it.
| user_relationship_details | Constant |
public static const user_relationship_details:String = user_relationship_details
Provides access to a person's relationship interests as the interested_in field on the User object.
If your app requests this permission Facebook will have to review how your app uses it
| user_relationships | Constant |
public static const user_relationships:String = user_relationships
Provides access to a person's relationship status, significant other and family members as fields on the User object.
If your app requests this permission Facebook will have to review how your app uses it.
| user_religion_politics | Constant |
public static const user_religion_politics:String = user_religion_politics
Provides access to a person's religious and political affiliations.
If your app requests this permission Facebook will have to review how your app uses it.
| user_status | Constant |
public static const user_status:String = user_status
Provides access to a person's statuses. These are posts on Facebook which don't include links, videos or photos.
If your app requests this permission Facebook will have to review how your app uses it
| user_tagged_places | Constant |
public static const user_tagged_places:String = user_tagged_places
Provides access to the Places a person has been tagged at in photos, videos, statuses and links.
If your app requests this permission Facebook will have to review how your app uses it
| user_videos | Constant |
public static const user_videos:String = user_videos
Provides access to the videos a person has uploaded or been tagged in.
If your app requests this permission Facebook will have to review how your app uses it
| user_website | Constant |
public static const user_website:String = user_website
Provides access to the person's personal website URL via the website field on the User object.
If your app requests this permission Facebook will have to review how your app uses it.
| user_work_history | Constant |
public static const user_work_history:String = user_work_history
Provides access to a person's work history and list of employers via the work field on the User object.
If your app requests this permission Facebook will have to review how your app uses it