This class represents an access token returned by the Facebook Login service, along with associated metadata such as its expiration date and permissions. In general, the Session class will abstract away the need to worry about the details of an access token, but there are situations (such as handling native links, importing previously-obtained access tokens, etc.) where it is useful to deal with access tokens directly. Factory methods are provided to construct access tokens.
For more information on access tokens, see Access Tokens.
| Extends: | Object |
| Implements: | Serializable |
| Package: | facebook |
createFromExistingAccessToken(String, Date, Date, AccessTokenSource, List)Creates a new AccessToken using the supplied information from a previously-obtained access token (for instance, from an already-cached access token obtained prior to integration with the Facebook SDK).
public static AccessToken createFromExistingAccessToken(String accessToken, Date expirationTime, Date lastRefreshTime, AccessTokenSource accessTokenSource, List permissions) | Parameter | Description |
|---|---|
accessToken | The access token string obtained from Facebook |
expirationTime | The expiration date associated with the token; if null, an infinite expiration time is assumed (but will become correct when the token is refreshed) |
lastRefreshTime | The last time the token was refreshed (or when it was first obtained); if null, the current time is used. |
accessTokenSource | An enum indicating how the token was originally obtained (in most cases, this will be either AccessTokenSource.FACEBOOK_APPLICATION or AccessTokenSource.WEB_VIEW); if null, FACEBOOK_APPLICATION is assumed. |
permissions | The permissions that were requested when the token was obtained (or when it was last reauthorized); may be null if permission set is unknown |
createFromNativeLinkingIntent(Intent)Creates a new AccessToken using the information contained in an Intent populated by the Facebook application in order to launch a native link. For more information on native linking, please see https://developers.facebook.com/docs/mobile/android/deep_linking/.
public static AccessToken createFromNativeLinkingIntent(Intent intent) | Parameter | Description |
|---|---|
intent | The Intent that was used to start an Activity; must not be null |
getToken()Gets the string representing the access token.
public String getToken() getExpires()Gets the date at which the access token expires.
public Date getExpires() getPermissions()Gets the list of permissions associated with this access token. Note that the most up-to-date list of permissions is maintained by the Facebook service, so this list may be outdated if permissions have been added or removed since the time the AccessToken object was created. For more information on permissions, see https://developers.facebook.com/docs/reference/login/#permissions.
public List getPermissions() getDeclinedPermissions()Gets the list of permissions declined by the user with this access token. It represents the entire set of permissions that have been requested and declined. Note that the most up-to-date list of permissions is maintained by the Facebook service, so this list may be outdated if permissions have been granted or declined since the last time an AccessToken object was created.
public List getDeclinedPermissions() getSource()Gets the AccessTokenSource indicating how this access token was obtained.
public AccessTokenSource getSource() getLastRefresh()Gets the date at which the token was last refreshed. Since tokens expire, the Facebook SDK will attempt to renew them periodically.
public Date getLastRefresh()