com.sromku.simple.fb

Enum Permission

java.lang.Object

java.lang.Enum<Permission>

com.sromku.simple.fb.Permission

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<Permission>

public enum Permission
extends java.lang.Enum<Permission>

All facebook permissions.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Permission.Role
static class	Permission.Type Permission type enum: READ PUBLISH

Enum Constant Summary

Enum Constants

Enum Constant and Description
ADS_READ Provides the access to Ads Insights API to pull ads report information for ad accounts you have access to.
EMAIL Provides access to the person's primary email address via the Profile.Properties#EMAIL property on the Profile object. Note: Even if you request the email permission it is not guaranteed you will get an email address.
MANAGE_NOTIFICATIONS Deprecated.
MANAGE_PAGES Enables your app to retrieve Page Access Tokens for the Pages and Apps that the person administrates.
PUBLIC_PROFILE Deprecated.
PUBLISH_ACTION Provides access to publish Posts, Open Graph actions, achievements, scores and other activity on behalf of a person using your app.
READ_AUDIENCE_NETWORK_INSIGHTS Provides read-only access to the Audience Network Insights data for Apps the person owns.
READ_CUSTOM_FRIENDLISTS Provides access to the names of custom lists a person has created to organize their friends.
READ_FRIENDLISTS Deprecated.
READ_INSIGHTS Provides read-only access to the Insights data for Pages, Apps and web domains the person owns.
READ_MAILBOX Deprecated.
READ_PAGE_MAILBOX Provides the ability to read from the Page Inboxes of the Pages managed by a person.
READ_STREAM Deprecated.
RSVP_EVENT Provides the ability to set a person's attendee status on Facebook Events (e.g.
USER_ABOUT_ME Provides access to BIO property of the Profile
USER_ACTIONS_BOOKS Provides access to all common books actions published by any app the person has used.
USER_ACTIONS_FITNESS Provides access to all common Open Graph fitness actions published by any app the person has used.
USER_ACTIONS_MUSIC Provides access to all common Open Graph music actions published by any app the person has used.
USER_ACTIONS_NEWS Provides access to all common Open Graph news actions published by any app the person has used which publishes these actions.
USER_ACTIONS_VIDEO Provides access to all common Open Graph video actions published by any app the person has used which publishes these actions.
USER_ACTIVITIES Deprecated.
USER_BIRTHDAY Access the date and month of a person's birthday.
USER_EDUCATION_HISTORY Provides access to EDUCATION property of the Profile
USER_EVENTS Provides read-only access to the Events a person is hosting or has RSVP'd to.
USER_FRIENDS Provides access the list of friends that also use your app.
USER_GAMES_ACTIVITY Provides access to read a person's game activity (scores, achievements) in any game the person has played.
USER_GROUPS Deprecated.
USER_HOMETOWN Provides access to a person's hometown location through the hometown field on the User object.
USER_INTERESTS Deprecated.
USER_LIKES Provides access to the list of all Facebook Pages and Open Graph objects that a person has liked.
USER_LOCATION Provides access to a person's current city through the location field on the User object.
USER_MANAGED_GROUPS Enables your app to read the Groups a person is a member of through the groups edge on the User object.
USER_PHOTOS Provides access to the photos a person has uploaded or been tagged in.
USER_POSTS Provides access to the posts on a person's Timeline.
USER_RELATIONSHIP_DETAILS Provides access to a person's relationship interests as the interested_in field on the User object.
USER_RELATIONSHIPS Provides access to a person's relationship status, significant other and family members as fields on the User object.
USER_RELIGION_POLITICS Provides access to a person's religious and political affiliations.
USER_STATUS Provides access to a person's statuses.
USER_TAGGED_PLACES Provides access to the Places a person has been tagged at in photos, videos, statuses and links.
USER_VIDEOS Provides access to the videos a person has uploaded or been tagged in
USER_WEBSITE Provides access to the person's personal website URL via the website field on the Profile entity.
USER_WORK_HISTORY Provides access to a person's work history and list of employers via the work field on the Profile entity.

Method Summary

Methods

Modifier and Type	Method and Description
static java.util.List<Permission>	convert(java.util.Collection<java.lang.String> rawPermissions)
static java.util.List<java.lang.String>	convert(java.util.List<Permission> permissions)
static java.util.List<java.lang.String>	fetchPermissions(java.util.List<Permission> permissions, Permission.Type type)
static Permission	fromValue(java.lang.String permissionValue)
Permission.Type	getType()
java.lang.String	getValue()
static Permission	valueOf(java.lang.String name) Returns the enum constant of this type with the specified name.
static Permission[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

PUBLIC_PROFILE

@Deprecated
public static final Permission PUBLIC_PROFILE

Deprecated.

This permission not longer in use in latest graph versions. Please us Permission#USER_ABOUT_ME instead. Provides access to a subset of items that are part of a person's public profile. These Profile fields can be retrieved by using this permission:

• ID
• NAME
• FIRST_NAME
• LAST_NAME
• LINK
• GENDER
• LOCALE
• AGE_RANGE

USER_ABOUT_ME

public static final Permission USER_ABOUT_ME

Provides access to BIO property of the Profile

USER_ACTIONS_BOOKS

public static final Permission 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.

USER_ACTIONS_FITNESS

public static final Permission 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.

USER_ACTIONS_MUSIC

public static final Permission 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.

USER_ACTIONS_NEWS

public static final Permission 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.

USER_ACTIONS_VIDEO

public static final Permission 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.

USER_ACTIVITIES

@Deprecated
public static final Permission USER_ACTIVITIES

Deprecated.

This permission not longer in use in latest graph versions. Provides access to a person's list of activities as listed on their Profile. This is a subset of the pages they have liked, where those pages represent particular interests. This information is accessed through the activities connection on the user node.

USER_BIRTHDAY

public static final Permission 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.

USER_EDUCATION_HISTORY

public static final Permission USER_EDUCATION_HISTORY

Provides access to EDUCATION property of the Profile

USER_EVENTS

public static final Permission USER_EVENTS

Provides read-only access to the Events a person is hosting or has RSVP'd to.

USER_FRIENDS

public static final Permission USER_FRIENDS

Provides access the list of friends that also use your app. 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.

USER_GAMES_ACTIVITY

public static final Permission USER_GAMES_ACTIVITY

Provides access to read a person's game activity (scores, achievements) in any game the person has played.

USER_GROUPS

@Deprecated
public static final Permission USER_GROUPS

Deprecated.

This permission not longer in use in latest graph versions. Please us Permission#USER_MANAGED_GROUPS instead. 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

USER_MANAGED_GROUPS

public static final Permission USER_MANAGED_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

USER_HOMETOWN

public static final Permission 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.

USER_INTERESTS

@Deprecated
public static final Permission USER_INTERESTS

Deprecated.

This permission not longer in use in latest graph versions. Provides access to the list of interests in a person's Profile. This is a subset of the pages they have liked which represent particular interests.

USER_LIKES

public static final Permission 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.

USER_LOCATION

public static final Permission 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.

USER_PHOTOS

public static final Permission 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.

USER_RELATIONSHIPS

public static final Permission USER_RELATIONSHIPS

Provides access to a person's relationship status, significant other and family members as fields on the User object.

USER_RELATIONSHIP_DETAILS

public static final Permission USER_RELATIONSHIP_DETAILS

Provides access to a person's relationship interests as the interested_in field on the User object.

USER_RELIGION_POLITICS

public static final Permission USER_RELIGION_POLITICS

Provides access to a person's religious and political affiliations.

USER_STATUS

public static final Permission USER_STATUS

Provides access to a person's statuses. These are posts on Facebook which don't include links, videos or photos.

USER_TAGGED_PLACES

public static final Permission USER_TAGGED_PLACES

Provides access to the Places a person has been tagged at in photos, videos, statuses and links.

USER_VIDEOS

public static final Permission USER_VIDEOS

Provides access to the videos a person has uploaded or been tagged in

USER_WEBSITE

public static final Permission USER_WEBSITE

Provides access to the person's personal website URL via the website field on the Profile entity.

USER_WORK_HISTORY

public static final Permission USER_WORK_HISTORY

Provides access to a person's work history and list of employers via the work field on the Profile entity.

READ_FRIENDLISTS

@Deprecated
public static final Permission READ_FRIENDLISTS

Deprecated.

This permission not longer in use in latest graph versions. Please us Permission#READ_CUSTOM_FRIENDLISTS instead. 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.

READ_CUSTOM_FRIENDLISTS

public static final Permission 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.

READ_INSIGHTS

public static final Permission READ_INSIGHTS

Provides read-only access to the Insights data for Pages, Apps and web domains the person owns.

READ_MAILBOX

@Deprecated
public static final Permission READ_MAILBOX

Deprecated.

This permission not longer in use in latest graph versions. Provides the ability to read the messages in a person's Facebook Inbox through the inbox edge and the thread node

READ_STREAM

@Deprecated
public static final Permission READ_STREAM

Deprecated.

This permission not longer in use in latest graph versions. Please us Permission#USER_POSTS instead. Provides access to read the posts in a person's News Feed, or the posts on their Profile.

READ_PAGE_MAILBOX

public static final Permission READ_PAGE_MAILBOX

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.

EMAIL

public static final Permission EMAIL

Provides access to the person's primary email address via the Profile.Properties#EMAIL property on the Profile object.

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.

USER_POSTS

public static final Permission 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.

ADS_READ

public static final Permission ADS_READ

Provides the access to Ads Insights API to pull ads report information for ad accounts you have access to.

READ_AUDIENCE_NETWORK_INSIGHTS

public static final Permission READ_AUDIENCE_NETWORK_INSIGHTS

Provides read-only access to the Audience Network Insights data for Apps the person owns.

PUBLISH_ACTION

public static final Permission PUBLISH_ACTION

Provides access to publish Posts, Open Graph actions, achievements, scores and other activity on behalf of a person using your app.

RSVP_EVENT

public static final Permission RSVP_EVENT

Provides the ability to set a person's attendee status on Facebook Events (e.g. attending, maybe, or declined). This permission does not let you invite people to an event. This permission does not let you update an event's details. This permission does not let you create an event. There is no way to create an event via the API as of Graph API v2.0.

MANAGE_NOTIFICATIONS

@Deprecated
public static final Permission MANAGE_NOTIFICATIONS

Deprecated.

This permission not longer in use in latest graph versions. Enables your app to read a person's notifications and mark them as read. This permission does not let you send notifications to a person.

MANAGE_PAGES

public static final Permission MANAGE_PAGES

Enables your app to retrieve Page Access Tokens for the Pages and Apps that the person administrates.

Method Detail

values

public static Permission[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (Permission c : Permission.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static Permission valueOf(java.lang.String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

java.lang.IllegalArgumentException - if this enum type has no constant with the specified name

java.lang.NullPointerException - if the argument is null

getValue

public java.lang.String getValue()

getType

public Permission.Type getType()

fromValue

public static Permission fromValue(java.lang.String permissionValue)

convert

public static java.util.List<Permission> convert(java.util.Collection<java.lang.String> rawPermissions)

convert

public static java.util.List<java.lang.String> convert(java.util.List<Permission> permissions)

fetchPermissions

public static java.util.List<java.lang.String> fetchPermissions(java.util.List<Permission> permissions,
                                                Permission.Type type)