|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
public interface IFacebookRestClient<T>
Generic interface for a FacebookRestClient, parameterized by output format. For continually updated documentation, please refer to the Developer Wiki.
| Field Summary | |
|---|---|
static java.lang.String |
ERROR_TAG
|
static java.lang.String |
TARGET_API_VERSION
|
| Method Summary | |
|---|---|
int |
admin_getAllocation(AllocationType allocationType)
Get your application's current allocation of the specified type of request (i.e. |
int |
admin_getAllocation(AllocationType allocationType,
java.lang.Long userId)
Get your application's current allocation of the specified type of request (i.e. |
int |
admin_getAllocation(java.lang.String allocationType)
Get your application's current allocation of the specified type of request (i.e. |
int |
admin_getAllocation(java.lang.String allocationType,
java.lang.Long userId)
Get your application's current allocation of the specified type of request (i.e. |
org.json.JSONObject |
admin_getAppProperties(java.util.Collection<ApplicationProperty> properties)
Deprecated. use admin_getAppPropertiesMap() instead |
ApplicationPropertySet |
admin_getAppPropertiesAsSet(java.util.Collection<ApplicationProperty> properties)
Gets property values previously set for an application on either the Facebook Developer application or the with the admin.setAppProperties call. |
java.lang.String |
admin_getAppPropertiesAsString(java.util.Collection<ApplicationProperty> properties)
Retrieve application properties. |
java.util.Map<ApplicationProperty,java.lang.String> |
admin_getAppPropertiesMap(java.util.Collection<ApplicationProperty> properties)
Retrieve application properties. |
T |
admin_getDailyMetrics(java.util.Set<Metric> metrics,
java.util.Date start,
java.util.Date end)
Deprecated. |
T |
admin_getDailyMetrics(java.util.Set<Metric> metrics,
long start,
long end)
Deprecated. |
T |
admin_getMetrics(java.util.Set<Metric> metrics,
java.util.Date start,
java.util.Date end,
long period)
Retrieve metrics for the current application. |
T |
admin_getMetrics(java.util.Set<Metric> metrics,
long start,
long end,
long period)
Retrieve the daily metrics for the current application. |
int |
admin_getNotificationAllocation()
Deprecated. |
int |
admin_getRequestAllocation()
Deprecated. |
boolean |
admin_setAppProperties(ApplicationPropertySet properties)
Sets several property values for an application. |
boolean |
admin_setAppProperties(java.util.Map<ApplicationProperty,java.lang.String> properties)
Set application properties. |
T |
application_getPublicInfo(java.lang.Long applicationId,
java.lang.String applicationKey,
java.lang.String applicationCanvas)
Gets the public information about the specified application. |
T |
application_getPublicInfoByApiKey(java.lang.String applicationKey)
Gets the public information about the specified application, by API key. |
T |
application_getPublicInfoByCanvasName(java.lang.String applicationCanvas)
Gets the public information about the specified application, by canvas-page name. |
T |
application_getPublicInfoById(java.lang.Long applicationId)
Gets the public information about the specified application, by application id. |
java.lang.String |
auth_createToken()
Call this function and store the result, using it to generate the appropriate login url and then to retrieve the session information. |
boolean |
auth_expireSession()
Expires the curently active session. |
java.lang.String |
auth_getSession(java.lang.String authToken)
Call this function to retrieve the session information after your user has logged in. |
java.lang.String |
auth_getSession(java.lang.String authToken,
boolean generateSessionSecret)
Call this function to retrieve the session information after your user has logged in. |
java.lang.String |
auth_promoteSession()
Generate a key for the current session that can be used to authenticate client-side components. |
boolean |
auth_revokeAuthorization()
If this method is called for the logged in user, then no further API calls can be made on that user's behalf until the user decides to authorize the application again. |
boolean |
auth_revokeExtendedPermission(Permission perm)
|
boolean |
auth_revokeExtendedPermission(Permission perm,
java.lang.Long userId)
Revokes the specified extended permission for the selected user. |
T |
batch_run(java.lang.String methods,
boolean serial)
Executes a batch of queries. |
void |
beginBatch()
Starts a batch of queries. |
void |
beginPermissionsMode(java.lang.String apiKey)
Begins permissions mode, and allows the current application to begin making requests on behalf of the application associated with the specified API key. |
int |
connect_getUnconnectedFriendsCount()
This method returns the number of friends of the current user who have accounts on your site, but have not yet connected their accounts. |
T |
connect_registerUsers(java.util.Collection<java.util.Map<java.lang.String,java.lang.String>> accounts)
This method is used to create an association between an external user account and a Facebook user account. |
T |
connect_unregisterUsers(java.util.Collection<java.lang.String> email_hashes)
This method allows a site to unregister a previously registered account (using connect.registerUsers). |
java.lang.Long |
dashboard_addGlobalNews(java.util.Collection<DashboardNewsItem> newsItems)
Non-imageUrl method signature form. |
java.lang.Long |
dashboard_addGlobalNews(java.util.Collection<DashboardNewsItem> newsItems,
java.lang.String imageUrl)
Submits global news items for all users of the app. |
boolean |
dashboard_clearGlobalNews()
Clears all global news items from application. |
boolean |
dashboard_clearGlobalNews(java.util.Collection<java.lang.Long> newsIds)
Clears specific global news items from application. |
T |
dashboard_multiAddNews(java.util.Collection<java.lang.Long> userIds,
java.util.Collection<DashboardNewsItem> newsItems)
Non-imageUrl method signature form. |
T |
dashboard_multiAddNews(java.util.Collection<java.lang.Long> userIds,
java.util.Collection<DashboardNewsItem> newsItems,
java.lang.String imageUrl)
Adds all of the supplied news items to each of the users specified. |
T |
dashboard_multiClearNews(java.util.Collection<java.lang.Long> userIds)
Clears all of the news items associated to the specified users. |
T |
dashboard_multiClearNews(java.util.Map<java.lang.Long,java.util.Collection<java.lang.Long>> userIdToNewsIdsMap)
Removes the referenced news items against each of the users specified. |
java.util.Set<java.lang.Long> |
dashboard_multiIncrementCount(java.util.Collection<java.lang.Long> userIds)
Increments the dashboard bookmark counter by one for the given set of users. |
java.lang.Long |
dashboard_publishActivity(DashboardActivityItem activityItem)
Non-imageUrl method signature form. |
java.lang.Long |
dashboard_publishActivity(DashboardActivityItem activityItem,
java.lang.String imageUrl)
Submits activity for a given user as it will appear in the dashboard section, 'what your friends are doing'. |
long |
data_createObject(java.lang.String objectType,
java.util.Map<java.lang.String,java.lang.String> properties)
Create object in Data Store |
void |
data_createObjectType(java.lang.String name)
An object type is like a "table" in SQL terminology, or a "class" in object-oriented programming concepts. |
void |
data_defineAssociation(java.lang.String associationName,
AssociationType associationType,
AssociationInfo associationInfo1,
AssociationInfo associationInfo2,
java.lang.String inverseName)
|
void |
data_defineObjectProperty(java.lang.String objectType,
java.lang.String propertyName,
PropertyType propertyType)
|
void |
data_deleteObject(long objectId)
Delete object in Data Store |
void |
data_deleteObjects(java.util.Collection<java.lang.Long> objectIds)
Delete multiple objects in Data Store WARNING: This method seems to fail when it comes across the first object that it can't find. |
void |
data_dropObjectType(java.lang.String objectType)
Remove a previously defined object type. |
long |
data_getAssociatedObjectCount(java.lang.String associationName,
long objectId)
Returns count of object ids that are associated with specified object. |
T |
data_getAssociationDefinition(java.lang.String associationName)
|
T |
data_getAssociationDefinitions()
|
T |
data_getCookies()
Get all cookies for the currently logged-in user. |
T |
data_getCookies(java.lang.Long userId)
Get all cookies for the specified user. |
T |
data_getCookies(java.lang.Long userId,
java.lang.CharSequence name)
Get a specific cookie for the specified user. |
T |
data_getCookies(java.lang.String name)
Get a specific cookie for the currently logged-in user. |
T |
data_getObject(long objectId)
|
T |
data_getObjectProperty(long objectId,
java.lang.String propertyName)
|
T |
data_getObjects(java.util.Collection<java.lang.Long> objectIds)
|
T |
data_getObjectType(java.lang.String objectType)
|
T |
data_getObjectTypes()
|
java.lang.String |
data_getUserPreference(int prefId)
Lookup a single preference value for the current user. |
T |
data_getUserPreferences()
Get a map containing all preference values set for the current user. |
void |
data_removeAssociatedObjects(java.lang.String associationName,
long objectId)
The name of this function may be misleading, but it actually removes associations between any other objects and a specified object. |
void |
data_removeAssociation(java.lang.String associationName,
long object1Id,
long object2Id)
Removes an association between two object identifiers. |
void |
data_renameAssociation(java.lang.String name,
java.lang.String newName,
java.lang.String newAlias1,
java.lang.String newAlias2)
Rename a previously defined association. |
void |
data_renameObjectProperty(java.lang.String objectType,
java.lang.String propertyName,
java.lang.String newPropertyName)
|
void |
data_renameObjectType(java.lang.String name,
java.lang.String newName)
|
void |
data_setAssociation(java.lang.String associationName,
long object1Id,
long object2Id,
java.lang.String data,
java.util.Date associationTime)
Create an association between two objects |
boolean |
data_setCookie(java.lang.Long userId,
java.lang.CharSequence name,
java.lang.CharSequence value)
Set a cookie for the specified user. |
boolean |
data_setCookie(java.lang.Long userId,
java.lang.CharSequence name,
java.lang.CharSequence value,
java.lang.CharSequence path)
Set a cookie for the specified user, with the specified path. |
boolean |
data_setCookie(java.lang.Long userId,
java.lang.CharSequence name,
java.lang.CharSequence value,
java.lang.Long expires)
Set a cookie for the specified user, with the specified expiration date. |
boolean |
data_setCookie(java.lang.Long userId,
java.lang.CharSequence name,
java.lang.CharSequence value,
java.lang.Long expires,
java.lang.CharSequence path)
Set a cookie for the specified user, with the specified expiration date and path. |
boolean |
data_setCookie(java.lang.String name,
java.lang.String value)
Set a cookie for the current user. |
boolean |
data_setCookie(java.lang.String name,
java.lang.String value,
java.lang.Long expires)
Set a cookie for the current user, with the specified expiration date. |
boolean |
data_setCookie(java.lang.String name,
java.lang.String value,
java.lang.Long expires,
java.lang.String path)
Set a cookie for the current user, with the specified expiration date and path. |
boolean |
data_setCookie(java.lang.String name,
java.lang.String value,
java.lang.String path)
Set a cookie for the current user, under the specified path. |
void |
data_setObjectProperty(long objectId,
java.lang.String propertyName,
java.lang.String value)
|
void |
data_setUserPreference(int prefId,
java.lang.String value)
Set a user-preference value. |
void |
data_setUserPreferences(java.util.Map<java.lang.Integer,java.lang.String> values,
boolean replace)
Set multiple user-preferences values. |
void |
data_undefineAssociation(java.lang.String name)
Remove a previously defined association. |
void |
data_undefineObjectProperty(java.lang.String objectType,
java.lang.String propertyName)
|
void |
data_updateObject(long objectId,
java.util.Map<java.lang.String,java.lang.String> properties,
boolean replace)
Update properties of an existing object in Data Store |
void |
endPermissionsMode()
Terminates permissions mode. |
boolean |
events_cancel(java.lang.Long eid,
java.lang.String cancel_message)
Cancels an event. |
java.lang.Long |
events_create(java.util.Map<java.lang.String,java.lang.String> event_info)
Creates an event on behalf of the user if the application has an active session key for that user; otherwise it creates an event on behalf of the application. |
boolean |
events_edit(java.lang.Long eid,
java.util.Map<java.lang.String,java.lang.String> event_info)
Edits the details of an existing event. |
T |
events_get(java.lang.Long userId,
java.util.Collection<java.lang.Long> eventIds,
java.lang.Long startTime,
java.lang.Long endTime)
Returns all visible events according to the filters specified. |
T |
events_get(java.lang.Long userId,
java.util.Collection<java.lang.Long> eventIds,
java.lang.Long startTime,
java.lang.Long endTime,
java.lang.String rsvp_status)
Returns all visible events according to the filters specified. |
T |
events_getMembers(java.lang.Long eventId)
Retrieves the membership list of an event |
boolean |
events_rsvp(java.lang.Long eid,
java.lang.String rsvp_status)
Sets a user's RSVP status for an event. |
java.util.List<? extends java.lang.Object> |
executeBatch(boolean serial)
Executes a batch of queries. |
void |
fbml_deleteCustomTags(java.util.Collection<java.lang.String> names)
Deletes one or more custom tags you previously registered for the calling application with fbml.registerCustomTags. |
T |
fbml_getCustomTags(java.lang.String appId)
Returns the custom tag definitions for tags that were previously defined using fbml.registerCustomTags. |
boolean |
fbml_refreshImgSrc(java.lang.String imageUrl)
Recaches the image with the specified imageUrl. |
boolean |
fbml_refreshImgSrc(java.net.URL imageUrl)
Recaches the image with the specified imageUrl. |
boolean |
fbml_refreshRefUrl(java.lang.String url)
Recaches the referenced url. |
boolean |
fbml_refreshRefUrl(java.net.URL url)
Recaches the referenced url. |
void |
fbml_registerCustomTags(java.util.Collection<org.json.JSONObject> tags)
Registers custom tags you can include in your that applications' FBML markup. |
boolean |
fbml_setRefHandle(java.lang.String handle,
java.lang.String markup)
Associates the specified FBML markup with the specified handle/id. |
boolean |
feed_deactivateTemplateBundleByID(java.lang.Long bundleId)
Deprecated. |
T |
feed_getRegisteredTemplateBundleByID(java.lang.Long id)
Deprecated. |
T |
feed_getRegisteredTemplateBundles()
Deprecated. |
boolean |
feed_publishTemplatizedAction(java.lang.CharSequence titleTemplate)
Deprecated. |
boolean |
feed_publishTemplatizedAction(java.lang.CharSequence titleTemplate,
java.lang.Long pageActorId)
Deprecated. |
boolean |
feed_publishTemplatizedAction(java.lang.CharSequence titleTemplate,
java.util.Map<java.lang.String,java.lang.CharSequence> titleData,
java.lang.CharSequence bodyTemplate,
java.util.Map<java.lang.String,java.lang.CharSequence> bodyData,
java.lang.CharSequence bodyGeneral,
java.util.Collection<java.lang.Long> targetIds,
java.util.Collection<? extends IPair<? extends java.lang.Object,java.net.URL>> images,
java.lang.Long pageActorId)
Deprecated. |
boolean |
feed_publishTemplatizedAction(java.lang.Integer actorId,
java.lang.CharSequence titleTemplate,
java.util.Map<java.lang.String,java.lang.CharSequence> titleData,
java.lang.CharSequence bodyTemplate,
java.util.Map<java.lang.String,java.lang.CharSequence> bodyData,
java.lang.CharSequence bodyGeneral,
java.util.Collection<java.lang.Long> targetIds,
java.util.Collection<? extends IPair<? extends java.lang.Object,java.net.URL>> images)
Deprecated. use the version that specified the actorId as a Long instead. UID's *are not ever to be* expressed as Integers. |
boolean |
feed_publishTemplatizedAction(java.lang.Long actorId,
java.lang.CharSequence titleTemplate)
Deprecated. since 01/18/2008 |
boolean |
feed_publishTemplatizedAction(java.lang.Long actorId,
java.lang.CharSequence titleTemplate,
java.util.Map<java.lang.String,java.lang.CharSequence> titleData,
java.lang.CharSequence bodyTemplate,
java.util.Map<java.lang.String,java.lang.CharSequence> bodyData,
java.lang.CharSequence bodyGeneral,
java.util.Collection<java.lang.Long> targetIds,
java.util.Collection<? extends IPair<? extends java.lang.Object,java.net.URL>> images)
Deprecated. |
boolean |
feed_publishTemplatizedAction(java.lang.String titleTemplate,
java.lang.String titleData,
java.lang.String bodyTemplate,
java.lang.String bodyData,
java.lang.String bodyGeneral,
java.util.Collection<? extends IPair<? extends java.lang.Object,java.net.URL>> pictures,
java.lang.String targetIds)
Deprecated. |
boolean |
feed_PublishTemplatizedAction(TemplatizedAction action)
Deprecated. |
java.lang.Boolean |
feed_publishUserAction(java.lang.Long bundleId)
Deprecated. |
java.lang.Boolean |
feed_publishUserAction(java.lang.Long bundleId,
java.util.Map<java.lang.String,java.lang.String> templateData,
java.util.List<IFeedImage> images,
java.util.List<java.lang.Long> targetIds,
java.lang.String bodyGeneral,
int storySize)
Deprecated. |
java.lang.Boolean |
feed_publishUserAction(java.lang.Long bundleId,
java.util.Map<java.lang.String,java.lang.String> templateData,
java.util.List<java.lang.Long> targetIds,
java.lang.String bodyGeneral)
Deprecated. |
java.lang.Long |
feed_registerTemplateBundle(java.util.Collection<java.lang.String> templates)
Deprecated. |
java.lang.Long |
feed_registerTemplateBundle(java.util.Collection<java.lang.String> templates,
java.util.Collection<BundleStoryTemplate> shortTemplates,
BundleStoryTemplate longTemplate)
Deprecated. |
java.lang.Long |
feed_registerTemplateBundle(java.util.Collection<java.lang.String> templates,
java.util.Collection<BundleStoryTemplate> shortTemplates,
BundleStoryTemplate longTemplate,
java.util.List<BundleActionLink> actionLinks)
Deprecated. |
java.lang.Long |
feed_registerTemplateBundle(java.lang.String template)
Deprecated. |
java.lang.Long |
feed_registerTemplateBundle(java.lang.String template,
java.lang.String shortTemplate,
java.lang.String longTemplate)
Deprecated. Facebook has greatly modified the syntax required for the 'shortTemplate' and 'longTemplate' parameters. As such this method will now ignore those parameters. You are encouraged to use one of the alternate versions. |
T |
fql_query(java.lang.CharSequence query)
Retrieves the results of a Facebook Query Language query |
T |
friends_areFriends(java.util.Collection<java.lang.Long> userIds1,
java.util.Collection<java.lang.Long> userIds2)
Retrieves whether pairs of users are friends. |
T |
friends_areFriends(long userId1,
long userId2)
Retrieves whether two users are friends. |
T |
friends_get()
Retrieves the friends of the currently logged in user. |
T |
friends_get(java.lang.Long uid)
Retrieves the friends uid. |
T |
friends_getAppUsers()
Retrieves the friends of the currently logged in user, who are also users of the calling application. |
T |
friends_getList(java.lang.Long friendListId)
Retrieves the friends of the currently logged in user that are members of the friends list with ID friendListId. |
T |
friends_getLists()
Retrieves the friend lists of the currently logged in user. |
T |
friends_getMutualFriends(java.lang.Long targetId)
Returns the Facebook user IDs of the mutual friends between the source user and target user. |
T |
friends_getMutualFriends(java.lang.Long sourceId,
java.lang.Long targetId)
Returns the Facebook user IDs of the mutual friends between the source user and target user. |
java.lang.String |
getApiKey()
|
java.lang.Boolean |
getCacheAppUser()
Deprecated. |
java.lang.Long |
getCacheSessionExpires()
|
java.lang.String |
getCacheSessionKey()
|
java.lang.Long |
getCacheUserId()
|
int |
getConnectTimeout()
Deprecated. |
java.lang.String |
getRawResponse()
Returns a string representation for the last API response recieved from Facebook, exactly as sent by the API server. |
int |
getReadTimeout()
Deprecated. |
java.lang.String |
getResponseFormat()
|
java.lang.String |
getSecret()
|
java.net.URL |
getServerUrl()
|
T |
groups_get(java.lang.Long userId,
java.util.Collection<java.lang.Long> groupIds)
Retrieves the groups associated with a user |
T |
groups_getMembers(java.lang.Number groupId)
Retrieves the membership list of a group |
int |
intl_uploadNativeStrings(java.util.Map<java.lang.String,java.lang.String> native_strings)
Lets you insert text strings in their native language into the Facebook Translations database so they can be translated. |
boolean |
isDesktop()
Check to see if the client is running in desktop-app mode |
java.lang.Long |
links_post(java.lang.Long userId,
java.lang.String url,
java.lang.String comment)
Posts a link to the specified user's Wall. |
java.lang.Boolean |
liveMessage_send(java.lang.Long recipient,
java.lang.String eventName,
org.json.JSONObject message)
Sends a message using the LiveMessage API. |
T |
notifications_get()
Deprecated. |
java.util.Collection<java.lang.String> |
notifications_send(java.lang.CharSequence notification)
Deprecated. |
java.util.Collection<java.lang.String> |
notifications_send(java.util.Collection<java.lang.Long> recipientIds,
java.lang.CharSequence notification)
Deprecated. |
java.net.URL |
notifications_send(java.util.Collection<java.lang.Long> recipientIds,
java.lang.CharSequence notification,
java.lang.CharSequence email)
Deprecated. notifications.send can no longer be used for sending e-mails, use notifications.sendEmail intead when sending e-mail, or the alternate version of notifications.send if all you want to send is a notification. |
java.util.Collection<java.lang.String> |
notifications_send(java.util.Collection<java.lang.Long> recipientIds,
java.lang.String notification,
boolean isAppToUser)
Deprecated. |
java.lang.String |
notifications_sendEmail(java.util.Collection<java.lang.Long> recipientIds,
java.lang.CharSequence subject,
java.lang.CharSequence fbml)
Deprecated. provided for legacy support only, please use one of the alternate notifications_sendEmail calls. |
java.util.Collection<java.lang.String> |
notifications_sendEmail(java.util.Collection<java.lang.Long> recipients,
java.lang.CharSequence subject,
java.lang.CharSequence email,
java.lang.CharSequence fbml)
Send an e-mail to a set of app-users. |
java.lang.String |
notifications_sendEmailPlain(java.util.Collection<java.lang.Long> recipientIds,
java.lang.CharSequence subject,
java.lang.CharSequence text)
Deprecated. provided for legacy support only, please use one of the alternate notifications_sendEmail calls. |
java.lang.String |
notifications_sendEmailStr(java.util.Collection<java.lang.Long> recipientIds,
java.lang.CharSequence subject,
java.lang.CharSequence fbml,
java.lang.CharSequence text)
Deprecated. provided for legacy support only, please use one of the alternate notifications_sendEmail calls. |
java.util.Collection<java.lang.String> |
notifications_sendEmailToCurrentUser(java.lang.String subject,
java.lang.String email,
java.lang.String fbml)
Send an e-mail to the currently logged-in user. |
java.util.Collection<java.lang.String> |
notifications_sendFbmlEmail(java.util.Collection<java.lang.Long> recipients,
java.lang.String subject,
java.lang.String fbml)
Send an e-mail to a set of app-users. |
java.util.Collection<java.lang.String> |
notifications_sendFbmlEmailToCurrentUser(java.lang.String subject,
java.lang.String fbml)
Send an e-mail to the currently logged-in user. |
java.util.Collection<java.lang.String> |
notifications_sendTextEmail(java.util.Collection<java.lang.Long> recipients,
java.lang.String subject,
java.lang.String email)
Send an e-mail to a set of app-users. |
java.util.Collection<java.lang.String> |
notifications_sendTextEmailToCurrentUser(java.lang.String subject,
java.lang.String email)
Send an e-mail to the currently logged-in user. |
T |
pages_getInfo(java.util.Collection<java.lang.Long> pageIds,
java.util.Collection<PageProfileField> fields)
Retrieves the requested profile fields for the Facebook Pages with the given pageIds. |
T |
pages_getInfo(java.util.Collection<java.lang.Long> pageIds,
java.util.Set<java.lang.CharSequence> fields)
Retrieves the requested profile fields for the Facebook Pages with the given pageIds. |
T |
pages_getInfo(java.lang.Long userId,
java.util.Collection<PageProfileField> fields)
Retrieves the requested profile fields for the Facebook Pages of the user with the given userId. |
T |
pages_getInfo(java.lang.Long userId,
java.util.Set<java.lang.CharSequence> fields)
Retrieves the requested profile fields for the Facebook Pages of the user with the given userId. |
boolean |
pages_isAdmin(java.lang.Long pageId)
Checks whether the logged-in user for this session is an admin of the page with the given pageId. |
boolean |
pages_isAppAdded(java.lang.Long pageId)
Checks whether a page has added the application |
boolean |
pages_isFan(java.lang.Long pageId)
Checks whether the logged-in user is a fan of the page with the given pageId. |
boolean |
pages_isFan(java.lang.Long pageId,
java.lang.Long userId)
Checks whether a user is a fan of the page with the given pageId. |
java.lang.Object |
payments_getOrders(java.lang.String status,
long startTime,
long endTime)
Returns all orders for the given application |
T |
permissions_checkAvailableApiAccess(java.lang.String apiKey)
Check to see what permissions have been granted to current app by the specified external application. |
T |
permissions_checkGrantedApiAccess(java.lang.String apiKey)
Check to see what permissions have been granted to specified external application by the current application. |
boolean |
permissions_grantApiAccess(java.lang.String apiKey,
java.util.Set<FacebookMethod> methods)
Grant permission to an external app to make API calls on behalf of the current application. |
boolean |
permissions_grantFullApiAccess(java.lang.String apiKey)
Grant permission to an external app to make API calls on behalf of the current application. |
boolean |
permissions_revokeApiAccess(java.lang.String apiKey)
Revokes the specified application's permission to call API methods on behalf of the current app. |
boolean |
photos_addTag(java.lang.String photoId,
java.lang.CharSequence tagText,
java.lang.Double xPct,
java.lang.Double yPct)
Adds a tag to a photo. |
boolean |
photos_addTag(java.lang.String photoId,
java.lang.CharSequence tagText,
java.lang.Double xPct,
java.lang.Double yPct,
java.lang.Long userId)
Adds a tag to a photo. |
boolean |
photos_addTag(java.lang.String photoId,
java.lang.Long taggedUserId,
java.lang.Double xPct,
java.lang.Double yPct)
Adds a tag to a photo. |
boolean |
photos_addTag(java.lang.String photoId,
java.lang.Long taggedUserId,
java.lang.Double xPct,
java.lang.Double yPct,
java.lang.Long userId)
Adds a tag to a photo. |
T |
photos_addTags(java.lang.String photoId,
java.util.Collection<PhotoTag> tags)
Adds several tags to a photo. |
T |
photos_addTags(java.lang.String photoId,
java.util.Collection<PhotoTag> tags,
java.lang.Long userId)
Adds several tags to a photo. |
T |
photos_createAlbum(java.lang.String albumName)
Creates an album. |
T |
photos_createAlbum(java.lang.String albumName,
java.lang.Long userId)
Creates an album. |
T |
photos_createAlbum(java.lang.String name,
java.lang.String description,
java.lang.String location)
Creates an album. |
T |
photos_createAlbum(java.lang.String name,
java.lang.String description,
java.lang.String location,
java.lang.Long userId)
Creates an album. |
T |
photos_get(java.util.Collection<java.lang.String> photoIds)
Used to retrieve photo objects using the search parameters (one or more of the parameters must be provided). |
T |
photos_get(java.lang.Long subjId)
Used to retrieve photo objects using the search parameters (one or more of the parameters must be provided). |
T |
photos_get(java.lang.Long subjId,
java.util.Collection<java.lang.String> photoIds)
Used to retrieve photo objects using the search parameters (one or more of the parameters must be provided). |
T |
photos_get(java.lang.Long subjId,
java.lang.String albumId)
Used to retrieve photo objects using the search parameters (one or more of the parameters must be provided). |
T |
photos_get(java.lang.Long subjId,
java.lang.String albumId,
java.util.Collection<java.lang.String> photoIds)
Used to retrieve photo objects using the search parameters (one or more of the parameters must be provided). |
T |
photos_getAlbums(java.util.Collection<java.lang.String> albumIds)
Retrieves album metadata for a list of album IDs. |
T |
photos_getAlbums(java.lang.Long userId)
Retrieves album metadata for albums owned by a user. |
T |
photos_getAlbums(java.lang.Long userId,
java.util.Collection<java.lang.String> albumIds)
Retrieves album metadata. |
T |
photos_getByAlbum(java.lang.String albumId)
Used to retrieve photo objects using the search parameters (one or more of the parameters must be provided). |
T |
photos_getByAlbum(java.lang.String albumId,
java.util.Collection<java.lang.String> photoIds)
Used to retrieve photo objects using the search parameters (one or more of the parameters must be provided). |
T |
photos_getTags(java.util.Collection<java.lang.String> photoIds)
Retrieves the tags for the given set of photos. |
T |
photos_upload(java.io.File photo)
Uploads a photo to Facebook. |
T |
photos_upload(java.io.File photo,
java.lang.String caption,
java.lang.String albumId)
Uploads a photo to Facebook. |
T |
photos_upload(java.lang.Long userId,
java.io.File photo)
Uploads a photo to Facebook. |
T |
photos_upload(java.lang.Long userId,
java.io.File photo,
java.lang.String caption,
java.lang.String albumId)
Uploads a photo to Facebook. |
T |
photos_upload(java.lang.Long userId,
java.lang.String caption,
java.lang.String albumId,
java.lang.String fileName,
java.io.InputStream fileStream)
Uploads a photo to Facebook. |
T |
photos_uploadToAlbum(java.io.File photo,
java.lang.String albumId)
Uploads a photo to Facebook. |
T |
photos_uploadToAlbum(java.lang.Long userId,
java.io.File photo,
java.lang.String albumId)
Uploads a photo to Facebook. |
T |
photos_uploadWithCaption(java.io.File photo,
java.lang.String caption)
Uploads a photo to Facebook. |
T |
photos_uploadWithCaption(java.lang.Long userId,
java.io.File photo,
java.lang.String caption)
Uploads a photo to Facebook. |
T |
profile_getFBML()
Deprecated. |
T |
profile_getFBML(int type)
Deprecated. |
T |
profile_getFBML(int type,
java.lang.Long userId)
Deprecated. |
T |
profile_getFBML(java.lang.Long userId)
Deprecated. |
T |
profile_getInfo(java.lang.Long userId)
Deprecated. |
T |
profile_getInfoOptions(java.lang.String field)
Deprecated. |
boolean |
profile_setFBML(java.lang.CharSequence profileFbmlMarkup,
java.lang.CharSequence profileActionFbmlMarkup)
Deprecated. trying to reduce superfluous methods, use profile_setFBML(Long, String, String, String, String) |
boolean |
profile_setFBML(java.lang.CharSequence profileFbmlMarkup,
java.lang.CharSequence profileActionFbmlMarkup,
java.lang.CharSequence mobileFbmlMarkup)
Deprecated. trying to reduce superfluous methods, use profile_setFBML(Long, String, String, String, String) |
boolean |
profile_setFBML(java.lang.CharSequence profileFbmlMarkup,
java.lang.CharSequence profileActionFbmlMarkup,
java.lang.CharSequence mobileFbmlMarkup,
java.lang.Long profileId)
Deprecated. trying to reduce superfluous methods, use profile_setFBML(Long, String, String, String, String) |
boolean |
profile_setFBML(java.lang.CharSequence profileFbmlMarkup,
java.lang.CharSequence profileActionFbmlMarkup,
java.lang.Long profileId)
Deprecated. trying to reduce superfluous methods, use profile_setFBML(Long, String, String, String, String) |
boolean |
profile_setFBML(java.lang.Long userId,
java.lang.String profileFbml,
java.lang.String actionFbml,
java.lang.String mobileFbml)
Deprecated. trying to reduce superfluous methods, use profile_setFBML(Long, String, String, String, String) |
boolean |
profile_setFBML(java.lang.Long userId,
java.lang.String profileFbml,
java.lang.String actionFbml,
java.lang.String mobileFbml,
java.lang.String profileMain)
Deprecated. |
void |
profile_setInfo(java.lang.Long userId,
java.lang.String title,
boolean textOnly,
java.util.List<ProfileInfoField> fields)
Deprecated. |
void |
profile_setInfoOptions(ProfileInfoField field)
Deprecated. |
boolean |
profile_setMobileFBML(java.lang.CharSequence fbmlMarkup)
Deprecated. trying to reduce superfluous methods, use profile_setFBML(Long, String, String, String, String) |
boolean |
profile_setMobileFBML(java.lang.CharSequence fbmlMarkup,
java.lang.Long profileId)
Deprecated. trying to reduce superfluous methods, use profile_setFBML(Long, String, String, String, String) |
boolean |
profile_setProfileActionFBML(java.lang.CharSequence fbmlMarkup)
Deprecated. trying to reduce superfluous methods, use profile_setFBML(Long, String, String, String, String) |
boolean |
profile_setProfileActionFBML(java.lang.CharSequence fbmlMarkup,
java.lang.Long profileId)
Deprecated. trying to reduce superfluous methods, use profile_setFBML(Long, String, String, String, String) |
boolean |
profile_setProfileFBML(java.lang.CharSequence fbmlMarkup)
Deprecated. trying to reduce superfluous methods, use profile_setFBML(Long, String, String, String, String) |
boolean |
profile_setProfileFBML(java.lang.CharSequence fbmlMarkup,
java.lang.Long profileId)
Deprecated. trying to reduce superfluous methods, use profile_setFBML(Long, String, String, String, String) |
void |
setCacheAppUser(java.lang.Boolean appUser)
Deprecated. |
void |
setCacheSession(java.lang.String cacheSessionKey,
java.lang.Long cacheUserId,
java.lang.Long cacheSessionExpires)
|
void |
setConnectTimeout(int connectTimeout)
Deprecated. |
void |
setReadTimeout(int readTimeout)
Deprecated. |
void |
setServerUrl(java.lang.String newUrl)
|
void |
setServerUrl(java.net.URL newUrl)
Override the default Facebook API server used for making requests. |
boolean |
sms_canSend()
Check to see if the application is permitted to send SMS messages to the current application user. |
boolean |
sms_canSend(java.lang.Long userId)
Check to see if the application is permitted to send SMS messages to the specified user. |
java.lang.Integer |
sms_send(java.lang.Long userId,
java.lang.String message,
java.lang.Integer smsSessionId,
boolean makeNewSession)
Send an SMS message to the specified user. |
java.lang.Integer |
sms_send(java.lang.String message,
java.lang.Integer smsSessionId,
boolean makeNewSession)
Send an SMS message to the current application user. |
void |
sms_sendMessage(java.lang.Long userId,
java.lang.CharSequence message)
Sends a message via SMS to the user identified by userId. |
int |
sms_sendMessageWithSession(java.lang.Long userId,
java.lang.CharSequence message)
Sends a message via SMS to the user identified by userId, with the expectation that the user will reply. |
java.lang.String |
stream_addComment(java.lang.String postId,
java.lang.String comment,
java.lang.Long userId)
|
boolean |
stream_addLike(java.lang.String postId,
java.lang.Long userId)
|
T |
stream_get(java.lang.Long viewerId,
java.util.List<java.lang.Long> sourceIds,
java.util.Date start,
java.util.Date end,
java.lang.Integer limit,
java.lang.String filterKey,
java.util.List<java.lang.String> metadata)
|
T |
stream_getComments(java.lang.String postId)
|
T |
stream_getFilters(java.lang.Long userId)
|
java.lang.String |
stream_publish(java.lang.String message,
Attachment attachment,
java.util.Collection<BundleActionLink> actionLinks,
java.lang.Long targetId,
java.lang.Long userId)
|
boolean |
stream_remove(java.lang.String postId,
java.lang.Long userId)
|
boolean |
stream_removeComment(java.lang.String commentId,
java.lang.Long userId)
|
boolean |
stream_removeLike(java.lang.String postId,
java.lang.Long userId)
|
boolean |
users_clearStatus()
Clears the logged-in user's Facebook status. |
T |
users_getInfo(java.lang.Iterable<java.lang.Long> userIds,
java.util.Collection<ProfileField> fields)
Retrieves the requested info fields for the requested set of users. |
T |
users_getInfo(java.lang.Iterable<java.lang.Long> userIds,
java.util.Set<java.lang.CharSequence> fields)
Retrieves the requested info fields for the requested set of users. |
long |
users_getLoggedInUser()
Retrieves the user ID of the user logged in to this API session |
T |
users_getStandardInfo(java.util.Collection<java.lang.Long> userIds,
java.util.Collection<ProfileField> fields)
Returns an array of user-specific information for each user identifier passed, limited by the view of the current user. |
T |
users_getStandardInfo(java.util.Collection<java.lang.Long> userIds,
java.util.Set<java.lang.CharSequence> fields)
Returns an array of user-specific information for each user identifier passed, limited by the view of the current user. |
boolean |
users_hasAppPermission(Permission perm)
|
boolean |
users_hasAppPermission(Permission perm,
java.lang.Long userId)
Checks whether the user has opted in to an extended application permission. |
boolean |
users_isAppUser()
|
boolean |
users_isAppUser(java.lang.Long userId)
Returns whether the user (either the session user or user specified by uid) has authorized the calling application. |
boolean |
users_setStatus(java.lang.String status)
Sets the logged-in user's Facebook status. |
boolean |
users_setStatus(java.lang.String newStatus,
boolean clear)
Set the user's profile status message. |
boolean |
users_setStatus(java.lang.String newStatus,
boolean clear,
boolean statusIncludesVerb)
Set the user's profile status message. |
boolean |
users_setStatus(java.lang.String newStatus,
boolean clear,
boolean statusIncludesVerb,
java.lang.Long userId)
Set the user's profile status message. |
boolean |
users_setStatus(java.lang.String newStatus,
boolean clear,
java.lang.Long userId)
Set the user's profile status message. |
boolean |
users_setStatus(java.lang.String status,
java.lang.Long userId)
Sets the spedified user's Facebook status. |
| Field Detail |
|---|
static final java.lang.String TARGET_API_VERSION
static final java.lang.String ERROR_TAG
| Method Detail |
|---|
java.net.URL getServerUrl()
void setServerUrl(java.net.URL newUrl)
newUrl - the new URL to use, for example: "http://api.facebook.com/restserver.php"
java.net.MalformedURLExceptionvoid setServerUrl(java.lang.String newUrl)
@Deprecated int getConnectTimeout()
@Deprecated void setConnectTimeout(int connectTimeout)
@Deprecated int getReadTimeout()
@Deprecated void setReadTimeout(int readTimeout)
java.lang.String getResponseFormat()
java.lang.String getApiKey()
java.lang.String getSecret()
boolean isDesktop()
@Deprecated java.lang.Boolean getCacheAppUser()
@Deprecated void setCacheAppUser(java.lang.Boolean appUser)
void setCacheSession(java.lang.String cacheSessionKey,
java.lang.Long cacheUserId,
java.lang.Long cacheSessionExpires)
@Deprecated
boolean profile_setFBML(java.lang.Long userId,
java.lang.String profileFbml,
java.lang.String actionFbml,
java.lang.String mobileFbml,
java.lang.String profileMain)
throws FacebookException
userId - The user ID for the user whose profile you are updating, or the page ID in case of a Page. If this parameter is not specified, then it defaults to the
session user. Note: This parameter applies only to Web applications and is required by them only if the session_key is not specified. Facebook returns
an error if this parameter is passed by a desktop application.profileFbml - The FBML intended for the application profile box that appears on the Boxes tab on the user's profile.actionFbml - The FBML intended for the user's profile actions. A profile action is the link under the user's profile picture that allows a user to take an action
with your application. Note: This attribute is being deprecated when the new profile design launches in July 2008, as there are no third party profile
action links on the new profile.mobileFbml - The FBML intended for mobile devices.profileMain - The FBML intended for the narrow profile box on the Wall and Info tabs of the user's profile. Note: This attribute applies only to the new profile
design that launched July 2008.
FacebookException
@Deprecated
boolean profile_setFBML(java.lang.Long userId,
java.lang.String profileFbml,
java.lang.String actionFbml,
java.lang.String mobileFbml)
throws FacebookException
profile_setFBML(Long, String, String, String, String)
FacebookExceptionprofile_setFBML(Long, String, String, String, String)
@Deprecated
boolean profile_setProfileFBML(java.lang.CharSequence fbmlMarkup)
throws FacebookException
profile_setFBML(Long, String, String, String, String)
fbmlMarkup - refer to the FBML documentation for a description of the markup and its role in various contexts
FacebookException
@Deprecated
boolean profile_setProfileActionFBML(java.lang.CharSequence fbmlMarkup)
throws FacebookException
profile_setFBML(Long, String, String, String, String)
fbmlMarkup - refer to the FBML documentation for a description of the markup and its role in various contexts
FacebookException
@Deprecated
boolean profile_setMobileFBML(java.lang.CharSequence fbmlMarkup)
throws FacebookException
profile_setFBML(Long, String, String, String, String)
fbmlMarkup - refer to the FBML documentation for a description of the markup and its role in various contexts
FacebookException
@Deprecated
boolean profile_setProfileFBML(java.lang.CharSequence fbmlMarkup,
java.lang.Long profileId)
throws FacebookException
profile_setFBML(Long, String, String, String, String)
profileId.
fbmlMarkup - refer to the FBML documentation for a description of the markup and its role in various contextsprofileId - a page or user ID (null for the logged-in user)
FacebookException
@Deprecated
boolean profile_setProfileActionFBML(java.lang.CharSequence fbmlMarkup,
java.lang.Long profileId)
throws FacebookException
profile_setFBML(Long, String, String, String, String)
profileId.
fbmlMarkup - refer to the FBML documentation for a description of the markup and its role in various contextsprofileId - a page or user ID (null for the logged-in user)
FacebookException
@Deprecated
boolean profile_setMobileFBML(java.lang.CharSequence fbmlMarkup,
java.lang.Long profileId)
throws FacebookException
profile_setFBML(Long, String, String, String, String)
profileId on mobile devices.
fbmlMarkup - refer to the FBML documentation for a description of the markup and its role in various contextsprofileId - a page or user ID (null for the logged-in user)
FacebookException
@Deprecated
boolean profile_setFBML(java.lang.CharSequence profileFbmlMarkup,
java.lang.CharSequence profileActionFbmlMarkup)
throws FacebookException
profile_setFBML(Long, String, String, String, String)
profileFbmlMarkup - the FBML for the profile boxprofileActionFbmlMarkup - the FBML for the profile actions
FacebookException
@Deprecated
boolean profile_setFBML(java.lang.CharSequence profileFbmlMarkup,
java.lang.CharSequence profileActionFbmlMarkup,
java.lang.Long profileId)
throws FacebookException
profile_setFBML(Long, String, String, String, String)
profileId. Refer to the FBML documentation for a
description of the markup and its role in various contexts.
profileFbmlMarkup - the FBML for the profile boxprofileActionFbmlMarkup - the FBML for the profile actionsprofileId - a page or user ID (null for the logged-in user)
FacebookException
@Deprecated
boolean profile_setFBML(java.lang.CharSequence profileFbmlMarkup,
java.lang.CharSequence profileActionFbmlMarkup,
java.lang.CharSequence mobileFbmlMarkup,
java.lang.Long profileId)
throws FacebookException
profile_setFBML(Long, String, String, String, String)
profileId. Refer to the FBML documentation
for a description of the markup and its role in various contexts.
profileFbmlMarkup - the FBML for the profile boxprofileActionFbmlMarkup - the FBML for the profile actionsmobileFbmlMarkup - the FBML for mobile devicesprofileId - a page or user ID (null for the logged-in user)
FacebookException
@Deprecated
boolean profile_setFBML(java.lang.CharSequence profileFbmlMarkup,
java.lang.CharSequence profileActionFbmlMarkup,
java.lang.CharSequence mobileFbmlMarkup)
throws FacebookException
profile_setFBML(Long, String, String, String, String)
profileFbmlMarkup - the FBML for the profile boxprofileActionFbmlMarkup - the FBML for the profile actionsmobileFbmlMarkup - the FBML for mobile devicesprofileId - a page or user ID (null for the logged-in user)
FacebookException
@Deprecated
T profile_getFBML()
throws FacebookException
FacebookExceptionprofile_getFBML(int, Long)
@Deprecated
T profile_getFBML(java.lang.Long userId)
throws FacebookException
userId - The user whose profile FBML is to be fetched, or the page ID in case of a Page. If not specified, defaults to the session user.
FacebookExceptionprofile_getFBML(int, Long)
@Deprecated
T profile_getFBML(int type)
throws FacebookException
type - The type of profile box to retrieve. Specify 1 for the original style (wide and narrow column boxes), 2 for profile_main box. (Default value is 1.)
FacebookExceptionprofile_getFBML(int, Long)
@Deprecated
T profile_getFBML(int type,
java.lang.Long userId)
throws FacebookException
type - The type of profile box to retrieve. Specify 1 for the original style (wide and narrow column boxes), 2 for profile_main box. (Default value is 1.)userId - The user whose profile FBML is to be fetched, or the page ID in case of a Page. If not specified, defaults to the session user.
FacebookException
boolean fbml_refreshRefUrl(java.lang.String url)
throws FacebookException
url - string representing the URL to refresh
FacebookException
boolean fbml_refreshRefUrl(java.net.URL url)
throws FacebookException
url - the URL to refresh
FacebookException
boolean fbml_refreshImgSrc(java.lang.String imageUrl)
throws FacebookException
imageUrl - String representing the image URL to refresh
FacebookException
boolean fbml_refreshImgSrc(java.net.URL imageUrl)
throws FacebookException
imageUrl - the image URL to refresh
FacebookException
@Deprecated
boolean feed_publishTemplatizedAction(java.lang.Long actorId,
java.lang.CharSequence titleTemplate)
throws FacebookException
actorId - deprecatedtitleTemplate - markup (up to 60 chars, tags excluded) for the feed story's title section. Must include the token {actor}.
FacebookException
@Deprecated
boolean feed_publishTemplatizedAction(java.lang.CharSequence titleTemplate)
throws FacebookException
titleTemplate - markup (up to 60 chars, tags excluded) for the feed story's title section. Must include the token {actor}.
FacebookException
@Deprecated
boolean feed_publishTemplatizedAction(java.lang.CharSequence titleTemplate,
java.lang.Long pageActorId)
throws FacebookException
pageActorId is provided, page), and publishes aggregating News
Feed stories to the user's friends/page's fans. Stories are identified as being combinable if they have matching templates and substituted values.
titleTemplate - markup (up to 60 chars, tags excluded) for the feed story's title section. Must include the token {actor}.pageActorId - (optional) the ID of the page into whose mini-feed the story is being published
FacebookException
@Deprecated
boolean feed_publishTemplatizedAction(java.lang.CharSequence titleTemplate,
java.util.Map<java.lang.String,java.lang.CharSequence> titleData,
java.lang.CharSequence bodyTemplate,
java.util.Map<java.lang.String,java.lang.CharSequence> bodyData,
java.lang.CharSequence bodyGeneral,
java.util.Collection<java.lang.Long> targetIds,
java.util.Collection<? extends IPair<? extends java.lang.Object,java.net.URL>> images,
java.lang.Long pageActorId)
throws FacebookException
pageActorId is provided, page), and publishes aggregating News
Feed stories to the user's friends/page's fans. Stories are identified as being combinable if they have matching templates and substituted values.
titleTemplate - markup (up to 60 chars, tags excluded) for the feed story's title section. Must include the token {actor}.titleData - (optional) contains token-substitution mappings for tokens that appear in titleTemplate. Should not contain mappings for the {actor} or
{target} tokens. Required if tokens other than {actor} or {target} appear in the titleTemplate.bodyTemplate - (optional) markup to be displayed in the feed story's body section. can include tokens, of the form {token}, to be substituted using
bodyData.bodyData - (optional) contains token-substitution mappings for tokens that appear in bodyTemplate. Required if the bodyTemplate contains tokens other than
{actor} and {target}.bodyGeneral - (optional) additional body markup that is not aggregated. If multiple instances of this templated story are combined together, the markup in the
bodyGeneral of one of their stories may be displayed.targetIds - The user ids of friends of the actor, used for stories about a direct action between the actor and these targets of his/her action. Required if either
the titleTemplate or bodyTemplate includes the token {target}.images - (optional) additional body markup that is not aggregated. If multiple instances of this templated story are combined together, the markup in the
bodyGeneral of one of their stories may be displayed.pageActorId - (optional) the ID of the page into whose mini-feed the story is being published
FacebookException
@Deprecated
boolean feed_publishTemplatizedAction(java.lang.Long actorId,
java.lang.CharSequence titleTemplate,
java.util.Map<java.lang.String,java.lang.CharSequence> titleData,
java.lang.CharSequence bodyTemplate,
java.util.Map<java.lang.String,java.lang.CharSequence> bodyData,
java.lang.CharSequence bodyGeneral,
java.util.Collection<java.lang.Long> targetIds,
java.util.Collection<? extends IPair<? extends java.lang.Object,java.net.URL>> images)
throws FacebookException
actorId - the user into whose mini-feed the story is being published.titleTemplate - markup (up to 60 chars, tags excluded) for the feed story's title section. Must include the token {actor}.titleData - (optional) contains token-substitution mappings for tokens that appear in titleTemplate. Should not contain mappings for the {actor} or
{target} tokens. Required if tokens other than {actor} or {target} appear in the titleTemplate.bodyTemplate - (optional) markup to be displayed in the feed story's body section. can include tokens, of the form {token}, to be substituted using
bodyData.bodyData - (optional) contains token-substitution mappings for tokens that appear in bodyTemplate. Required if the bodyTemplate contains tokens other than
{actor} and {target}.bodyGeneral - (optional) additional body markup that is not aggregated. If multiple instances of this templated story are combined together, the markup in the
bodyGeneral of one of their stories may be displayed.targetIds - The user ids of friends of the actor, used for stories about a direct action between the actor and these targets of his/her action. Required if either
the titleTemplate or bodyTemplate includes the token {target}.images - (optional) additional body markup that is not aggregated. If multiple instances of this templated story are combined together, the markup in the
bodyGeneral of one of their stories may be displayed.
FacebookException
T friends_areFriends(long userId1,
long userId2)
throws FacebookException
userId1 - userId2 -
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Friends.areFriends
T friends_areFriends(java.util.Collection<java.lang.Long> userIds1,
java.util.Collection<java.lang.Long> userIds2)
throws FacebookException
userIds1 is friends with the first user in userIds2, the
second user in userIds1 is friends with the second user in userIds2, etc.
userIds1 - userIds2 -
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Friends.areFriends
T friends_get()
throws FacebookException
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Friends.get
T friends_get(java.lang.Long uid)
throws FacebookException
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Friends.get
T friends_getAppUsers()
throws FacebookException
FacebookException
T friends_getList(java.lang.Long friendListId)
throws FacebookException
friendListId.
friendListId - the friend list for which friends should be fetched. if null, all friends will be retrieved.
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Friends.get
T friends_getLists()
throws FacebookException
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Friends.getLists
T friends_getMutualFriends(java.lang.Long targetId)
throws FacebookException
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Friends.getMutualFriends
T friends_getMutualFriends(java.lang.Long sourceId,
java.lang.Long targetId)
throws FacebookException
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Friends.getMutualFriends
T users_getInfo(java.lang.Iterable<java.lang.Long> userIds,
java.util.Collection<ProfileField> fields)
throws FacebookException
userIds - a collection of user IDs for which to fetch infofields - a set of ProfileFields
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Users.getInfo
T users_getInfo(java.lang.Iterable<java.lang.Long> userIds,
java.util.Set<java.lang.CharSequence> fields)
throws FacebookException
userIds - a collection of user IDs for which to fetch infofields - a set of strings describing the info fields desired, such as "last_name", "sex"
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Users.getInfo
T users_getStandardInfo(java.util.Collection<java.lang.Long> userIds,
java.util.Collection<ProfileField> fields)
throws FacebookException
userIds - a collection of user IDs for which to fetch infofields - a set of ProfileFields
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Users.getStandardInfo
T users_getStandardInfo(java.util.Collection<java.lang.Long> userIds,
java.util.Set<java.lang.CharSequence> fields)
throws FacebookException
userIds - a collection of user IDs for which to fetch infofields - a set of strings describing the info fields desired, such as "last_name", "sex"
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Users.getStandardInfo
long users_getLoggedInUser()
throws FacebookException
FacebookException
boolean users_isAppUser()
throws FacebookException
FacebookExceptionusers_isAppUser(Long)
boolean users_isAppUser(java.lang.Long userId)
throws FacebookException
userId - The user ID of the user who may have authorized the application. If this parameter is not specified, then it defaults to the session user. Note: This
parameter applies only to Web applications and is required by them only if the session_key is not specified. Facebook ignores this parameter if it is
passed by a desktop application.
FacebookException
boolean users_setStatus(java.lang.String status)
throws FacebookException
FacebookExceptionusers_hasAppPermission(com.google.code.facebookapi.Permission),
FacebookExtendedPerm.STATUS_UPDATE,
http://wiki.developers.facebook.com/index.php/Users.setStatus
boolean users_setStatus(java.lang.String status,
java.lang.Long userId)
throws FacebookException
FacebookExceptionusers_hasAppPermission(com.google.code.facebookapi.Permission),
FacebookExtendedPerm.STATUS_UPDATE,
http://wiki.developers.facebook.com/index.php/Users.setStatus
boolean users_setStatus(java.lang.String newStatus,
boolean clear)
throws FacebookException
newStatus - the new status message to set.clear - whether or not to clear the old status message.
FacebookException - if an error happens when executing the API call.http://wiki.developers.facebook.com/index.php/Users.setStatus
boolean users_setStatus(java.lang.String newStatus,
boolean clear,
java.lang.Long userId)
throws FacebookException
newStatus - the new status message to set.clear - whether or not to clear the old status message.userId - the id of the user to set the status for.
FacebookException - if an error happens when executing the API call.http://wiki.developers.facebook.com/index.php/Users.setStatus
boolean users_setStatus(java.lang.String newStatus,
boolean clear,
boolean statusIncludesVerb)
throws FacebookException
newStatus - the new status message to set.clear - whether or not to clear the old status message.statusIncludesVerb - set to true if you do not want the Facebook Platform to automatically prepend "is " to your status message set to false if you want the "is " prepended
(default behavior)
FacebookException - if an error happens when executing the API call.http://wiki.developers.facebook.com/index.php/Users.setStatus
boolean users_setStatus(java.lang.String newStatus,
boolean clear,
boolean statusIncludesVerb,
java.lang.Long userId)
throws FacebookException
newStatus - the new status message to set.clear - whether or not to clear the old status message.statusIncludesVerb - set to true if you do not want the Facebook Platform to automatically prepend "is " to your status message set to false if you want the "is " prepended
(default behavior)userId - the id of the user to set the status for.
FacebookException - if an error happens when executing the API call.http://wiki.developers.facebook.com/index.php/Users.setStatus
boolean users_clearStatus()
throws FacebookException
FacebookExceptionusers_hasAppPermission(com.google.code.facebookapi.Permission),
FacebookExtendedPerm.STATUS_UPDATE,
http://wiki.developers.facebook.com/index.php/Users.setStatus
T photos_get(java.lang.Long subjId,
java.lang.String albumId,
java.util.Collection<java.lang.String> photoIds)
throws FacebookException
subjId - retrieve from photos associated with this user (optional).albumId - retrieve from photos from this album (optional)photoIds - retrieve from this list of photos (optional)
FacebookException
T photos_get(java.lang.Long subjId,
java.util.Collection<java.lang.String> photoIds)
throws FacebookException
subjId - retrieve from photos associated with this user (optional).photoIds - retrieve from this list of photos (optional)
FacebookException#photos_get(Long, Long, Collection),
Developers Wiki: Photos.get
T photos_get(java.lang.Long subjId,
java.lang.String albumId)
throws FacebookException
subjId - retrieve from photos associated with this user (optional).albumId - retrieve from photos from this album (optional)
FacebookException#photos_get(Long, Long, Collection),
Developers Wiki: Photos.get
T photos_get(java.util.Collection<java.lang.String> photoIds)
throws FacebookException
photoIds - retrieve from this list of photos (optional)
FacebookException#photos_get(Long, Long, Collection),
Developers Wiki: Photos.get
T photos_get(java.lang.Long subjId)
throws FacebookException
subjId - retrieve from photos associated with this user (optional).
FacebookException#photos_get(Long, Long, Collection),
Developers Wiki: Photos.get
T photos_getAlbums(java.lang.Long userId,
java.util.Collection<java.lang.String> albumIds)
throws FacebookException
userId - (optional) the id of the albums' owner (optional)albumIds - (optional) the ids of albums whose metadata is to be retrieved
FacebookException
T photos_getAlbums(java.lang.Long userId)
throws FacebookException
userId - (optional) the id of the albums' owner (optional)
FacebookException
T photos_getAlbums(java.util.Collection<java.lang.String> albumIds)
throws FacebookException
albumIds - the ids of albums whose metadata is to be retrieved
FacebookException
T photos_getTags(java.util.Collection<java.lang.String> photoIds)
throws FacebookException
photoIds - The list of photos from which to extract photo tags.
FacebookException
T photos_createAlbum(java.lang.String albumName)
throws FacebookException
albumName - The list of photos from which to extract photo tags.
FacebookException
T photos_createAlbum(java.lang.String name,
java.lang.String description,
java.lang.String location)
throws FacebookException
name - The album name.location - The album location (optional).description - The album description (optional).
FacebookException
T photos_createAlbum(java.lang.String albumName,
java.lang.Long userId)
throws FacebookException
albumName - The list of photos from which to extract photo tags.userId - the id of the user creating the album.
FacebookException
T photos_createAlbum(java.lang.String name,
java.lang.String description,
java.lang.String location,
java.lang.Long userId)
throws FacebookException
name - The album name.location - The album location (optional).description - The album description (optional).userId - the id of the user creating the album.
FacebookException
T photos_addTags(java.lang.String photoId,
java.util.Collection<PhotoTag> tags)
throws FacebookException
photoId - The photo id of the photo to be tagged.tags - A list of PhotoTags.
FacebookException
boolean photos_addTag(java.lang.String photoId,
java.lang.Long taggedUserId,
java.lang.Double xPct,
java.lang.Double yPct)
throws FacebookException
photoId - The photo id of the photo to be tagged.xPct - The horizontal position of the tag, as a percentage from 0 to 100, from the left of the photo.yPct - The vertical position of the tag, as a percentage from 0 to 100, from the top of the photo.taggedUserId - The list of photos from which to extract photo tags.
FacebookException
boolean photos_addTag(java.lang.String photoId,
java.lang.CharSequence tagText,
java.lang.Double xPct,
java.lang.Double yPct)
throws FacebookException
photoId - The photo id of the photo to be tagged.xPct - The horizontal position of the tag, as a percentage from 0 to 100, from the left of the photo.yPct - The list of photos from which to extract photo tags.tagText - The text of the tag.
FacebookException
boolean photos_addTag(java.lang.String photoId,
java.lang.Long taggedUserId,
java.lang.Double xPct,
java.lang.Double yPct,
java.lang.Long userId)
throws FacebookException
photoId - The photo id of the photo to be tagged.xPct - The horizontal position of the tag, as a percentage from 0 to 100, from the left of the photo.yPct - The vertical position of the tag, as a percentage from 0 to 100, from the top of the photo.taggedUserId - The list of photos from which to extract photo tags.userId - the user tagging the photo.
FacebookException
boolean photos_addTag(java.lang.String photoId,
java.lang.CharSequence tagText,
java.lang.Double xPct,
java.lang.Double yPct,
java.lang.Long userId)
throws FacebookException
photoId - The photo id of the photo to be tagged.xPct - The horizontal position of the tag, as a percentage from 0 to 100, from the left of the photo.yPct - The list of photos from which to extract photo tags.tagText - The text of the tag.userId - the user tagging the photo.
FacebookException
T photos_upload(java.io.File photo)
throws FacebookException
photo - an image file
FacebookException
T photos_uploadWithCaption(java.io.File photo,
java.lang.String caption)
throws FacebookException
photo - an image filecaption - a description of the image contents
FacebookException
T photos_uploadToAlbum(java.io.File photo,
java.lang.String albumId)
throws FacebookException
photo - an image filealbumId - the album into which the photo should be uploaded
FacebookException
T photos_upload(java.io.File photo,
java.lang.String caption,
java.lang.String albumId)
throws FacebookException
photo - an image filecaption - a description of the image contentsalbumId - the album into which the photo should be uploaded
FacebookException
T photos_upload(java.lang.Long userId,
java.io.File photo)
throws FacebookException
photo - an image fileuserId - the id of the user uploading the photo
FacebookException
T photos_uploadWithCaption(java.lang.Long userId,
java.io.File photo,
java.lang.String caption)
throws FacebookException
photo - an image filecaption - a description of the image contentsuserId - the id of the user uploading the photo
FacebookException
T photos_uploadToAlbum(java.lang.Long userId,
java.io.File photo,
java.lang.String albumId)
throws FacebookException
photo - an image filealbumId - the album into which the photo should be uploadeduserId - the id of the user uploading the photo
FacebookException
T photos_upload(java.lang.Long userId,
java.io.File photo,
java.lang.String caption,
java.lang.String albumId)
throws FacebookException
photo - an image filecaption - a description of the image contentsalbumId - the album into which the photo should be uploadeduserId - the id of the user uploading the photo
FacebookException
T photos_upload(java.lang.Long userId,
java.lang.String caption,
java.lang.String albumId,
java.lang.String fileName,
java.io.InputStream fileStream)
throws FacebookException
userId - the id of the user uploading the photocaption - a description of the image contentsalbumId - the album into which the photo should be uploadedfileName - fileStream -
FacebookException
T groups_get(java.lang.Long userId,
java.util.Collection<java.lang.Long> groupIds)
throws FacebookException
userId - Optional: User associated with groups. A null parameter will default to the session user.groupIds - Optional: group ids to query. A null parameter will get all groups for the user.
FacebookException
T groups_getMembers(java.lang.Number groupId)
throws FacebookException
groupId - the group id
FacebookException
T fql_query(java.lang.CharSequence query)
throws FacebookException
query - : the FQL query statement
FacebookException
java.lang.String auth_createToken()
throws FacebookException
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Auth.createToken
java.lang.String auth_getSession(java.lang.String authToken)
throws FacebookException
authToken - the token returned by auth_createToken or passed back to your callback_url.
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Auth.getSession
java.lang.String auth_getSession(java.lang.String authToken,
boolean generateSessionSecret)
throws FacebookException
authToken - the token returned by auth_createToken or passed back to your callback_url.generateSessionSecret - Create a temporary session secret intended for use by desktop clients
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Auth.getSessionjava.lang.String getCacheSessionKey()
java.lang.Long getCacheUserId()
java.lang.Long getCacheSessionExpires()
T photos_getByAlbum(java.lang.String albumId,
java.util.Collection<java.lang.String> photoIds)
throws FacebookException
albumId - retrieve from photos from this album (optional)photoIds - retrieve from this list of photos (optional)
FacebookException#photos_get(Integer, Long, Collection),
Developers Wiki: Photos.get
T photos_getByAlbum(java.lang.String albumId)
throws FacebookException
albumId - retrieve from photos from this album (optional)
FacebookException#photos_get(Integer, Long, Collection),
Developers Wiki: Photos.getjava.lang.String getRawResponse()
@Deprecated
boolean feed_PublishTemplatizedAction(TemplatizedAction action)
throws FacebookException
action - a TemplatizedAction instance that represents the feed data to publish
FacebookException - if any number of bad things happen
java.lang.String data_getUserPreference(int prefId)
throws FacebookException
prefId - the id of the preference to lookup. This should be an integer value from 0-200.
FacebookException - if an error happens when executing the API call.
T data_getUserPreferences()
throws FacebookException
FacebookException - if an error happens when executing the API call.
void data_setUserPreference(int prefId,
java.lang.String value)
throws FacebookException
prefId - the id of the preference to set, an integer between 0 and 200.value - the value to store, a String of up to 127 characters in length.
FacebookException - if an error happens when executing the API call.
void data_setUserPreferences(java.util.Map<java.lang.Integer,java.lang.String> values,
boolean replace)
throws FacebookException
values - the values to store, specified in a map. The keys should be preference-id values from 0-200, and the values should be strings of up to 127 characters in
length.replace - set to true if you want to remove any pre-existing preferences before writing the new ones set to false if you want the new preferences to be merged
with any pre-existing preferences
FacebookException - if an error happens when executing the API call.
void data_createObjectType(java.lang.String name)
throws FacebookException
name -
FacebookException
void data_dropObjectType(java.lang.String objectType)
throws FacebookException
objectType -
FacebookException
void data_renameObjectType(java.lang.String name,
java.lang.String newName)
throws FacebookException
FacebookException
void data_defineObjectProperty(java.lang.String objectType,
java.lang.String propertyName,
PropertyType propertyType)
throws FacebookException
FacebookException
void data_undefineObjectProperty(java.lang.String objectType,
java.lang.String propertyName)
throws FacebookException
FacebookException
void data_renameObjectProperty(java.lang.String objectType,
java.lang.String propertyName,
java.lang.String newPropertyName)
throws FacebookException
FacebookException
T data_getObjectTypes()
throws FacebookException
FacebookException
T data_getObjectType(java.lang.String objectType)
throws FacebookException
FacebookException
boolean users_hasAppPermission(Permission perm)
throws FacebookException
FacebookExceptionusers_hasAppPermission(Permission,Long),
Users.hasAppPermission
boolean users_hasAppPermission(Permission perm,
java.lang.Long userId)
throws FacebookException
perm - String identifier for the extended permission that is being checked for. Must be one of email, offline_access, status_update, photo_upload,
create_listing, create_event, rsvp_event, sms.userId - The user ID of the user whose permissions you are checking. If this parameter is not specified, then it defaults to the session user. Note: This
parameter applies only to Web applications and is required by them only if the session_key is not specified. Facebook ignores this parameter if it is
passed by a desktop application.
FacebookException
@Deprecated
boolean feed_publishTemplatizedAction(java.lang.String titleTemplate,
java.lang.String titleData,
java.lang.String bodyTemplate,
java.lang.String bodyData,
java.lang.String bodyGeneral,
java.util.Collection<? extends IPair<? extends java.lang.Object,java.net.URL>> pictures,
java.lang.String targetIds)
throws FacebookException
titleTemplate - the template for the title of the feed entry, this must contain the "(actor}" token. Any other tokens are optional, i.e. "{actor} recommends {place}".titleData - JSON-formatted values for any tokens used in titleTemplate, with the exception of "{actor}" and "{target}", which Facebook populates automatically, i.e.
"{place: "Bizou"}".bodyTemplate - the template for the body of the feed entry, works the same as 'titleTemplate', but is not required to contain the "{actor}" token.bodyData - works the same as titleDatabodyGeneral - non-templatized content for the body, may contain markup, may not contain tokens.pictures - a list of up to 4 images to display, with optional hyperlinks for each one.targetIds - a comma-seperated list of the UID's of any friend(s) who are involved in this feed action (if there are any), this specifies the value of the "{target}"
token. If you use this token in any of your templates, you must specify a value for this parameter.
FacebookException - if any number of bad things happen
boolean fbml_setRefHandle(java.lang.String handle,
java.lang.String markup)
throws FacebookException
handle - the id to associate the specified markup with. Put this in fb:ref FBML tags to reference your markup.markup - the FBML markup to store.
FacebookException - if an error happens when executing the API call.
@Deprecated
boolean feed_publishTemplatizedAction(java.lang.Integer actorId,
java.lang.CharSequence titleTemplate,
java.util.Map<java.lang.String,java.lang.CharSequence> titleData,
java.lang.CharSequence bodyTemplate,
java.util.Map<java.lang.String,java.lang.CharSequence> bodyData,
java.lang.CharSequence bodyGeneral,
java.util.Collection<java.lang.Long> targetIds,
java.util.Collection<? extends IPair<? extends java.lang.Object,java.net.URL>> images)
throws FacebookException
actorId - the user into whose mini-feed the story is being published.titleTemplate - markup (up to 60 chars, tags excluded) for the feed story's title section. Must include the token {actor}.titleData - (optional) contains token-substitution mappings for tokens that appear in titleTemplate. Should not contain mappings for the {actor} or
{target} tokens. Required if tokens other than {actor} or {target} appear in the titleTemplate.bodyTemplate - (optional) markup to be displayed in the feed story's body section. can include tokens, of the form {token}, to be substituted using
bodyData.bodyData - (optional) contains token-substitution mappings for tokens that appear in bodyTemplate. Required if the bodyTemplate contains tokens other than
{actor} and {target}.bodyGeneral - (optional) additional body markup that is not aggregated. If multiple instances of this templated story are combined together, the markup in the
bodyGeneral of one of their stories may be displayed.targetIds - The user ids of friends of the actor, used for stories about a direct action between the actor and these targets of his/her action. Required if either
the titleTemplate or bodyTemplate includes the token {target}.images - (optional) additional body markup that is not aggregated. If multiple instances of this templated story are combined together, the markup in the
bodyGeneral of one of their stories may be displayed.
FacebookException
T pages_getInfo(java.util.Collection<java.lang.Long> pageIds,
java.util.Collection<PageProfileField> fields)
throws FacebookException
pageIds. Can be called for pages that have added the application without
establishing a session.
pageIds - the page IDsfields - a set of page profile fields
FacebookException
T pages_getInfo(java.util.Collection<java.lang.Long> pageIds,
java.util.Set<java.lang.CharSequence> fields)
throws FacebookException
pageIds. Can be called for pages that have added the application without
establishing a session.
pageIds - the page IDsfields - a set of page profile fields
FacebookException
T pages_getInfo(java.lang.Long userId,
java.util.Collection<PageProfileField> fields)
throws FacebookException
userId.
userId - the ID of a user about whose pages to fetch infofields - a set of PageProfileFields
FacebookException
T pages_getInfo(java.lang.Long userId,
java.util.Set<java.lang.CharSequence> fields)
throws FacebookException
userId.
userId - the ID of a user about whose pages to fetch infofields - a set of page profile fields
FacebookException
boolean pages_isAppAdded(java.lang.Long pageId)
throws FacebookException
pageId - the ID of the page
FacebookException
boolean pages_isFan(java.lang.Long pageId,
java.lang.Long userId)
throws FacebookException
pageId.
pageId - the ID of the pageuserId - the ID of the user (defaults to the logged-in user if null)
FacebookException
boolean pages_isFan(java.lang.Long pageId)
throws FacebookException
pageId.
pageId - the ID of the page
FacebookException
boolean pages_isAdmin(java.lang.Long pageId)
throws FacebookException
pageId.
pageId - the ID of the page
FacebookException
java.lang.Object payments_getOrders(java.lang.String status,
long startTime,
long endTime)
throws FacebookException
status - Return orders with the specified status. Specify one of reserved, settled, or refundedstartTime - Return orders within this time intervalendTime - Return orders within this time interval
FacebookException
@Deprecated
T notifications_get()
throws FacebookException
FacebookException
@Deprecated
java.net.URL notifications_send(java.util.Collection<java.lang.Long> recipientIds,
java.lang.CharSequence notification,
java.lang.CharSequence email)
throws FacebookException
recipientIds - the user ids to which the message is to be sentnotification - the FBML to display on the notifications pageemail - the FBML to send to the specified users via email, or null if no email should be sent
FacebookException
@Deprecated
java.util.Collection<java.lang.String> notifications_send(java.util.Collection<java.lang.Long> recipientIds,
java.lang.CharSequence notification)
throws FacebookException
recipientIds - the user ids to which the message is to be sent.notification - the FBML to display on the notifications page.
FacebookException
java.util.Collection<java.lang.String> notifications_sendEmailToCurrentUser(java.lang.String subject,
java.lang.String email,
java.lang.String fbml)
throws FacebookException
subject - the subject of the email message.email - a plaintext version of the email to send.fbml - an FBML version of the email to send, the fbml parameter is a stripped-down set of FBML that allows only tags that result in text, links and linebreaks.
FacebookException - if an error happens when executing the API call.
java.util.Collection<java.lang.String> notifications_sendEmail(java.util.Collection<java.lang.Long> recipients,
java.lang.CharSequence subject,
java.lang.CharSequence email,
java.lang.CharSequence fbml)
throws FacebookException
recipients - the uid's of the users to send to.subject - the subject of the email message.email - a plaintext version of the email to send.fbml - an FBML version of the email to send, the fbml parameter is a stripped-down set of FBML that allows only tags that result in text, links and linebreaks.
FacebookException - if an error happens when executing the API call.
java.util.Collection<java.lang.String> notifications_sendTextEmailToCurrentUser(java.lang.String subject,
java.lang.String email)
throws FacebookException
subject - the subject of the email message.email - a plaintext version of the email to send.
FacebookException - if an error happens when executing the API call.
java.util.Collection<java.lang.String> notifications_sendTextEmail(java.util.Collection<java.lang.Long> recipients,
java.lang.String subject,
java.lang.String email)
throws FacebookException
recipients - the uid's of the users to send to.subject - the subject of the email message.email - a plaintext version of the email to send.
FacebookException - if an error happens when executing the API call.
java.util.Collection<java.lang.String> notifications_sendFbmlEmailToCurrentUser(java.lang.String subject,
java.lang.String fbml)
throws FacebookException
subject - the subject of the email message.fbml - the FBML version of the email to send, the fbml parameter is a stripped-down set of FBML that allows only tags that result in text, links and
linebreaks.
FacebookException - if an error happens when executing the API call.
java.util.Collection<java.lang.String> notifications_sendFbmlEmail(java.util.Collection<java.lang.Long> recipients,
java.lang.String subject,
java.lang.String fbml)
throws FacebookException
recipients - the uid's of the users to send to.subject - the subject of the email message.fbml - the FBML version of the email to send, the fbml parameter is a stripped-down set of FBML that allows only tags that result in text, links and
linebreaks.
FacebookException - if an error happens when executing the API call.
@Deprecated
java.util.Collection<java.lang.String> notifications_send(java.lang.CharSequence notification)
throws FacebookException
notification - the FBML to be displayed on the notifications page; only a stripped-down set of FBML tags that result in text and links is allowed
FacebookException
@Deprecated
java.lang.String notifications_sendEmail(java.util.Collection<java.lang.Long> recipientIds,
java.lang.CharSequence subject,
java.lang.CharSequence fbml)
throws FacebookException
recipientIds - up to 100 user ids to which the message is to be sentsubject - the subject of the notification email (optional)fbml - markup to be sent to the specified users via email; only a stripped-down set of FBML that allows only tags that result in text, links and linebreaks is
allowed
FacebookException
@Deprecated
java.lang.String notifications_sendEmailPlain(java.util.Collection<java.lang.Long> recipientIds,
java.lang.CharSequence subject,
java.lang.CharSequence text)
throws FacebookException
recipientIds - up to 100 user ids to which the message is to be sentsubject - the subject of the notification email (optional)text - the plain text to send to the specified users via email
FacebookException
@Deprecated
java.lang.String notifications_sendEmailStr(java.util.Collection<java.lang.Long> recipientIds,
java.lang.CharSequence subject,
java.lang.CharSequence fbml,
java.lang.CharSequence text)
throws FacebookException
fbml or text must be specified.
recipientIds - up to 100 user ids to which the message is to be sentsubject - the subject of the notification email (optional)fbml - markup to be sent to the specified users via email; only a stripped-down set of FBML tags that result in text, links and linebreaks is allowedtext - the plain text to send to the specified users via email
FacebookException
boolean admin_setAppProperties(java.util.Map<ApplicationProperty,java.lang.String> properties)
throws FacebookException
properties - a Map containing the properties to set.
FacebookException
@Deprecated
org.json.JSONObject admin_getAppProperties(java.util.Collection<ApplicationProperty> properties)
throws FacebookException
properties - a collection indicating the properties you are interested in retrieving.
FacebookException
java.util.Map<ApplicationProperty,java.lang.String> admin_getAppPropertiesMap(java.util.Collection<ApplicationProperty> properties)
throws FacebookException
properties - a collection indicating the properties you are interested in retrieving.
FacebookException
java.lang.String admin_getAppPropertiesAsString(java.util.Collection<ApplicationProperty> properties)
throws FacebookException
properties - a collection indicating the properties you are interested in retrieving.
FacebookException
T dashboard_multiAddNews(java.util.Collection<java.lang.Long> userIds,
java.util.Collection<DashboardNewsItem> newsItems,
java.lang.String imageUrl)
throws FacebookException
userIds - Target users. Each user will be the target of all of the supplied news items.newsitems - News item objects consisting of a message (mandatory) and an action link (optional).imageUrl - Absolute URL of image used to replace application logo in the dashboard. (optional)
FacebookException
T dashboard_multiAddNews(java.util.Collection<java.lang.Long> userIds,
java.util.Collection<DashboardNewsItem> newsItems)
throws FacebookException
FacebookExceptiondashboard_multiAddNews(Collection, Collection, String)
T dashboard_multiClearNews(java.util.Map<java.lang.Long,java.util.Collection<java.lang.Long>> userIdToNewsIdsMap)
throws FacebookException
userIds - Target users. Each user will be the target of all of the supplied news items.newsitems - News item objects consisting of a message (mandatory) and an action link (optional).imageUrl - Absolute URL of image used to replace application logo in the dashboard. (optional)
FacebookException
T dashboard_multiClearNews(java.util.Collection<java.lang.Long> userIds)
throws FacebookException
FacebookException#dashboard_multiClearNews(Map>)
java.lang.Long dashboard_addGlobalNews(java.util.Collection<DashboardNewsItem> newsItems,
java.lang.String imageUrl)
throws FacebookException
newsitems - News item objects consisting of a message (mandatory) and an action link (optional).imageUrl - Absolute URL of image used to replace application logo in the dashboard. (optional)
FacebookException
java.lang.Long dashboard_addGlobalNews(java.util.Collection<DashboardNewsItem> newsItems)
throws FacebookException
FacebookException#dashboard_addGlobalNews(Collection, Collection, String)
boolean dashboard_clearGlobalNews()
throws FacebookException
FacebookException
boolean dashboard_clearGlobalNews(java.util.Collection<java.lang.Long> newsIds)
throws FacebookException
FacebookException
java.lang.Long dashboard_publishActivity(DashboardActivityItem activityItem,
java.lang.String imageUrl)
throws FacebookException
activityItem - Activity item object consisting of a message (mandatory) and an action link (optional).imageUrl - Absolute URL of image used to replace application logo in the dashboard. (optional)
FacebookException
java.lang.Long dashboard_publishActivity(DashboardActivityItem activityItem)
throws FacebookException
FacebookExceptiondashboard_publishActivity(DashboardActivityItem, String)
java.util.Set<java.lang.Long> dashboard_multiIncrementCount(java.util.Collection<java.lang.Long> userIds)
throws FacebookException
userIds - Users for which to update dashboard bookmark counter by one.
FacebookException
T data_getCookies()
throws FacebookException
FacebookException
T data_getCookies(java.lang.Long userId)
throws FacebookException
userId - the id of the user to get the cookies for.
FacebookException
T data_getCookies(java.lang.String name)
throws FacebookException
name - the name of the cookie to retrieve.
FacebookException
T data_getCookies(java.lang.Long userId,
java.lang.CharSequence name)
throws FacebookException
userId - the id of the user to get the cookies for.name - the name of the cookie to retrieve.
FacebookException
boolean data_setCookie(java.lang.String name,
java.lang.String value)
throws FacebookException
name - the name of the cookie to setvalue - the value of the cookie
FacebookException
boolean data_setCookie(java.lang.String name,
java.lang.String value,
java.lang.String path)
throws FacebookException
name - the name of the cookie to setvalue - the value of the cookiepath - the path relative to the application's callback URL, with which the cookie should be associated. (default is "/")
FacebookException
boolean data_setCookie(java.lang.Long userId,
java.lang.CharSequence name,
java.lang.CharSequence value)
throws FacebookException
userId - the id of the user to set the cookie for.name - the name of the cookie to setvalue - the value of the cookie
FacebookException
boolean data_setCookie(java.lang.Long userId,
java.lang.CharSequence name,
java.lang.CharSequence value,
java.lang.CharSequence path)
throws FacebookException
userId - the id of the user to set the cookie for.name - the name of the cookie to setvalue - the value of the cookiepath - the path relative to the application's callback URL, with which the cookie should be associated. (default is "/")
FacebookException
boolean data_setCookie(java.lang.String name,
java.lang.String value,
java.lang.Long expires)
throws FacebookException
name - the name of the cookie to setvalue - the value of the cookieexpires - the timestamp at which the cookie expires
FacebookException
boolean data_setCookie(java.lang.String name,
java.lang.String value,
java.lang.Long expires,
java.lang.String path)
throws FacebookException
name - the name of the cookie to setvalue - the value of the cookieexpires - the timestamp at which the cookie expirespath - the path relative to the application's callback URL, with which the cookie should be associated. (default is "/")
FacebookException
boolean data_setCookie(java.lang.Long userId,
java.lang.CharSequence name,
java.lang.CharSequence value,
java.lang.Long expires)
throws FacebookException
userId - the id of the user to set the cookie for.name - the name of the cookie to setvalue - the value of the cookieexpires - the timestamp at which the cookie expires
FacebookException
boolean data_setCookie(java.lang.Long userId,
java.lang.CharSequence name,
java.lang.CharSequence value,
java.lang.Long expires,
java.lang.CharSequence path)
throws FacebookException
userId - the id of the user to set the cookie for.name - the name of the cookie to setvalue - the value of the cookieexpires - the timestamp at which the cookie expirespath - the path relative to the application's callback URL, with which the cookie should be associated. (default is "/")
FacebookException
long data_createObject(java.lang.String objectType,
java.util.Map<java.lang.String,java.lang.String> properties)
throws FacebookException
objectType - Specifies which type of new object to create.properties - Optional - Name-value pairs of properties this new object has
FacebookException
void data_updateObject(long objectId,
java.util.Map<java.lang.String,java.lang.String> properties,
boolean replace)
throws FacebookException
objectId - Numeric identifier (fbid) of the object to modify.properties - Name-value pairs of new properties.replace - True if replace all existing properties; false to merge into existing ones.
FacebookException
void data_deleteObject(long objectId)
throws FacebookException
objectId - Numeric identifier (fbid) of the object to delete.
FacebookExceptiondata_deleteObjects(java.util.Collection) ,
Developers Wiki: Data.deleteObject
void data_deleteObjects(java.util.Collection<java.lang.Long> objectIds)
throws FacebookException
objectIds - A list of 64-bit integers that are numeric identifiers (fbids) of objects to delete.
FacebookExceptiondata_deleteObject(long),
Developers Wiki: Data.deleteObjects
T data_getObject(long objectId)
throws FacebookException
FacebookException
T data_getObjects(java.util.Collection<java.lang.Long> objectIds)
throws FacebookException
FacebookException
T data_getObjectProperty(long objectId,
java.lang.String propertyName)
throws FacebookException
FacebookException
void data_setObjectProperty(long objectId,
java.lang.String propertyName,
java.lang.String value)
throws FacebookException
FacebookException
void data_defineAssociation(java.lang.String associationName,
AssociationType associationType,
AssociationInfo associationInfo1,
AssociationInfo associationInfo2,
java.lang.String inverseName)
throws FacebookException
associationName - Name of forward association to create. This name needs to be unique among all object types and associations defined for this application. This name also
needs to be a valid identifier, which is no longer than 32 characters, starting with a letter (a-z) and consisting of only small letters (a-z), numbers
(0-9) and/or underscores.associationType - associationInfo1 - associationInfo2 - inverseName - Optional - name of backward association, if it is two-way asymmetric. This name needs to be unique among all object types and associations defined for
this application. This name also needs to be a valid identifier, which is no longer than 32 characters, starting with a letter (a-z) and consisting of
only small letters (a-z), numbers (0-9) and/or underscores.
FacebookException
void data_undefineAssociation(java.lang.String name)
throws FacebookException
name -
FacebookException
void data_renameAssociation(java.lang.String name,
java.lang.String newName,
java.lang.String newAlias1,
java.lang.String newAlias2)
throws FacebookException
name - newName - newAlias1 - newAlias2 -
FacebookException
T data_getAssociationDefinition(java.lang.String associationName)
throws FacebookException
FacebookException
T data_getAssociationDefinitions()
throws FacebookException
FacebookException
void data_setAssociation(java.lang.String associationName,
long object1Id,
long object2Id,
java.lang.String data,
java.util.Date associationTime)
throws FacebookException
associationName - Name of the association to set.object1Id - Object identifier 1.object2Id - Object identifier 2.data - Optional (can be null) - An arbitrary data (max. 255 characters) to store with this association.associationTime - Optional (can be null) - Default to association creation time. A timestamp to store with this association. This timestamp is represented as number of
seconds since the Unix Epoch (January 1 1970 00:00:00 GMT). )
FacebookException
void data_removeAssociation(java.lang.String associationName,
long object1Id,
long object2Id)
throws FacebookException
associationName - Name of the association.object1Id - Object identifier 1.object2Id - Object identifier 2.
FacebookException
void data_removeAssociatedObjects(java.lang.String associationName,
long objectId)
throws FacebookException
associationName - Name of the association.objectId - Object identifier.
FacebookException
long data_getAssociatedObjectCount(java.lang.String associationName,
long objectId)
throws FacebookException
associationName - Name of the association.objectId - Object identifier.
FacebookException
boolean admin_setAppProperties(ApplicationPropertySet properties)
throws FacebookException
properties - an ApplicationPropertySet that is translated into a single JSON String.
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Admin.setAppProperties
ApplicationPropertySet admin_getAppPropertiesAsSet(java.util.Collection<ApplicationProperty> properties)
throws FacebookException
admin.setAppProperties call. A
session is not required to use this method.
This method cannot be called by desktop apps.
properties - an enumeration of the properties to get
FacebookExceptionApplicationProperty,
http://wiki.developers.facebook.com/index.php/Admin.getAppPropertiesvoid beginBatch()
T batch_run(java.lang.String methods,
boolean serial)
throws FacebookException
methods - A JSON encoded array of strings. Each element in the array should contain the full parameters for a method, including method name, sig, etc. Currently,
there is a maximum limit of 15 elements in the array.serial - An optional parameter to indicate whether the methods in the method_feed must be executed in order. The default value is false.
FacebookException
java.util.List<? extends java.lang.Object> executeBatch(boolean serial)
throws FacebookException
serial - set to true, and your batch queries will always execute serially, in the same order in which your specified them. If set to false, the Facebook API
server may execute your queries in parallel and/or out of order in order to improve performance.
FacebookException
T application_getPublicInfo(java.lang.Long applicationId,
java.lang.String applicationKey,
java.lang.String applicationCanvas)
throws FacebookException
applicationId - the id of the application to get the info for.applicationKey - the public API key of the application to get the info for.applicationCanvas - the canvas-page name of the application to get the info for.
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Application.getPublicInfo
T application_getPublicInfoById(java.lang.Long applicationId)
throws FacebookException
applicationId - the id of the application to get the info for.
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Application.getPublicInfo
T application_getPublicInfoByApiKey(java.lang.String applicationKey)
throws FacebookException
applicationKey - the public API key of the application to get the info for.
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Application.getPublicInfo
T application_getPublicInfoByCanvasName(java.lang.String applicationCanvas)
throws FacebookException
applicationCanvas - the canvas-page name of the application to get the info for.
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Application.getPublicInfo
int admin_getAllocation(java.lang.String allocationType)
throws FacebookException
allocationType - the type of request to check the allocation for. Currently: "notifications_per_day" and "requests_per_day", "emails_per_day",
"email_disable_message_location"
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Admin.getAllocation
int admin_getAllocation(AllocationType allocationType)
throws FacebookException
allocationType - the type of request to check the allocation for. Currently: "notifications_per_day" and "requests_per_day", "emails_per_day",
"email_disable_message_location"
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Admin.getAllocation
int admin_getAllocation(java.lang.String allocationType,
java.lang.Long userId)
throws FacebookException
allocationType - the type of request to check the allocation for. Currently: "notifications_per_day" and "requests_per_day", "emails_per_day",
"email_disable_message_location"
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Admin.getAllocation
int admin_getAllocation(AllocationType allocationType,
java.lang.Long userId)
throws FacebookException
allocationType - the type of request to check the allocation for. Currently: "notifications_per_day" and "requests_per_day", "emails_per_day",
"email_disable_message_location"
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Admin.getAllocation
@Deprecated
int admin_getRequestAllocation()
throws FacebookException
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Admin.getAllocation
@Deprecated
int admin_getNotificationAllocation()
throws FacebookException
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Admin.getAllocation
@Deprecated
T admin_getDailyMetrics(java.util.Set<Metric> metrics,
java.util.Date start,
java.util.Date end)
throws FacebookException
metrics - a set specifying the specific metrics to retrievestart - the starting date to retrieve data for (range must not exceed 30 days)end - the ending to to retrive data for (range must not exceed 30 days)
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Admin.getDailyMetrics
T admin_getMetrics(java.util.Set<Metric> metrics,
java.util.Date start,
java.util.Date end,
long period)
throws FacebookException
metrics - a set specifying the specific metrics to retrievestart - the starting date to retrieve data for (range must not exceed 30 days)end - the ending to to retrive data for (range must not exceed 30 days)period - a number specifying the desired period to group the metrics by, in seconds, Facebook currently only supports Metric.PERIOD_DAY, Metric.PERIOD_WEEK, and
Metric.PERIOD_MONTH
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Admin.getMetrics
@Deprecated
T admin_getDailyMetrics(java.util.Set<Metric> metrics,
long start,
long end)
throws FacebookException
metrics - a set specifying the specific metrics to retrievestart - the starting date to retrieve data for (range must not exceed 30 days), the accepted unit of time is milliseconds, NOT secondsend - the ending to to retrive data for (range must not exceed 30 days), the accepted unit of time is milliseconds, NOT seconds
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Admin.getDailyMetrics
T admin_getMetrics(java.util.Set<Metric> metrics,
long start,
long end,
long period)
throws FacebookException
metrics - a set specifying the specific metrics to retrievestart - the starting date to retrieve data for (range must not exceed 30 days), the accepted unit of time is milliseconds, NOT secondsend - the ending to to retrive data for (range must not exceed 30 days), the accepted unit of time is milliseconds, NOT secondsperiod - a number specifying the desired period to group the metrics by, in seconds, Facebook currently only supports Metric.PERIOD_DAY, Metric.PERIOD_WEEK, and
Metric.PERIOD_MONTH
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Admin.getMetrics
boolean permissions_grantApiAccess(java.lang.String apiKey,
java.util.Set<FacebookMethod> methods)
throws FacebookException
apiKey - the API-key of the application to grant permission to.methods - the API methods to allow the other application to call. If the set is empty or null, permission is granted for all API methods.
FacebookException
boolean permissions_grantFullApiAccess(java.lang.String apiKey)
throws FacebookException
apiKey - the API-key of the application to grant permission to.
FacebookException
T permissions_checkAvailableApiAccess(java.lang.String apiKey)
throws FacebookException
apiKey - the API key of the application to check for permissions from.
FacebookException
boolean permissions_revokeApiAccess(java.lang.String apiKey)
throws FacebookException
apiKey - the API key of the application to remove permissions for.
FacebookException
T permissions_checkGrantedApiAccess(java.lang.String apiKey)
throws FacebookException
apiKey - the API key of the application to check permissions for.
FacebookException
boolean auth_expireSession()
throws FacebookException
FacebookException
boolean auth_revokeAuthorization()
throws FacebookException
FacebookException
boolean auth_revokeExtendedPermission(Permission perm)
throws FacebookException
FacebookExceptionauth_revokeExtendedPermission(Permission, Long),
http://wiki.developers.facebook.com/index.php/Auth.revokeExtendedPermission
boolean auth_revokeExtendedPermission(Permission perm,
java.lang.Long userId)
throws FacebookException
perm - The extended permission to revoke.userId - The user ID of the user whose extended permission you want to revoke. If you don't specify this parameter, then you must have a valid session for the
current user, and that session's user will have the specified permission revoked.
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Auth.revokeExtendedPermissionvoid beginPermissionsMode(java.lang.String apiKey)
apiKey - the API key of the application to being making requests for.void endPermissionsMode()
java.lang.String auth_promoteSession()
throws FacebookException
FacebookException
@Deprecated
java.lang.Long feed_registerTemplateBundle(java.lang.String template)
throws FacebookException
template - the template to store
FacebookException
@Deprecated
java.lang.Long feed_registerTemplateBundle(java.util.Collection<java.lang.String> templates)
throws FacebookException
templates - the templates to store
FacebookException
@Deprecated
java.lang.Long feed_registerTemplateBundle(java.lang.String template,
java.lang.String shortTemplate,
java.lang.String longTemplate)
throws FacebookException
template - the template to store.shortTemplate - the short template to store.longTemplate - the long template to store.
FacebookException
@Deprecated
java.lang.Long feed_registerTemplateBundle(java.util.Collection<java.lang.String> templates,
java.util.Collection<BundleStoryTemplate> shortTemplates,
BundleStoryTemplate longTemplate,
java.util.List<BundleActionLink> actionLinks)
throws FacebookException
template - the template to store.shortTemplate - the short template to store.longTemplate - the long template to store.actionLinks - the action links to store
FacebookException
@Deprecated
java.lang.Long feed_registerTemplateBundle(java.util.Collection<java.lang.String> templates,
java.util.Collection<BundleStoryTemplate> shortTemplates,
BundleStoryTemplate longTemplate)
throws FacebookException
template - the template to store.shortTemplate - the short template to store.longTemplate - the long template to store.
FacebookException
@Deprecated
T feed_getRegisteredTemplateBundles()
throws FacebookException
FacebookException
@Deprecated
T feed_getRegisteredTemplateBundleByID(java.lang.Long id)
throws FacebookException
id - the id to retrieve.
FacebookException
@Deprecated
java.lang.Boolean feed_publishUserAction(java.lang.Long bundleId)
throws FacebookException
bundleId - the template bundle-id to use to render the feed.
FacebookException
@Deprecated
java.lang.Boolean feed_publishUserAction(java.lang.Long bundleId,
java.util.Map<java.lang.String,java.lang.String> templateData,
java.util.List<java.lang.Long> targetIds,
java.lang.String bodyGeneral)
throws FacebookException
bundleId - the template bundle-id to use to render the feed.templateData - a map of name-value pairs to substitute into the template being rendered.targetIds - the ids of individuals that are the target of this action.bodyGeneral - additional markup to include in the feed story.
FacebookException
@Deprecated
T profile_getInfo(java.lang.Long userId)
throws FacebookException
userId - the id of the user to get the info section for.
FacebookException
@Deprecated
T profile_getInfoOptions(java.lang.String field)
throws FacebookException
field - the field to get the options for.
FacebookException
@Deprecated
void profile_setInfo(java.lang.Long userId,
java.lang.String title,
boolean textOnly,
java.util.List<ProfileInfoField> fields)
throws FacebookException
userId - the user to set the info section for.title - the title to use for the section.textOnly - set to true if your info fields are text only. set to false for thumbnail mode.fields - the fields to set.
FacebookException
@Deprecated
void profile_setInfoOptions(ProfileInfoField field)
throws FacebookException
field - the field to set.
FacebookException
T photos_addTags(java.lang.String photoId,
java.util.Collection<PhotoTag> tags,
java.lang.Long userId)
throws FacebookException
photoId - The photo id of the photo to be tagged.tags - A list of PhotoTags.userId - the id of the user adding the tags.
FacebookException
java.lang.Boolean liveMessage_send(java.lang.Long recipient,
java.lang.String eventName,
org.json.JSONObject message)
throws FacebookException
recipient - the id of the user to send the message to.eventName - the name associated with the FBJS handler you want to recieve your message.message - the JSON-object to send, the object will be passed to the FBJS handler that you have mapped to 'eventName'. See
http://wiki.developers.facebook.com/index.php/LiveMessage for details.
FacebookException
@Deprecated
java.util.Collection<java.lang.String> notifications_send(java.util.Collection<java.lang.Long> recipientIds,
java.lang.String notification,
boolean isAppToUser)
throws FacebookException
recipientIds - the ids of the users to send the notification to.notification - the notification to send.announcement - set to 'true' to send an "announcement" notification, otherwise set to false to send a "general" notification.
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Notifications.send
@Deprecated
boolean feed_deactivateTemplateBundleByID(java.lang.Long bundleId)
throws FacebookException
bundleId - the id of the bundle to deactivate.
FacebookException
@Deprecated
java.lang.Boolean feed_publishUserAction(java.lang.Long bundleId,
java.util.Map<java.lang.String,java.lang.String> templateData,
java.util.List<IFeedImage> images,
java.util.List<java.lang.Long> targetIds,
java.lang.String bodyGeneral,
int storySize)
throws FacebookException
bundleId - the template bundle-id to use to render the feed.templateData - a map of name-value pairs to substitute into the template being rendered.images - the images to associate with this feed entrytargetIds - the ids of individuals that are the target of this action.bodyGeneral - additional markup to include in the feed story.storySize - story size to use. valid values are 1, 2 or 4.
FacebookException
java.lang.Long links_post(java.lang.Long userId,
java.lang.String url,
java.lang.String comment)
throws FacebookException
userId - the user IDurl - the URL to link tocomment - the user-generated comment about the URL
FacebookException
T events_get(java.lang.Long userId,
java.util.Collection<java.lang.Long> eventIds,
java.lang.Long startTime,
java.lang.Long endTime)
throws FacebookException
userId - Filter by events associated with a user with this uid.eventIds - Filter by this list of event IDs. This is a comma-separated list of event IDs.startTime - Filter with this UTC as lower bound. A missing or zero parameter indicates no lower bound.endTime - Filter with this UTC as upper bound. A missing or zero parameter indicates no upper bound.
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Events.get
T events_get(java.lang.Long userId,
java.util.Collection<java.lang.Long> eventIds,
java.lang.Long startTime,
java.lang.Long endTime,
java.lang.String rsvp_status)
throws FacebookException
userId - Filter by events associated with a user with this uid.eventIds - Filter by this list of event IDs. This is a comma-separated list of event IDs.startTime - Filter with this UTC as lower bound. A missing or zero parameter indicates no lower bound.endTime - Filter with this UTC as upper bound. A missing or zero parameter indicates no upper bound.rsvp_status - Filter by this RSVP status. The RSVP status should be one of the following strings: attending, unsure, declined, not_replied
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Events.get
T events_getMembers(java.lang.Long eventId)
throws FacebookException
eventId - The event ID.
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Events.getMembers
java.lang.Long events_create(java.util.Map<java.lang.String,java.lang.String> event_info)
throws FacebookException
event_info - The event information. You must pass the following parameters:
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Events.create
boolean events_edit(java.lang.Long eid,
java.util.Map<java.lang.String,java.lang.String> event_info)
throws FacebookException
eid - The event ID.event_infoThe - event information. The "name" cannot be edited. The following parameters in the event_info array are required and can only be edited, not deleted:
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Events.edit
boolean events_cancel(java.lang.Long eid,
java.lang.String cancel_message)
throws FacebookException
eid - The event ID.cancel_message - The message sent explaining why the event was canceled. You can pass an empty string if you don't want to provide an explanation.
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Events.cancel
boolean events_rsvp(java.lang.Long eid,
java.lang.String rsvp_status)
throws FacebookException
eid - The event ID.rsvp_status - The user's RSVP status. Specify attending, unsure, or declined.
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Events.rsvp
boolean sms_canSend()
throws FacebookException
FacebookException - if an error happens when executing the API call.
boolean sms_canSend(java.lang.Long userId)
throws FacebookException
userId - the UID of the user to check permissions for
FacebookException - if an error happens when executing the API call.
java.lang.Integer sms_send(java.lang.String message,
java.lang.Integer smsSessionId,
boolean makeNewSession)
throws FacebookException
message - the message to send.smsSessionId - the SMS session id to use, note that that is distinct from the user's facebook session id. It is used to allow applications to keep track of individual
SMS conversations/threads for a single user. Specify null if you do not want/need to use a session for the current message.makeNewSession - set to true to request that Facebook allocate a new SMS session id for this message. The allocated id will be returned as the result of this API call.
You should only set this to true if you are passing a null 'smsSessionId' value. Otherwise you already have a SMS session id, and do not need a new one.
FacebookException - if an error happens when executing the API call.
java.lang.Integer sms_send(java.lang.Long userId,
java.lang.String message,
java.lang.Integer smsSessionId,
boolean makeNewSession)
throws FacebookException
userId - the id of the user to send the message to.message - the message to send.smsSessionId - the SMS session id to use, note that that is distinct from the user's facebook session id. It is used to allow applications to keep track of individual
SMS conversations/threads for a single user. Specify null if you do not want/need to use a session for the current message.makeNewSession - set to true to request that Facebook allocate a new SMS session id for this message. The allocated id will be returned as the result of this API call.
You should only set this to true if you are passing a null 'smsSessionId' value. Otherwise you already have a SMS session id, and do not need a new one.
FacebookException - if an error happens when executing the API call.
int sms_sendMessageWithSession(java.lang.Long userId,
java.lang.CharSequence message)
throws FacebookException
userId, with the expectation that the user will reply. The SMS extended permission is required for
success. The returned mobile session ID can be stored and used in #sms_sendResponse when the user replies.
userId - a user IDmessage - the message to be sent via SMS
#sms_sendResponse)
FacebookException - in case of error, e.g. SMS is not enabledFacebookExtendedPerm.SMS,
Developers Wiki: Mobile: Application Generated Messages,
Developers Wiki: Mobile: Workflow
void sms_sendMessage(java.lang.Long userId,
java.lang.CharSequence message)
throws FacebookException
userId. The SMS extended permission is required for success.
userId - a user IDmessage - the message to be sent via SMS
FacebookException - in case of errorFacebookExtendedPerm.SMS,
Developers Wiki: Mobile: Application Generated Messages,
Developers Wiki: Mobile: Workflow
T connect_registerUsers(java.util.Collection<java.util.Map<java.lang.String,java.lang.String>> accounts)
throws FacebookException
accounts - An array of up to 1,000 arrays, or "maps," where each map represent a connected account. Each map can have the following properties:
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Connect.registerUsers
T connect_unregisterUsers(java.util.Collection<java.lang.String> email_hashes)
throws FacebookException
email_hashes - An array of email_hashes to unregister.
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Connect.unregisterUsers
int connect_getUnconnectedFriendsCount()
throws FacebookException
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Connect.getUnconnectedFriendsCount
void fbml_deleteCustomTags(java.util.Collection<java.lang.String> names)
throws FacebookException
names - A JSON-encoded array of strings containing the names of the tags you want to delete. If this attribute is missing, all the application's custom tags
will be deleted.
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Fbml.deleteCustomTags
T fbml_getCustomTags(java.lang.String appId)
throws FacebookException
appId - The ID of the application whose custom tags you want to get. If the ID is the calling application's ID, all the application's custom tags are returned.
Otherwise, only the application's public custom tags are returned. (Default value is the calling application's ID.).
FacebookExceptionhttp://wiki.developers.facebook.com/index.php/Fbml.getCustomTags
void fbml_registerCustomTags(java.util.Collection<org.json.JSONObject> tags)
throws FacebookException
tags - a JSON-encoded list of tag objects. Each tag object is an object with the following properties: