com.google.code.facebookapi
Interface IFacebookRestClient<T>

All Known Implementing Classes:
ExtensibleClient, FacebookJaxbRestClient, FacebookJaxbRestClientBase, FacebookJsonRestClient, FacebookJsonRestClientBase, FacebookXmlRestClient, FacebookXmlRestClientBase, SpecificReturnTypeAdapter

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

TARGET_API_VERSION

static final java.lang.String TARGET_API_VERSION
See Also:
Constant Field Values

ERROR_TAG

static final java.lang.String ERROR_TAG
See Also:
Constant Field Values
Method Detail

getServerUrl

java.net.URL getServerUrl()

setServerUrl

void setServerUrl(java.net.URL newUrl)
Override the default Facebook API server used for making requests. Can be used to tell the client to run against the

Parameters:
newUrl - the new URL to use, for example: "http://api.facebook.com/restserver.php"
Throws:
java.net.MalformedURLException

setServerUrl

void setServerUrl(java.lang.String newUrl)

getConnectTimeout

@Deprecated
int getConnectTimeout()
Deprecated. 


setConnectTimeout

@Deprecated
void setConnectTimeout(int connectTimeout)
Deprecated. 


getReadTimeout

@Deprecated
int getReadTimeout()
Deprecated. 


setReadTimeout

@Deprecated
void setReadTimeout(int readTimeout)
Deprecated. 


getResponseFormat

java.lang.String getResponseFormat()

getApiKey

java.lang.String getApiKey()

getSecret

java.lang.String getSecret()

isDesktop

boolean isDesktop()
Check to see if the client is running in desktop-app mode

Returns:
true if the app is running in desktop mode. false otherwise

getCacheAppUser

@Deprecated
java.lang.Boolean getCacheAppUser()
Deprecated. 


setCacheAppUser

@Deprecated
void setCacheAppUser(java.lang.Boolean appUser)
Deprecated. 


setCacheSession

void setCacheSession(java.lang.String cacheSessionKey,
                     java.lang.Long cacheUserId,
                     java.lang.Long cacheSessionExpires)

profile_setFBML

@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
Deprecated. 

Sets the FBML for a user's profile, including the content for both the profile box and the profile actions.

Parameters:
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.
Returns:
a boolean indicating whether the FBML was successfully set
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Profile.setFBML

profile_setFBML

@Deprecated
boolean profile_setFBML(java.lang.Long userId,
                                   java.lang.String profileFbml,
                                   java.lang.String actionFbml,
                                   java.lang.String mobileFbml)
                        throws FacebookException
Deprecated. trying to reduce superfluous methods, use profile_setFBML(Long, String, String, String, String)

Throws:
FacebookException
See Also:
profile_setFBML(Long, String, String, String, String)

profile_setProfileFBML

@Deprecated
boolean profile_setProfileFBML(java.lang.CharSequence fbmlMarkup)
                               throws FacebookException
Deprecated. trying to reduce superfluous methods, use profile_setFBML(Long, String, String, String, String)

Sets the FBML for a profile box on the logged-in user's profile.

Parameters:
fbmlMarkup - refer to the FBML documentation for a description of the markup and its role in various contexts
Throws:
FacebookException
See Also:
Developers wiki: Profile.setFbml

profile_setProfileActionFBML

@Deprecated
boolean profile_setProfileActionFBML(java.lang.CharSequence fbmlMarkup)
                                     throws FacebookException
Deprecated. trying to reduce superfluous methods, use profile_setFBML(Long, String, String, String, String)

Sets the FBML for profile actions for the logged-in user.

Parameters:
fbmlMarkup - refer to the FBML documentation for a description of the markup and its role in various contexts
Returns:
a boolean indicating whether the FBML was successfully set
Throws:
FacebookException
See Also:
Developers wiki: Profile.setFBML

profile_setMobileFBML

@Deprecated
boolean profile_setMobileFBML(java.lang.CharSequence fbmlMarkup)
                              throws FacebookException
Deprecated. trying to reduce superfluous methods, use profile_setFBML(Long, String, String, String, String)

Sets the FBML for the logged-in user's profile on mobile devices.

Parameters:
fbmlMarkup - refer to the FBML documentation for a description of the markup and its role in various contexts
Returns:
a boolean indicating whether the FBML was successfully set
Throws:
FacebookException
See Also:
Developers wiki: Profile.setFBML

profile_setProfileFBML

@Deprecated
boolean profile_setProfileFBML(java.lang.CharSequence fbmlMarkup,
                                          java.lang.Long profileId)
                               throws FacebookException
Deprecated. trying to reduce superfluous methods, use profile_setFBML(Long, String, String, String, String)

Sets the FBML for a profile box on the user or page profile with ID profileId.

Parameters:
fbmlMarkup - refer to the FBML documentation for a description of the markup and its role in various contexts
profileId - a page or user ID (null for the logged-in user)
Returns:
a boolean indicating whether the FBML was successfully set
Throws:
FacebookException
See Also:
Developers wiki: Profile.setFbml

profile_setProfileActionFBML

@Deprecated
boolean profile_setProfileActionFBML(java.lang.CharSequence fbmlMarkup,
                                                java.lang.Long profileId)
                                     throws FacebookException
Deprecated. trying to reduce superfluous methods, use profile_setFBML(Long, String, String, String, String)

Sets the FBML for profile actions for the user or page profile with ID profileId.

Parameters:
fbmlMarkup - refer to the FBML documentation for a description of the markup and its role in various contexts
profileId - a page or user ID (null for the logged-in user)
Returns:
a boolean indicating whether the FBML was successfully set
Throws:
FacebookException
See Also:
Developers wiki: Profile.setFBML

profile_setMobileFBML

@Deprecated
boolean profile_setMobileFBML(java.lang.CharSequence fbmlMarkup,
                                         java.lang.Long profileId)
                              throws FacebookException
Deprecated. trying to reduce superfluous methods, use profile_setFBML(Long, String, String, String, String)

Sets the FBML for the user or page profile with ID profileId on mobile devices.

Parameters:
fbmlMarkup - refer to the FBML documentation for a description of the markup and its role in various contexts
profileId - a page or user ID (null for the logged-in user)
Returns:
a boolean indicating whether the FBML was successfully set
Throws:
FacebookException
See Also:
Developers wiki: Profile.setFBML

profile_setFBML

@Deprecated
boolean profile_setFBML(java.lang.CharSequence profileFbmlMarkup,
                                   java.lang.CharSequence profileActionFbmlMarkup)
                        throws FacebookException
Deprecated. trying to reduce superfluous methods, use profile_setFBML(Long, String, String, String, String)

Sets the FBML for the profile box and profile actions for the logged-in user. Refer to the FBML documentation for a description of the markup and its role in various contexts.

Parameters:
profileFbmlMarkup - the FBML for the profile box
profileActionFbmlMarkup - the FBML for the profile actions
Returns:
a boolean indicating whether the FBML was successfully set
Throws:
FacebookException
See Also:
Developers wiki: Profile.setFBML

profile_setFBML

@Deprecated
boolean profile_setFBML(java.lang.CharSequence profileFbmlMarkup,
                                   java.lang.CharSequence profileActionFbmlMarkup,
                                   java.lang.Long profileId)
                        throws FacebookException
Deprecated. trying to reduce superfluous methods, use profile_setFBML(Long, String, String, String, String)

Sets the FBML for the profile box and profile actions for the user or page profile with ID profileId. Refer to the FBML documentation for a description of the markup and its role in various contexts.

Parameters:
profileFbmlMarkup - the FBML for the profile box
profileActionFbmlMarkup - the FBML for the profile actions
profileId - a page or user ID (null for the logged-in user)
Returns:
a boolean indicating whether the FBML was successfully set
Throws:
FacebookException
See Also:
Developers wiki: Profile.setFBML

profile_setFBML

@Deprecated
boolean profile_setFBML(java.lang.CharSequence profileFbmlMarkup,
                                   java.lang.CharSequence profileActionFbmlMarkup,
                                   java.lang.CharSequence mobileFbmlMarkup,
                                   java.lang.Long profileId)
                        throws FacebookException
Deprecated. trying to reduce superfluous methods, use profile_setFBML(Long, String, String, String, String)

Sets the FBML for the profile box, profile actions, and mobile devices for the user or page profile with ID profileId. Refer to the FBML documentation for a description of the markup and its role in various contexts.

Parameters:
profileFbmlMarkup - the FBML for the profile box
profileActionFbmlMarkup - the FBML for the profile actions
mobileFbmlMarkup - the FBML for mobile devices
profileId - a page or user ID (null for the logged-in user)
Returns:
a boolean indicating whether the FBML was successfully set
Throws:
FacebookException
See Also:
Developers wiki: Profile.setFBML

profile_setFBML

@Deprecated
boolean profile_setFBML(java.lang.CharSequence profileFbmlMarkup,
                                   java.lang.CharSequence profileActionFbmlMarkup,
                                   java.lang.CharSequence mobileFbmlMarkup)
                        throws FacebookException
Deprecated. trying to reduce superfluous methods, use profile_setFBML(Long, String, String, String, String)

Sets the FBML for the profile box, profile actions, and mobile devices for the current user. Refer to the FBML documentation for a description of the markup and its role in various contexts.

Parameters:
profileFbmlMarkup - the FBML for the profile box
profileActionFbmlMarkup - the FBML for the profile actions
mobileFbmlMarkup - the FBML for mobile devices
profileId - a page or user ID (null for the logged-in user)
Returns:
a boolean indicating whether the FBML was successfully set
Throws:
FacebookException
See Also:
Developers wiki: Profile.setFBML

profile_getFBML

@Deprecated
T profile_getFBML()
                  throws FacebookException
Deprecated. 

Gets the FBML for the current user's profile box.

Returns:
a T containing FBML markup
Throws:
FacebookException
See Also:
profile_getFBML(int, Long)

profile_getFBML

@Deprecated
T profile_getFBML(java.lang.Long userId)
                  throws FacebookException
Deprecated. 

Gets the FBML for the user's profile box.

Parameters:
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.
Returns:
a T containing FBML markup
Throws:
FacebookException
See Also:
profile_getFBML(int, Long)

profile_getFBML

@Deprecated
T profile_getFBML(int type)
                  throws FacebookException
Deprecated. 

Gets the FBML for the current user's profile boxes.

Parameters:
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.)
Returns:
a T containing FBML markup
Throws:
FacebookException
See Also:
profile_getFBML(int, Long)

profile_getFBML

@Deprecated
T profile_getFBML(int type,
                             java.lang.Long userId)
                  throws FacebookException
Deprecated. 

Gets the FBML for the user's profile boxes.

Parameters:
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.
Returns:
a T containing FBML markup
Throws:
FacebookException
See Also:
Profile.getFBML

fbml_refreshRefUrl

boolean fbml_refreshRefUrl(java.lang.String url)
                           throws FacebookException
Recaches the referenced url.

Parameters:
url - string representing the URL to refresh
Returns:
boolean indicating whether the refresh succeeded
Throws:
FacebookException

fbml_refreshRefUrl

boolean fbml_refreshRefUrl(java.net.URL url)
                           throws FacebookException
Recaches the referenced url.

Parameters:
url - the URL to refresh
Returns:
boolean indicating whether the refresh succeeded
Throws:
FacebookException

fbml_refreshImgSrc

boolean fbml_refreshImgSrc(java.lang.String imageUrl)
                           throws FacebookException
Recaches the image with the specified imageUrl.

Parameters:
imageUrl - String representing the image URL to refresh
Returns:
boolean indicating whether the refresh succeeded
Throws:
FacebookException

fbml_refreshImgSrc

boolean fbml_refreshImgSrc(java.net.URL imageUrl)
                           throws FacebookException
Recaches the image with the specified imageUrl.

Parameters:
imageUrl - the image URL to refresh
Returns:
boolean indicating whether the refresh succeeded
Throws:
FacebookException

feed_publishTemplatizedAction

@Deprecated
boolean feed_publishTemplatizedAction(java.lang.Long actorId,
                                                 java.lang.CharSequence titleTemplate)
                                      throws FacebookException
Deprecated. since 01/18/2008

Publishes a Mini-Feed story describing an action taken by a user, and publishes aggregating News Feed stories to the friends of that user. Stories are identified as being combinable if they have matching templates and substituted values.

Parameters:
actorId - deprecated
titleTemplate - markup (up to 60 chars, tags excluded) for the feed story's title section. Must include the token {actor}.
Returns:
whether the action story was successfully published; false in case of a permission error
Throws:
FacebookException
See Also:
Developers Wiki: Feed.publishTemplatizedAction, Developers Resources: Feed Preview Console

feed_publishTemplatizedAction

@Deprecated
boolean feed_publishTemplatizedAction(java.lang.CharSequence titleTemplate)
                                      throws FacebookException
Deprecated. 

Publishes a Mini-Feed story describing an action taken by the logged-in user, and publishes aggregating News Feed stories to their friends. Stories are identified as being combinable if they have matching templates and substituted values.

Parameters:
titleTemplate - markup (up to 60 chars, tags excluded) for the feed story's title section. Must include the token {actor}.
Returns:
whether the action story was successfully published; false in case of a permission error
Throws:
FacebookException
See Also:
Developers Wiki: Feed.publishTemplatizedAction, Developers Resources: Feed Preview Console

feed_publishTemplatizedAction

@Deprecated
boolean feed_publishTemplatizedAction(java.lang.CharSequence titleTemplate,
                                                 java.lang.Long pageActorId)
                                      throws FacebookException
Deprecated. 

Publishes a Mini-Feed story describing an action taken by the logged-in user (or, if 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.

Parameters:
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
Returns:
whether the action story was successfully published; false in case of a permission error
Throws:
FacebookException
See Also:
Developers Wiki: Feed.publishTemplatizedAction, Developers Resources: Feed Preview Console

feed_publishTemplatizedAction

@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
Deprecated. 

Publishes a Mini-Feed story describing an action taken by the logged-in user (or, if 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.

Parameters:
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
Returns:
whether the action story was successfully published; false in case of a permission error
Throws:
FacebookException
See Also:
Developers Wiki: Feed.publishTemplatizedAction, Developers Resources: Feed Preview Console

feed_publishTemplatizedAction

@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
Deprecated. 

Publishes a Mini-Feed story describing an action taken by a user, and publishes aggregating News Feed stories to the friends of that user. Stories are identified as being combinable if they have matching templates and substituted values.

Parameters:
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.
Returns:
whether the action story was successfully published; false in case of a permission error
Throws:
FacebookException
See Also:
Developers Wiki: Feed.publishTemplatizedAction

friends_areFriends

T friends_areFriends(long userId1,
                     long userId2)
                     throws FacebookException
Retrieves whether two users are friends.

Parameters:
userId1 -
userId2 -
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Friends.areFriends

friends_areFriends

T friends_areFriends(java.util.Collection<java.lang.Long> userIds1,
                     java.util.Collection<java.lang.Long> userIds2)
                     throws FacebookException
Retrieves whether pairs of users are friends. Returns whether the first user in userIds1 is friends with the first user in userIds2, the second user in userIds1 is friends with the second user in userIds2, etc.

Parameters:
userIds1 -
userIds2 -
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Friends.areFriends

friends_get

T friends_get()
              throws FacebookException
Retrieves the friends of the currently logged in user.

Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Friends.get

friends_get

T friends_get(java.lang.Long uid)
              throws FacebookException
Retrieves the friends uid.

Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Friends.get

friends_getAppUsers

T friends_getAppUsers()
                      throws FacebookException
Retrieves the friends of the currently logged in user, who are also users of the calling application.

Returns:
array of friends
Throws:
FacebookException

friends_getList

T friends_getList(java.lang.Long friendListId)
                  throws FacebookException
Retrieves the friends of the currently logged in user that are members of the friends list with ID friendListId.

Parameters:
friendListId - the friend list for which friends should be fetched. if null, all friends will be retrieved.
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Friends.get

friends_getLists

T friends_getLists()
                   throws FacebookException
Retrieves the friend lists of the currently logged in user.

Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Friends.getLists

friends_getMutualFriends

T friends_getMutualFriends(java.lang.Long targetId)
                           throws FacebookException
Returns the Facebook user IDs of the mutual friends between the source user and target user. For the source user, you can either specify the source's user ID (the source_id) or use the session key of the logged-in user, but not specify both.

Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Friends.getMutualFriends

friends_getMutualFriends

T friends_getMutualFriends(java.lang.Long sourceId,
                           java.lang.Long targetId)
                           throws FacebookException
Returns the Facebook user IDs of the mutual friends between the source user and target user. For the source user, you can either specify the source's user ID (the source_id) or use the session key of the logged-in user, but not specify both.

Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Friends.getMutualFriends

users_getInfo

T users_getInfo(java.lang.Iterable<java.lang.Long> userIds,
                java.util.Collection<ProfileField> fields)
                throws FacebookException
Retrieves the requested info fields for the requested set of users.

Parameters:
userIds - a collection of user IDs for which to fetch info
fields - a set of ProfileFields
Returns:
a T consisting of a list of users, with each user element containing the requested fields.
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Users.getInfo

users_getInfo

T users_getInfo(java.lang.Iterable<java.lang.Long> userIds,
                java.util.Set<java.lang.CharSequence> fields)
                throws FacebookException
Retrieves the requested info fields for the requested set of users.

Parameters:
userIds - a collection of user IDs for which to fetch info
fields - a set of strings describing the info fields desired, such as "last_name", "sex"
Returns:
a T consisting of a list of users, with each user element containing the requested fields.
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Users.getInfo

users_getStandardInfo

T users_getStandardInfo(java.util.Collection<java.lang.Long> userIds,
                        java.util.Collection<ProfileField> fields)
                        throws FacebookException
Returns an array of user-specific information for each user identifier passed, limited by the view of the current user. The information you can get from this call is limited to: uid, first_name, last_name, name, timezone, birthday, sex, affiliations (regional type only)

Parameters:
userIds - a collection of user IDs for which to fetch info
fields - a set of ProfileFields
Returns:
a T consisting of a list of users, with each user element containing the requested fields.
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Users.getStandardInfo

users_getStandardInfo

T users_getStandardInfo(java.util.Collection<java.lang.Long> userIds,
                        java.util.Set<java.lang.CharSequence> fields)
                        throws FacebookException
Returns an array of user-specific information for each user identifier passed, limited by the view of the current user. The information you can get from this call is limited to: uid, first_name, last_name, name, timezone, birthday, sex, affiliations (regional type only)

Parameters:
userIds - a collection of user IDs for which to fetch info
fields - a set of strings describing the info fields desired, such as "last_name", "sex"
Returns:
a T consisting of a list of users, with each user element containing the requested fields.
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Users.getStandardInfo

users_getLoggedInUser

long users_getLoggedInUser()
                           throws FacebookException
Retrieves the user ID of the user logged in to this API session

Returns:
the Facebook user ID of the logged-in user
Throws:
FacebookException

users_isAppUser

boolean users_isAppUser()
                        throws FacebookException
Throws:
FacebookException
See Also:
Users.isAppUser, users_isAppUser(Long)

users_isAppUser

boolean users_isAppUser(java.lang.Long userId)
                        throws FacebookException
Returns whether the user (either the session user or user specified by uid) has authorized the calling application.

Parameters:
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.
Throws:
FacebookException
See Also:
Users.isAppUser

users_setStatus

boolean users_setStatus(java.lang.String status)
                        throws FacebookException
Sets the logged-in user's Facebook status. Requires the status_update extended permission.

Returns:
whether the status was successfully set
Throws:
FacebookException
See Also:
users_hasAppPermission(com.google.code.facebookapi.Permission), FacebookExtendedPerm.STATUS_UPDATE, http://wiki.developers.facebook.com/index.php/Users.setStatus

users_setStatus

boolean users_setStatus(java.lang.String status,
                        java.lang.Long userId)
                        throws FacebookException
Sets the spedified user's Facebook status. Requires the status_update extended permission.

Returns:
whether the status was successfully set
Throws:
FacebookException
See Also:
users_hasAppPermission(com.google.code.facebookapi.Permission), FacebookExtendedPerm.STATUS_UPDATE, http://wiki.developers.facebook.com/index.php/Users.setStatus

users_setStatus

boolean users_setStatus(java.lang.String newStatus,
                        boolean clear)
                        throws FacebookException
Set the user's profile status message. This requires that the user has granted the application the 'status_update' permission, otherwise the call will return an error. You can use 'users_hasAppPermission' to check to see if the user has granted your app the abbility to update their status.

Parameters:
newStatus - the new status message to set.
clear - whether or not to clear the old status message.
Returns:
true if the call succeeds false otherwise
Throws:
FacebookException - if an error happens when executing the API call.
See Also:
http://wiki.developers.facebook.com/index.php/Users.setStatus

users_setStatus

boolean users_setStatus(java.lang.String newStatus,
                        boolean clear,
                        java.lang.Long userId)
                        throws FacebookException
Set the user's profile status message. This requires that the user has granted the application the 'status_update' permission, otherwise the call will return an error. You can use 'users_hasAppPermission' to check to see if the user has granted your app the abbility to update their status.

Parameters:
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.
Returns:
true if the call succeeds false otherwise
Throws:
FacebookException - if an error happens when executing the API call.
See Also:
http://wiki.developers.facebook.com/index.php/Users.setStatus

users_setStatus

boolean users_setStatus(java.lang.String newStatus,
                        boolean clear,
                        boolean statusIncludesVerb)
                        throws FacebookException
Set the user's profile status message. This requires that the user has granted the application the 'status_update' permission, otherwise the call will return an error. You can use 'users_hasAppPermission' to check to see if the user has granted your app the abbility to update their status

Parameters:
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)
Returns:
true if the call succeeds false otherwise
Throws:
FacebookException - if an error happens when executing the API call.
See Also:
http://wiki.developers.facebook.com/index.php/Users.setStatus

users_setStatus

boolean users_setStatus(java.lang.String newStatus,
                        boolean clear,
                        boolean statusIncludesVerb,
                        java.lang.Long userId)
                        throws FacebookException
Set the user's profile status message. This requires that the user has granted the application the 'status_update' permission, otherwise the call will return an error. You can use 'users_hasAppPermission' to check to see if the user has granted your app the abbility to update their status

Parameters:
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.
Returns:
true if the call succeeds false otherwise
Throws:
FacebookException - if an error happens when executing the API call.
See Also:
http://wiki.developers.facebook.com/index.php/Users.setStatus

users_clearStatus

boolean users_clearStatus()
                          throws FacebookException
Clears the logged-in user's Facebook status. Requires the status_update extended permission.

Returns:
whether the status was successfully cleared
Throws:
FacebookException
See Also:
users_hasAppPermission(com.google.code.facebookapi.Permission), FacebookExtendedPerm.STATUS_UPDATE, http://wiki.developers.facebook.com/index.php/Users.setStatus

photos_get

T photos_get(java.lang.Long subjId,
             java.lang.String albumId,
             java.util.Collection<java.lang.String> photoIds)
             throws FacebookException
Used to retrieve photo objects using the search parameters (one or more of the parameters must be provided).

Parameters:
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)
Returns:
an T of photo objects.
Throws:
FacebookException

photos_get

T photos_get(java.lang.Long subjId,
             java.util.Collection<java.lang.String> photoIds)
             throws FacebookException
Used to retrieve photo objects using the search parameters (one or more of the parameters must be provided).

Parameters:
subjId - retrieve from photos associated with this user (optional).
photoIds - retrieve from this list of photos (optional)
Returns:
an T of photo objects.
Throws:
FacebookException
See Also:
#photos_get(Long, Long, Collection), Developers Wiki: Photos.get

photos_get

T photos_get(java.lang.Long subjId,
             java.lang.String albumId)
             throws FacebookException
Used to retrieve photo objects using the search parameters (one or more of the parameters must be provided).

Parameters:
subjId - retrieve from photos associated with this user (optional).
albumId - retrieve from photos from this album (optional)
Returns:
an T of photo objects.
Throws:
FacebookException
See Also:
#photos_get(Long, Long, Collection), Developers Wiki: Photos.get

photos_get

T photos_get(java.util.Collection<java.lang.String> photoIds)
             throws FacebookException
Used to retrieve photo objects using the search parameters (one or more of the parameters must be provided).

Parameters:
photoIds - retrieve from this list of photos (optional)
Returns:
an T of photo objects.
Throws:
FacebookException
See Also:
#photos_get(Long, Long, Collection), Developers Wiki: Photos.get

photos_get

T photos_get(java.lang.Long subjId)
             throws FacebookException
Used to retrieve photo objects using the search parameters (one or more of the parameters must be provided).

Parameters:
subjId - retrieve from photos associated with this user (optional).
Returns:
an T of photo objects.
Throws:
FacebookException
See Also:
#photos_get(Long, Long, Collection), Developers Wiki: Photos.get

photos_getAlbums

T photos_getAlbums(java.lang.Long userId,
                   java.util.Collection<java.lang.String> albumIds)
                   throws FacebookException
Retrieves album metadata. Pass a user id and/or a list of album ids to specify the albums to be retrieved (at least one must be provided)

Parameters:
userId - (optional) the id of the albums' owner (optional)
albumIds - (optional) the ids of albums whose metadata is to be retrieved
Returns:
album objects
Throws:
FacebookException
See Also:
Developers Wiki: Photos.getAlbums

photos_getAlbums

T photos_getAlbums(java.lang.Long userId)
                   throws FacebookException
Retrieves album metadata for albums owned by a user.

Parameters:
userId - (optional) the id of the albums' owner (optional)
Returns:
album objects
Throws:
FacebookException
See Also:
Developers Wiki: Photos.getAlbums

photos_getAlbums

T photos_getAlbums(java.util.Collection<java.lang.String> albumIds)
                   throws FacebookException
Retrieves album metadata for a list of album IDs.

Parameters:
albumIds - the ids of albums whose metadata is to be retrieved
Returns:
album objects
Throws:
FacebookException
See Also:
Developers Wiki: Photos.getAlbums

photos_getTags

T photos_getTags(java.util.Collection<java.lang.String> photoIds)
                 throws FacebookException
Retrieves the tags for the given set of photos.

Parameters:
photoIds - The list of photos from which to extract photo tags.
Returns:
the created album
Throws:
FacebookException

photos_createAlbum

T photos_createAlbum(java.lang.String albumName)
                     throws FacebookException
Creates an album.

Parameters:
albumName - The list of photos from which to extract photo tags.
Returns:
the created album
Throws:
FacebookException

photos_createAlbum

T photos_createAlbum(java.lang.String name,
                     java.lang.String description,
                     java.lang.String location)
                     throws FacebookException
Creates an album.

Parameters:
name - The album name.
location - The album location (optional).
description - The album description (optional).
Returns:
an array of photo objects.
Throws:
FacebookException

photos_createAlbum

T photos_createAlbum(java.lang.String albumName,
                     java.lang.Long userId)
                     throws FacebookException
Creates an album.

Parameters:
albumName - The list of photos from which to extract photo tags.
userId - the id of the user creating the album.
Returns:
the created album
Throws:
FacebookException

photos_createAlbum

T photos_createAlbum(java.lang.String name,
                     java.lang.String description,
                     java.lang.String location,
                     java.lang.Long userId)
                     throws FacebookException
Creates an album.

Parameters:
name - The album name.
location - The album location (optional).
description - The album description (optional).
userId - the id of the user creating the album.
Returns:
an array of photo objects.
Throws:
FacebookException

photos_addTags

T photos_addTags(java.lang.String photoId,
                 java.util.Collection<PhotoTag> tags)
                 throws FacebookException
Adds several tags to a photo.

Parameters:
photoId - The photo id of the photo to be tagged.
tags - A list of PhotoTags.
Returns:
a list of booleans indicating whether the tag was successfully added.
Throws:
FacebookException

photos_addTag

boolean photos_addTag(java.lang.String photoId,
                      java.lang.Long taggedUserId,
                      java.lang.Double xPct,
                      java.lang.Double yPct)
                      throws FacebookException
Adds a tag to a photo.

Parameters:
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.
Returns:
whether the tag was successfully added.
Throws:
FacebookException

photos_addTag

boolean photos_addTag(java.lang.String photoId,
                      java.lang.CharSequence tagText,
                      java.lang.Double xPct,
                      java.lang.Double yPct)
                      throws FacebookException
Adds a tag to a photo.

Parameters:
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.
Returns:
whether the tag was successfully added.
Throws:
FacebookException

photos_addTag

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
Adds a tag to a photo.

Parameters:
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.
Returns:
whether the tag was successfully added.
Throws:
FacebookException

photos_addTag

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
Adds a tag to a photo.

Parameters:
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.
Returns:
whether the tag was successfully added.
Throws:
FacebookException

photos_upload

T photos_upload(java.io.File photo)
                throws FacebookException
Uploads a photo to Facebook.

Parameters:
photo - an image file
Returns:
a T with the standard Facebook photo information
Throws:
FacebookException
See Also:
Developers wiki: Photos.upload

photos_uploadWithCaption

T photos_uploadWithCaption(java.io.File photo,
                           java.lang.String caption)
                           throws FacebookException
Uploads a photo to Facebook.

Parameters:
photo - an image file
caption - a description of the image contents
Returns:
a T with the standard Facebook photo information
Throws:
FacebookException
See Also:
Developers wiki: Photos.upload

photos_uploadToAlbum

T photos_uploadToAlbum(java.io.File photo,
                       java.lang.String albumId)
                       throws FacebookException
Uploads a photo to Facebook.

Parameters:
photo - an image file
albumId - the album into which the photo should be uploaded
Returns:
a T with the standard Facebook photo information
Throws:
FacebookException
See Also:
Developers wiki: Photos.upload

photos_upload

T photos_upload(java.io.File photo,
                java.lang.String caption,
                java.lang.String albumId)
                throws FacebookException
Uploads a photo to Facebook.

Parameters:
photo - an image file
caption - a description of the image contents
albumId - the album into which the photo should be uploaded
Returns:
a T with the standard Facebook photo information
Throws:
FacebookException
See Also:
Developers wiki: Photos.upload

photos_upload

T photos_upload(java.lang.Long userId,
                java.io.File photo)
                throws FacebookException
Uploads a photo to Facebook.

Parameters:
photo - an image file
userId - the id of the user uploading the photo
Returns:
a T with the standard Facebook photo information
Throws:
FacebookException
See Also:
Developers wiki: Photos.upload

photos_uploadWithCaption

T photos_uploadWithCaption(java.lang.Long userId,
                           java.io.File photo,
                           java.lang.String caption)
                           throws FacebookException
Uploads a photo to Facebook.

Parameters:
photo - an image file
caption - a description of the image contents
userId - the id of the user uploading the photo
Returns:
a T with the standard Facebook photo information
Throws:
FacebookException
See Also:
Developers wiki: Photos.upload

photos_uploadToAlbum

T photos_uploadToAlbum(java.lang.Long userId,
                       java.io.File photo,
                       java.lang.String albumId)
                       throws FacebookException
Uploads a photo to Facebook.

Parameters:
photo - an image file
albumId - the album into which the photo should be uploaded
userId - the id of the user uploading the photo
Returns:
a T with the standard Facebook photo information
Throws:
FacebookException
See Also:
Developers wiki: Photos.upload

photos_upload

T photos_upload(java.lang.Long userId,
                java.io.File photo,
                java.lang.String caption,
                java.lang.String albumId)
                throws FacebookException
Uploads a photo to Facebook.

Parameters:
photo - an image file
caption - a description of the image contents
albumId - the album into which the photo should be uploaded
userId - the id of the user uploading the photo
Returns:
a T with the standard Facebook photo information
Throws:
FacebookException
See Also:
Developers wiki: Photos.upload

photos_upload

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
Uploads a photo to Facebook.

Parameters:
userId - the id of the user uploading the photo
caption - a description of the image contents
albumId - the album into which the photo should be uploaded
fileName -
fileStream -
Returns:
a T with the standard Facebook photo information
Throws:
FacebookException
See Also:
Developers wiki: Photos.upload

groups_get

T groups_get(java.lang.Long userId,
             java.util.Collection<java.lang.Long> groupIds)
             throws FacebookException
Retrieves the groups associated with a user

Parameters:
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.
Returns:
array of groups
Throws:
FacebookException

groups_getMembers

T groups_getMembers(java.lang.Number groupId)
                    throws FacebookException
Retrieves the membership list of a group

Parameters:
groupId - the group id
Returns:
a T containing four membership lists of 'members', 'admins', 'officers', and 'not_replied'
Throws:
FacebookException

fql_query

T fql_query(java.lang.CharSequence query)
            throws FacebookException
Retrieves the results of a Facebook Query Language query

Parameters:
query - : the FQL query statement
Returns:
varies depending on the FQL query
Throws:
FacebookException

auth_createToken

java.lang.String auth_createToken()
                                  throws FacebookException
Call this function and store the result, using it to generate the appropriate login url and then to retrieve the session information.

Returns:
an authentication token
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Auth.createToken

auth_getSession

java.lang.String auth_getSession(java.lang.String authToken)
                                 throws FacebookException
Call this function to retrieve the session information after your user has logged in.

Parameters:
authToken - the token returned by auth_createToken or passed back to your callback_url.
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Auth.getSession

auth_getSession

java.lang.String auth_getSession(java.lang.String authToken,
                                 boolean generateSessionSecret)
                                 throws FacebookException
Call this function to retrieve the session information after your user has logged in. Settings generateSessionSecret to true results in a temporary "session" secret being generated by Facebook which you can pass to a desktop client to be used in place of the real application secret. This prevents the need to reveal your application secret to users.

Parameters:
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
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Auth.getSession

getCacheSessionKey

java.lang.String getCacheSessionKey()

getCacheUserId

java.lang.Long getCacheUserId()

getCacheSessionExpires

java.lang.Long getCacheSessionExpires()

photos_getByAlbum

T photos_getByAlbum(java.lang.String albumId,
                    java.util.Collection<java.lang.String> photoIds)
                    throws FacebookException
Used to retrieve photo objects using the search parameters (one or more of the parameters must be provided).

Parameters:
albumId - retrieve from photos from this album (optional)
photoIds - retrieve from this list of photos (optional)
Returns:
an T of photo objects.
Throws:
FacebookException
See Also:
#photos_get(Integer, Long, Collection), Developers Wiki: Photos.get

photos_getByAlbum

T photos_getByAlbum(java.lang.String albumId)
                    throws FacebookException
Used to retrieve photo objects using the search parameters (one or more of the parameters must be provided).

Parameters:
albumId - retrieve from photos from this album (optional)
Returns:
an T of photo objects.
Throws:
FacebookException
See Also:
#photos_get(Integer, Long, Collection), Developers Wiki: Photos.get

getRawResponse

java.lang.String getRawResponse()
Returns a string representation for the last API response recieved from Facebook, exactly as sent by the API server. Note that calling this method consumes the data held in the internal buffer, and thus it may only be called once per API call.

Returns:
a String representation of the last API response sent by Facebook

feed_PublishTemplatizedAction

@Deprecated
boolean feed_PublishTemplatizedAction(TemplatizedAction action)
                                      throws FacebookException
Deprecated. 

Publishes a templatized action for the current user. The action will appear in their minifeed, and may appear in their friends' newsfeeds depending upon a number of different factors. When a template match exists between multiple distinct users (like "Bob recommends Bizou" and "Sally recommends Bizou"), the feed entries may be combined in the newfeed (to something like "Bob and sally recommend Bizou"). This happens automatically, and *only* if the template match between the two feed entries is identical.

Feed entries are not aggregated for a single user (so "Bob recommends Bizou" and "Bob recommends Le Charm" *will not* become "Bob recommends Bizou and Le Charm").

If the user's action involves one or more of their friends, list them in the 'targetIds' parameter. For example, if you have "Bob says hi to Sally and Susie", and Sally's UID is 1, and Susie's UID is 2, then pass a 'targetIds' paramters of "1,2". If you pass this parameter, you can use the "{target}" token in your templates. Probably it also makes it more likely that Sally and Susie will see the feed entry in their newsfeed, relative to any other friends Bob might have. It may be a good idea to always send a list of all the user's friends, and avoid using the "{target}" token, to maximize distribution of the story through the newsfeed.

The only strictly required parameter is 'titleTemplate', which must contain the "{actor}" token somewhere inside of it. All other parameters, options, and tokens are optional, and my be set to null if being omitted.

Not that stories will only be aggregated if *all* templates match and *all* template parameters match, so if two entries have the same templateTitle and titleData, but a different bodyTemplate, they will not aggregate. Probably it's better to use bodyGeneral instead of bodyTemplate, for the extra flexibility it provides.


Note that this method is replacing 'feed_publishActionOfUser', which has been deprecated by Facebook. For specific details, visit http://wiki.developers.facebook.com/index.php/Feed.publishTemplatizedAction

Parameters:
action - a TemplatizedAction instance that represents the feed data to publish
Returns:
a Document representing the XML response returned from the Facebook API server.
Throws:
FacebookException - if any number of bad things happen

data_getUserPreference

java.lang.String data_getUserPreference(int prefId)
                                        throws FacebookException
Lookup a single preference value for the current user.

Parameters:
prefId - the id of the preference to lookup. This should be an integer value from 0-200.
Returns:
The value of that preference, or null if it is not yet set.
Throws:
FacebookException - if an error happens when executing the API call.

data_getUserPreferences

T data_getUserPreferences()
                          throws FacebookException
Get a map containing all preference values set for the current user.

Returns:
a map of preference values, keyed by preference id. The map will contain all preferences that have been set for the current user. If there are no preferences currently set, the map will be empty. The map returned will never be null.
Throws:
FacebookException - if an error happens when executing the API call.

data_setUserPreference

void data_setUserPreference(int prefId,
                            java.lang.String value)
                            throws FacebookException
Set a user-preference value. The value can be any string up to 127 characters in length, while the preference id can only be an integer between 0 and 200. Any preference set applies only to the current user of the application. To clear a user-preference, specify null as the value parameter. The values of "0" and "" will be stored as user-preferences with a literal value of "0" and "" respectively.

Parameters:
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.
Throws:
FacebookException - if an error happens when executing the API call.

data_setUserPreferences

void data_setUserPreferences(java.util.Map<java.lang.Integer,java.lang.String> values,
                             boolean replace)
                             throws FacebookException
Set multiple user-preferences values. The values can be strings up to 127 characters in length, while the preference id can only be an integer between 0 and 200. Any preferences set apply only to the current user of the application. To clear a user-preference, specify null as its value in the map. The values of "0" and "" will be stored as user-preferences with a literal value of "0" and "" respectively.

Parameters:
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
Throws:
FacebookException - if an error happens when executing the API call.

data_createObjectType

void data_createObjectType(java.lang.String name)
                           throws FacebookException
An object type is like a "table" in SQL terminology, or a "class" in object-oriented programming concepts. Each object type has a unique human-readable "name" that will be used to identify itself throughout the API. Each object type also has a list of properties that one has to define individually. Each property is like a "column" in an SQL table, or a "data member" in an object class.

Parameters:
name -
Throws:
FacebookException
See Also:
Developers Wiki: Data.createObjectType

data_dropObjectType

void data_dropObjectType(java.lang.String objectType)
                         throws FacebookException
Remove a previously defined object type. This will also delete ALL objects of this type. This deletion is NOT reversible.

Parameters:
objectType -
Throws:
FacebookException
See Also:
Developers Wiki: Data.dropObjectType

data_renameObjectType

void data_renameObjectType(java.lang.String name,
                           java.lang.String newName)
                           throws FacebookException
Throws:
FacebookException

data_defineObjectProperty

void data_defineObjectProperty(java.lang.String objectType,
                               java.lang.String propertyName,
                               PropertyType propertyType)
                               throws FacebookException
Throws:
FacebookException

data_undefineObjectProperty

void data_undefineObjectProperty(java.lang.String objectType,
                                 java.lang.String propertyName)
                                 throws FacebookException
Throws:
FacebookException

data_renameObjectProperty

void data_renameObjectProperty(java.lang.String objectType,
                               java.lang.String propertyName,
                               java.lang.String newPropertyName)
                               throws FacebookException
Throws:
FacebookException

data_getObjectTypes

T data_getObjectTypes()
                      throws FacebookException
Throws:
FacebookException

data_getObjectType

T data_getObjectType(java.lang.String objectType)
                     throws FacebookException
Throws:
FacebookException

users_hasAppPermission

boolean users_hasAppPermission(Permission perm)
                               throws FacebookException
Throws:
FacebookException
See Also:
users_hasAppPermission(Permission,Long), Users.hasAppPermission

users_hasAppPermission

boolean users_hasAppPermission(Permission perm,
                               java.lang.Long userId)
                               throws FacebookException
Checks whether the user has opted in to an extended application permission.

Parameters:
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.
Returns:
true if the user has granted the application the specified permission false otherwise
Throws:
FacebookException
See Also:
Users.hasAppPermission

feed_publishTemplatizedAction

@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
Deprecated. 

Publishes a templatized action for the current user. The action will appear in their minifeed, and may appear in their friends' newsfeeds depending upon a number of different factors. When a template match exists between multiple distinct users (like "Bob recommends Bizou" and "Sally recommends Bizou"), the feed entries may be combined in the newfeed (to something like "Bob and sally recommend Bizou"). This happens automatically, and *only* if the template match between the two feed entries is identical.

Feed entries are not aggregated for a single user (so "Bob recommends Bizou" and "Bob recommends Le Charm" *will not* become "Bob recommends Bizou and Le Charm").

If the user's action involves one or more of their friends, list them in the 'targetIds' parameter. For example, if you have "Bob says hi to Sally and Susie", and Sally's UID is 1, and Susie's UID is 2, then pass a 'targetIds' paramters of "1,2". If you pass this parameter, you can use the "{target}" token in your templates. Probably it also makes it more likely that Sally and Susie will see the feed entry in their newsfeed, relative to any other friends Bob might have. It may be a good idea to always send a list of all the user's friends, and avoid using the "{target}" token, to maximize distribution of the story through the newsfeed.

The only strictly required parameter is 'titleTemplate', which must contain the "{actor}" token somewhere inside of it. All other parameters, options, and tokens are optional, and my be set to null if being omitted.

Not that stories will only be aggregated if *all* templates match and *all* template parameters match, so if two entries have the same templateTitle and titleData, but a different bodyTemplate, they will not aggregate. Probably it's better to use bodyGeneral instead of bodyTemplate, for the extra flexibility it provides.


Note that this method is replacing 'feed_publishActionOfUser', which has been deprecated by Facebook. For specific details, visit http://wiki.developers.facebook.com/index.php/Feed.publishTemplatizedAction

Parameters:
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 titleData
bodyGeneral - 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.
Returns:
a Document representing the XML response returned from the Facebook API server.
Throws:
FacebookException - if any number of bad things happen

fbml_setRefHandle

boolean fbml_setRefHandle(java.lang.String handle,
                          java.lang.String markup)
                          throws FacebookException
Associates the specified FBML markup with the specified handle/id. The markup can then be referenced using the fb:ref FBML tag, to allow a given snippet to be reused easily across multiple users, and also to allow the application to update the fbml for multiple users more easily without having to make a seperate call for each user, by just changing the FBML markup that is associated with the handle/id. This method cannot be called by desktop apps.

Parameters:
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.
Throws:
FacebookException - if an error happens when executing the API call.

feed_publishTemplatizedAction

@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
Deprecated. use the version that specified the actorId as a Long instead. UID's *are not ever to be* expressed as Integers.

Publishes a Mini-Feed story describing an action taken by a user, and publishes aggregating News Feed stories to the friends of that user. Stories are identified as being combinable if they have matching templates and substituted values.

Parameters:
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.
Returns:
whether the action story was successfully published; false in case of a permission error
Throws:
FacebookException
See Also:
Developers Wiki: Feed.publishTemplatizedAction, Developers Resources: Feed Preview Console

pages_getInfo

T pages_getInfo(java.util.Collection<java.lang.Long> pageIds,
                java.util.Collection<PageProfileField> fields)
                throws FacebookException
Retrieves the requested profile fields for the Facebook Pages with the given pageIds. Can be called for pages that have added the application without establishing a session.

Parameters:
pageIds - the page IDs
fields - a set of page profile fields
Returns:
a T consisting of a list of pages, with each page element containing the requested fields.
Throws:
FacebookException
See Also:
Developers Wiki: Pages.getInfo

pages_getInfo

T pages_getInfo(java.util.Collection<java.lang.Long> pageIds,
                java.util.Set<java.lang.CharSequence> fields)
                throws FacebookException
Retrieves the requested profile fields for the Facebook Pages with the given pageIds. Can be called for pages that have added the application without establishing a session.

Parameters:
pageIds - the page IDs
fields - a set of page profile fields
Returns:
a T consisting of a list of pages, with each page element containing the requested fields.
Throws:
FacebookException
See Also:
Developers Wiki: Pages.getInfo

pages_getInfo

T pages_getInfo(java.lang.Long userId,
                java.util.Collection<PageProfileField> fields)
                throws FacebookException
Retrieves the requested profile fields for the Facebook Pages of the user with the given userId.

Parameters:
userId - the ID of a user about whose pages to fetch info
fields - a set of PageProfileFields
Returns:
a T consisting of a list of pages, with each page element containing the requested fields.
Throws:
FacebookException
See Also:
Developers Wiki: Pages.getInfo

pages_getInfo

T pages_getInfo(java.lang.Long userId,
                java.util.Set<java.lang.CharSequence> fields)
                throws FacebookException
Retrieves the requested profile fields for the Facebook Pages of the user with the given userId.

Parameters:
userId - the ID of a user about whose pages to fetch info
fields - a set of page profile fields
Returns:
a T consisting of a list of pages, with each page element containing the requested fields.
Throws:
FacebookException
See Also:
Developers Wiki: Pages.getInfo

pages_isAppAdded

boolean pages_isAppAdded(java.lang.Long pageId)
                         throws FacebookException
Checks whether a page has added the application

Parameters:
pageId - the ID of the page
Returns:
true if the page has added the application
Throws:
FacebookException
See Also:
Developers Wiki: Pages.isAppAdded

pages_isFan

boolean pages_isFan(java.lang.Long pageId,
                    java.lang.Long userId)
                    throws FacebookException
Checks whether a user is a fan of the page with the given pageId.

Parameters:
pageId - the ID of the page
userId - the ID of the user (defaults to the logged-in user if null)
Returns:
true if the user is a fan of the page
Throws:
FacebookException
See Also:
Developers Wiki: Pages.isFan

pages_isFan

boolean pages_isFan(java.lang.Long pageId)
                    throws FacebookException
Checks whether the logged-in user is a fan of the page with the given pageId.

Parameters:
pageId - the ID of the page
Returns:
true if the logged-in user is a fan of the page
Throws:
FacebookException
See Also:
Developers Wiki: Pages.isFan

pages_isAdmin

boolean pages_isAdmin(java.lang.Long pageId)
                      throws FacebookException
Checks whether the logged-in user for this session is an admin of the page with the given pageId.

Parameters:
pageId - the ID of the page
Returns:
true if the logged-in user is an admin
Throws:
FacebookException
See Also:
Developers Wiki: Pages.isAdmin

payments_getOrders

java.lang.Object payments_getOrders(java.lang.String status,
                                    long startTime,
                                    long endTime)
                                    throws FacebookException
Returns all orders for the given application

Parameters:
status - Return orders with the specified status. Specify one of reserved, settled, or refunded
startTime - Return orders within this time interval
endTime - Return orders within this time interval
Returns:
An array of {order_ids => order_details}. Currently limited by facebook to returning 100,000 orders per query.
Throws:
FacebookException

notifications_get

@Deprecated
T notifications_get()
                    throws FacebookException
Deprecated. 

Retrieves the outstanding notifications for the session user.

Returns:
a T containing notification count pairs for 'messages', 'pokes' and 'shares', a uid list of 'friend_requests', a gid list of 'group_invites', and an eid list of 'event_invites'
Throws:
FacebookException

notifications_send

@Deprecated
java.net.URL notifications_send(java.util.Collection<java.lang.Long> recipientIds,
                                           java.lang.CharSequence notification,
                                           java.lang.CharSequence email)
                                throws FacebookException
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.

Send a notification message to the specified users.

Parameters:
recipientIds - the user ids to which the message is to be sent
notification - the FBML to display on the notifications page
email - the FBML to send to the specified users via email, or null if no email should be sent
Returns:
a URL, possibly null, to which the user should be redirected to finalize the sending of the email
Throws:
FacebookException

notifications_send

@Deprecated
java.util.Collection<java.lang.String> notifications_send(java.util.Collection<java.lang.Long> recipientIds,
                                                                     java.lang.CharSequence notification)
                                                          throws FacebookException
Deprecated. 

Send a notification message to the specified users.

Parameters:
recipientIds - the user ids to which the message is to be sent.
notification - the FBML to display on the notifications page.
Throws:
FacebookException

notifications_sendEmailToCurrentUser

java.util.Collection<java.lang.String> notifications_sendEmailToCurrentUser(java.lang.String subject,
                                                                            java.lang.String email,
                                                                            java.lang.String fbml)
                                                                            throws FacebookException
Send an e-mail to the currently logged-in user. The e-mail content can be specified as either plaintext or FBML. In either case, only a limited subset of markup is supported (only tags that result in text and links are allowed). You must include at least one of either the fbml or email parameters, but you do not ever need to specify both at once (the other can be null, or ""). If you specify both a text version and a fbml version of your e-mail, the text version will be used.

Parameters:
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.
Returns:
a list of user-ids specifying which users were successfully emailed.
Throws:
FacebookException - if an error happens when executing the API call.

notifications_sendEmail

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
Send an e-mail to a set of app-users. You can only e-mail users who have already added your application. The e-mail content can be specified as either plaintext or FBML. In either case, only a limited subset of markup is supported (only tags that result in text and links are allowed). You must include at least one of either the fbml or email parameters, but you do not ever need to specify both at once (the other can be null, or ""). If you specify both a text version and a fbml version of your e-mail, the text version will be used.

Parameters:
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.
Returns:
a list of user-ids specifying which users were successfully emailed.
Throws:
FacebookException - if an error happens when executing the API call.

notifications_sendTextEmailToCurrentUser

java.util.Collection<java.lang.String> notifications_sendTextEmailToCurrentUser(java.lang.String subject,
                                                                                java.lang.String email)
                                                                                throws FacebookException
Send an e-mail to the currently logged-in user. The e-mail must be specified as plaintext, and can contain a limited subset of HTML tags (specifically, only tags that result in text and links).

Parameters:
subject - the subject of the email message.
email - a plaintext version of the email to send.
Returns:
a list of user-ids specifying which users were successfully emailed.
Throws:
FacebookException - if an error happens when executing the API call.

notifications_sendTextEmail

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
Send an e-mail to a set of app-users. You can only e-mail users who have already added your application. The e-mail content can be specified as either plaintext or FBML. In either case, only a limited subset of markup is supported (only tags that result in text and links are allowed).

Parameters:
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.
Returns:
a list of user-ids specifying which users were successfully emailed.
Throws:
FacebookException - if an error happens when executing the API call.

notifications_sendFbmlEmailToCurrentUser

java.util.Collection<java.lang.String> notifications_sendFbmlEmailToCurrentUser(java.lang.String subject,
                                                                                java.lang.String fbml)
                                                                                throws FacebookException
Send an e-mail to the currently logged-in user. The e-mail must be specified as fbml, and can contain a limited subset of FBML tags (specifically, only tags that result in text and links).

Parameters:
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.
Returns:
a list of user-ids specifying which users were successfully emailed.
Throws:
FacebookException - if an error happens when executing the API call.

notifications_sendFbmlEmail

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
Send an e-mail to a set of app-users. You can only e-mail users who have already added your application. The e-mail content can be specified as either plaintext or FBML. In either case, only a limited subset of markup is supported (only tags that result in text and links are allowed).

Parameters:
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.
Returns:
a list of user-ids specifying which users were successfully emailed.
Throws:
FacebookException - if an error happens when executing the API call.

notifications_send

@Deprecated
java.util.Collection<java.lang.String> notifications_send(java.lang.CharSequence notification)
                                                          throws FacebookException
Deprecated. 

Send a notification message to the logged-in user.

Parameters:
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
Returns:
a URL, possibly null, to which the user should be redirected to finalize the sending of the email
Throws:
FacebookException
See Also:
Developers Wiki: notifications.send

notifications_sendEmail

@Deprecated
java.lang.String notifications_sendEmail(java.util.Collection<java.lang.Long> recipientIds,
                                                    java.lang.CharSequence subject,
                                                    java.lang.CharSequence fbml)
                                         throws FacebookException
Deprecated. provided for legacy support only, please use one of the alternate notifications_sendEmail calls.

Sends a notification email to the specified users, who must have added your application. You can send five (5) emails to a user per day. Requires a session key for desktop applications, which may only send email to the person whose session it is. This method does not require a session for Web applications.

Parameters:
recipientIds - up to 100 user ids to which the message is to be sent
subject - 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
Returns:
a comma-separated list of the IDs of the users to whom the email was successfully sent
Throws:
FacebookException
See Also:
Developers Wiki: notifications.sendEmail

notifications_sendEmailPlain

@Deprecated
java.lang.String notifications_sendEmailPlain(java.util.Collection<java.lang.Long> recipientIds,
                                                         java.lang.CharSequence subject,
                                                         java.lang.CharSequence text)
                                              throws FacebookException
Deprecated. provided for legacy support only, please use one of the alternate notifications_sendEmail calls.

Sends a notification email to the specified users, who must have added your application. You can send five (5) emails to a user per day. Requires a session key for desktop applications, which may only send email to the person whose session it is. This method does not require a session for Web applications.

Parameters:
recipientIds - up to 100 user ids to which the message is to be sent
subject - the subject of the notification email (optional)
text - the plain text to send to the specified users via email
Returns:
a comma-separated list of the IDs of the users to whom the email was successfully sent
Throws:
FacebookException
See Also:
Developers Wiki: notifications.sendEmail

notifications_sendEmailStr

@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
Deprecated. provided for legacy support only, please use one of the alternate notifications_sendEmail calls.

Sends a notification email to the specified users, who must have added your application. You can send five (5) emails to a user per day. Requires a session key for desktop applications, which may only send email to the person whose session it is. This method does not require a session for Web applications. Either fbml or text must be specified.

Parameters:
recipientIds - up to 100 user ids to which the message is to be sent
subject - 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 allowed
text - the plain text to send to the specified users via email
Returns:
a comma-separated list of the IDs of the users to whom the email was successfully sent
Throws:
FacebookException
See Also:
Developers Wiki: notifications.sendEmail

admin_setAppProperties

boolean admin_setAppProperties(java.util.Map<ApplicationProperty,java.lang.String> properties)
                               throws FacebookException
Set application properties. The properties are used by Facebook to describe the configuration of your application. This method cannot be called by desktop apps.

Parameters:
properties - a Map containing the properties to set.
Returns:
true if the properties are set successfully false otherwise
Throws:
FacebookException

admin_getAppProperties

@Deprecated
org.json.JSONObject admin_getAppProperties(java.util.Collection<ApplicationProperty> properties)
                                           throws FacebookException
Deprecated. use admin_getAppPropertiesMap() instead

Retrieve application properties. The properties are used by Facebook to describe the configuration of your application. This method cannot be called by desktop apps.

Parameters:
properties - a collection indicating the properties you are interested in retrieving.
Returns:
a JSONObject that maps ApplicationProperty names to their corresponding values.
Throws:
FacebookException

admin_getAppPropertiesMap

java.util.Map<ApplicationProperty,java.lang.String> admin_getAppPropertiesMap(java.util.Collection<ApplicationProperty> properties)
                                                                              throws FacebookException
Retrieve application properties. The properties are used by Facebook to describe the configuration of your application. This method cannot be called by desktop apps.

Parameters:
properties - a collection indicating the properties you are interested in retrieving.
Returns:
a mapping of ApplicationProperty's to the corresponding values that are set for those properties. Properties are represented as strings, so properties that are of boolean type will have a value of "true" when true, and "false" when false. The properties returned will never be null, an unset property is represented by an empty string.
Throws:
FacebookException

admin_getAppPropertiesAsString

java.lang.String admin_getAppPropertiesAsString(java.util.Collection<ApplicationProperty> properties)
                                                throws FacebookException
Retrieve application properties. The properties are used by Facebook to describe the configuration of your application. This method cannot be called by desktop apps.

Parameters:
properties - a collection indicating the properties you are interested in retrieving.
Returns:
a JSON-encoded string containing the properties. It is your responsibility to parse the string. Details can be found at http://wiki.developers.facebook.com/index.php/Admin.getAppProperties
Throws:
FacebookException

dashboard_multiAddNews

T dashboard_multiAddNews(java.util.Collection<java.lang.Long> userIds,
                         java.util.Collection<DashboardNewsItem> newsItems,
                         java.lang.String imageUrl)
                         throws FacebookException
Adds all of the supplied news items to each of the users specified.

Parameters:
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)
Returns:
Set of user ids for which the operation was successful.
Throws:
FacebookException

dashboard_multiAddNews

T dashboard_multiAddNews(java.util.Collection<java.lang.Long> userIds,
                         java.util.Collection<DashboardNewsItem> newsItems)
                         throws FacebookException
Non-imageUrl method signature form.

Throws:
FacebookException
See Also:
dashboard_multiAddNews(Collection, Collection, String)

dashboard_multiClearNews

T dashboard_multiClearNews(java.util.Map<java.lang.Long,java.util.Collection<java.lang.Long>> userIdToNewsIdsMap)
                           throws FacebookException
Removes the referenced news items against each of the users specified.

Parameters:
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)
Returns:
Set of user ids for which the operation was successful.
Throws:
FacebookException

dashboard_multiClearNews

T dashboard_multiClearNews(java.util.Collection<java.lang.Long> userIds)
                           throws FacebookException
Clears all of the news items associated to the specified users.

Throws:
FacebookException
See Also:
#dashboard_multiClearNews(Map>)

dashboard_addGlobalNews

java.lang.Long dashboard_addGlobalNews(java.util.Collection<DashboardNewsItem> newsItems,
                                       java.lang.String imageUrl)
                                       throws FacebookException
Submits global news items for all users of the app.

Parameters:
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)
Returns:
Global news item id if successful, null if unsuccessful.
Throws:
FacebookException

dashboard_addGlobalNews

java.lang.Long dashboard_addGlobalNews(java.util.Collection<DashboardNewsItem> newsItems)
                                       throws FacebookException
Non-imageUrl method signature form.

Throws:
FacebookException
See Also:
#dashboard_addGlobalNews(Collection, Collection, String)

dashboard_clearGlobalNews

boolean dashboard_clearGlobalNews()
                                  throws FacebookException
Clears all global news items from application.

Returns:
True if removal of global news items was successful.
Throws:
FacebookException

dashboard_clearGlobalNews

boolean dashboard_clearGlobalNews(java.util.Collection<java.lang.Long> newsIds)
                                  throws FacebookException
Clears specific global news items from application.

Returns:
True if removal of global news items was successful.
Throws:
FacebookException

dashboard_publishActivity

java.lang.Long dashboard_publishActivity(DashboardActivityItem activityItem,
                                         java.lang.String imageUrl)
                                         throws FacebookException
Submits activity for a given user as it will appear in the dashboard section, 'what your friends are doing'.

Parameters:
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)
Returns:
Activity id if successful, null if unsuccessful.
Throws:
FacebookException

dashboard_publishActivity

java.lang.Long dashboard_publishActivity(DashboardActivityItem activityItem)
                                         throws FacebookException
Non-imageUrl method signature form.

Throws:
FacebookException
See Also:
dashboard_publishActivity(DashboardActivityItem, String)

dashboard_multiIncrementCount

java.util.Set<java.lang.Long> dashboard_multiIncrementCount(java.util.Collection<java.lang.Long> userIds)
                                                            throws FacebookException
Increments the dashboard bookmark counter by one for the given set of users.

Parameters:
userIds - Users for which to update dashboard bookmark counter by one.
Returns:
Set of user ids for which operation was successful.
Throws:
FacebookException

data_getCookies

T data_getCookies()
                  throws FacebookException
Get all cookies for the currently logged-in user.

Returns:
all cookies for the current user.
Throws:
FacebookException

data_getCookies

T data_getCookies(java.lang.Long userId)
                  throws FacebookException
Get all cookies for the specified user.

Parameters:
userId - the id of the user to get the cookies for.
Returns:
all cookies for the specified user.
Throws:
FacebookException

data_getCookies

T data_getCookies(java.lang.String name)
                  throws FacebookException
Get a specific cookie for the currently logged-in user.

Parameters:
name - the name of the cookie to retrieve.
Returns:
the specified cookie for the current user.
Throws:
FacebookException

data_getCookies

T data_getCookies(java.lang.Long userId,
                  java.lang.CharSequence name)
                  throws FacebookException
Get a specific cookie for the specified user.

Parameters:
userId - the id of the user to get the cookies for.
name - the name of the cookie to retrieve.
Returns:
the specified cookie for the specified user.
Throws:
FacebookException

data_setCookie

boolean data_setCookie(java.lang.String name,
                       java.lang.String value)
                       throws FacebookException
Set a cookie for the current user. It will use the default expiry (never), and the default path ("/").

Parameters:
name - the name of the cookie to set
value - the value of the cookie
Returns:
true if the cookie is set successfully, false otherwise.
Throws:
FacebookException

data_setCookie

boolean data_setCookie(java.lang.String name,
                       java.lang.String value,
                       java.lang.String path)
                       throws FacebookException
Set a cookie for the current user, under the specified path. It will use the default expiry (never).

Parameters:
name - the name of the cookie to set
value - the value of the cookie
path - the path relative to the application's callback URL, with which the cookie should be associated. (default is "/")
Returns:
true if the cookie is set successfully, false otherwise.
Throws:
FacebookException

data_setCookie

boolean data_setCookie(java.lang.Long userId,
                       java.lang.CharSequence name,
                       java.lang.CharSequence value)
                       throws FacebookException
Set a cookie for the specified user. The cookie will use the default expiry (never) and the default path ("/").

Parameters:
userId - the id of the user to set the cookie for.
name - the name of the cookie to set
value - the value of the cookie
Returns:
true if the cookie is set successfully, false otherwise.
Throws:
FacebookException

data_setCookie

boolean data_setCookie(java.lang.Long userId,
                       java.lang.CharSequence name,
                       java.lang.CharSequence value,
                       java.lang.CharSequence path)
                       throws FacebookException
Set a cookie for the specified user, with the specified path. The cookie will use the default expiry (never).

Parameters:
userId - the id of the user to set the cookie for.
name - the name of the cookie to set
value - the value of the cookie
path - the path relative to the application's callback URL, with which the cookie should be associated. (default is "/")
Returns:
true if the cookie is set successfully, false otherwise.
Throws:
FacebookException

data_setCookie

boolean data_setCookie(java.lang.String name,
                       java.lang.String value,
                       java.lang.Long expires)
                       throws FacebookException
Set a cookie for the current user, with the specified expiration date. It will use the default path ("/").

Parameters:
name - the name of the cookie to set
value - the value of the cookie
expires - the timestamp at which the cookie expires
Returns:
true if the cookie is set successfully, false otherwise.
Throws:
FacebookException

data_setCookie

boolean data_setCookie(java.lang.String name,
                       java.lang.String value,
                       java.lang.Long expires,
                       java.lang.String path)
                       throws FacebookException
Set a cookie for the current user, with the specified expiration date and path.

Parameters:
name - the name of the cookie to set
value - the value of the cookie
expires - the timestamp at which the cookie expires
path - the path relative to the application's callback URL, with which the cookie should be associated. (default is "/")
Returns:
true if the cookie is set successfully, false otherwise.
Throws:
FacebookException

data_setCookie

boolean data_setCookie(java.lang.Long userId,
                       java.lang.CharSequence name,
                       java.lang.CharSequence value,
                       java.lang.Long expires)
                       throws FacebookException
Set a cookie for the specified user, with the specified expiration date. The cookie will use the default path ("/").

Parameters:
userId - the id of the user to set the cookie for.
name - the name of the cookie to set
value - the value of the cookie
expires - the timestamp at which the cookie expires
Returns:
true if the cookie is set successfully, false otherwise.
Throws:
FacebookException

data_setCookie

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
Set a cookie for the specified user, with the specified expiration date and path.

Parameters:
userId - the id of the user to set the cookie for.
name - the name of the cookie to set
value - the value of the cookie
expires - the timestamp at which the cookie expires
path - the path relative to the application's callback URL, with which the cookie should be associated. (default is "/")
Returns:
true if the cookie is set successfully, false otherwise.
Throws:
FacebookException

data_createObject

long data_createObject(java.lang.String objectType,
                       java.util.Map<java.lang.String,java.lang.String> properties)
                       throws FacebookException
Create object in Data Store

Parameters:
objectType - Specifies which type of new object to create.
properties - Optional - Name-value pairs of properties this new object has
Returns:
64-bit integer: Numeric identifier (fbid) of newly created object.
Throws:
FacebookException
See Also:
Developers Wiki: Data.createObject

data_updateObject

void data_updateObject(long objectId,
                       java.util.Map<java.lang.String,java.lang.String> properties,
                       boolean replace)
                       throws FacebookException
Update properties of an existing object in Data Store

Parameters:
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.
Throws:
FacebookException
See Also:
Developers Wiki: Data.updateObject

data_deleteObject

void data_deleteObject(long objectId)
                       throws FacebookException
Delete object in Data Store

Parameters:
objectId - Numeric identifier (fbid) of the object to delete.
Throws:
FacebookException
See Also:
data_deleteObjects(java.util.Collection), Developers Wiki: Data.deleteObject

data_deleteObjects

void data_deleteObjects(java.util.Collection<java.lang.Long> objectIds)
                        throws FacebookException
Delete multiple objects in Data Store WARNING: This method seems to fail when it comes across the first object that it can't find. It may be more reliable to iterate through your list of objects to delete and call deleteObject individually (although, of course, less efficient).

Parameters:
objectIds - A list of 64-bit integers that are numeric identifiers (fbids) of objects to delete.
Throws:
FacebookException
See Also:
data_deleteObject(long), Developers Wiki: Data.deleteObjects

data_getObject

T data_getObject(long objectId)
                 throws FacebookException
Throws:
FacebookException

data_getObjects

T data_getObjects(java.util.Collection<java.lang.Long> objectIds)
                  throws FacebookException
Throws:
FacebookException

data_getObjectProperty

T data_getObjectProperty(long objectId,
                         java.lang.String propertyName)
                         throws FacebookException
Throws:
FacebookException

data_setObjectProperty

void data_setObjectProperty(long objectId,
                            java.lang.String propertyName,
                            java.lang.String value)
                            throws FacebookException
Throws:
FacebookException

data_defineAssociation

void data_defineAssociation(java.lang.String associationName,
                            AssociationType associationType,
                            AssociationInfo associationInfo1,
                            AssociationInfo associationInfo2,
                            java.lang.String inverseName)
                            throws FacebookException
Parameters:
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.
Throws:
FacebookException
See Also:
Developers Wiki: Data.defineAssociation

data_undefineAssociation

void data_undefineAssociation(java.lang.String name)
                              throws FacebookException
Remove a previously defined association. This will also delete this type of associations established between objects. This deletion is not reversible.

Parameters:
name -
Throws:
FacebookException
See Also:
Developers Wiki: Data.undefineAssociation

data_renameAssociation

void data_renameAssociation(java.lang.String name,
                            java.lang.String newName,
                            java.lang.String newAlias1,
                            java.lang.String newAlias2)
                            throws FacebookException
Rename a previously defined association. Note that, any renaming here only affects one direction. To change names and aliases for another direction, rename with the name of that direction of association.

Parameters:
name -
newName -
newAlias1 -
newAlias2 -
Throws:
FacebookException
See Also:
Developers Wiki: Data.renameAssociation

data_getAssociationDefinition

T data_getAssociationDefinition(java.lang.String associationName)
                                throws FacebookException
Throws:
FacebookException

data_getAssociationDefinitions

T data_getAssociationDefinitions()
                                 throws FacebookException
Throws:
FacebookException

data_setAssociation

void data_setAssociation(java.lang.String associationName,
                         long object1Id,
                         long object2Id,
                         java.lang.String data,
                         java.util.Date associationTime)
                         throws FacebookException
Create an association between two objects

Parameters:
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). )
Throws:
FacebookException
See Also:
Developers Wiki: Data.setAssociation

data_removeAssociation

void data_removeAssociation(java.lang.String associationName,
                            long object1Id,
                            long object2Id)
                            throws FacebookException
Removes an association between two object identifiers. Note that, the order of these two identifiers matters, unless this is a symmetric two-way association.

Parameters:
associationName - Name of the association.
object1Id - Object identifier 1.
object2Id - Object identifier 2.
Throws:
FacebookException
See Also:
Developers Wiki: Data.removeAssociation

data_removeAssociatedObjects

void data_removeAssociatedObjects(java.lang.String associationName,
                                  long objectId)
                                  throws FacebookException
The name of this function may be misleading, but it actually removes associations between any other objects and a specified object. Those other associated objects will NOT be removed or deleted. Only the associations will be broken and deleted.

Parameters:
associationName - Name of the association.
objectId - Object identifier.
Throws:
FacebookException
See Also:
Developers Wiki: Data.removeAssociatedObjects

data_getAssociatedObjectCount

long data_getAssociatedObjectCount(java.lang.String associationName,
                                   long objectId)
                                   throws FacebookException
Returns count of object ids that are associated with specified object. This function takes constant time to return the count, regardless how many objects are associated.

Parameters:
associationName - Name of the association.
objectId - Object identifier.
Returns:
int64 object count
Throws:
FacebookException
See Also:
Developers Wiki: Data.getAssociatedObjectCount

admin_setAppProperties

boolean admin_setAppProperties(ApplicationPropertySet properties)
                               throws FacebookException
Sets several property values for an application. The properties available are analogous to the ones editable via the Facebook Developer application. A session is not required to use this method. This method cannot be called by desktop apps.

Parameters:
properties - an ApplicationPropertySet that is translated into a single JSON String.
Returns:
a boolean indicating whether the properties were successfully set
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Admin.setAppProperties

admin_getAppPropertiesAsSet

ApplicationPropertySet admin_getAppPropertiesAsSet(java.util.Collection<ApplicationProperty> properties)
                                                   throws FacebookException
Gets property values previously set for an application on either the Facebook Developer application or the with the admin.setAppProperties call. A session is not required to use this method. This method cannot be called by desktop apps.

Parameters:
properties - an enumeration of the properties to get
Returns:
an ApplicationPropertySet
Throws:
FacebookException
See Also:
ApplicationProperty, http://wiki.developers.facebook.com/index.php/Admin.getAppProperties

beginBatch

void beginBatch()
Starts a batch of queries. Any API calls made after invoking 'beginBatch' will be deferred until the next time you call 'executeBatch', at which time they will be processed as a batch query. All API calls made in the interim will return null as their result.


batch_run

T batch_run(java.lang.String methods,
            boolean serial)
            throws FacebookException
Executes a batch of queries. It is your responsibility to encode the method feed correctly. It is not recommended that you call this method directly. Instead use 'beginBatch' and 'executeBatch', which will take care of the hard parts for you.

Parameters:
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.
Returns:
a result containing the response to each individual query in the batch.
Throws:
FacebookException

executeBatch

java.util.List<? extends java.lang.Object> executeBatch(boolean serial)
                                                        throws FacebookException
Executes a batch of queries. You define the queries to execute by calling 'beginBatch' and then invoking the desired API methods that you want to execute as part of your batch as normal. Invoking this method will then execute the API calls you made in the interim as a single batch query.

Parameters:
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.
Returns:
a list containing the results of the batch execution. The list will be ordered such that the first element corresponds to the result of the first query in the batch, and the second element corresponds to the result of the second query, and so on. The types of the objects in the list will match the type normally returned by the API call being invoked (so calling users_getLoggedInUser as part of a batch will place a Long in the list, and calling friends_get will place a Document in the list, etc.). The list may be empty, it will never be null.
Throws:
FacebookException

application_getPublicInfo

T application_getPublicInfo(java.lang.Long applicationId,
                            java.lang.String applicationKey,
                            java.lang.String applicationCanvas)
                            throws FacebookException
Gets the public information about the specified application. Only one of the 3 parameters needs to be specified.

Parameters:
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.
Returns:
the public information for the specified application
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Application.getPublicInfo

application_getPublicInfoById

T application_getPublicInfoById(java.lang.Long applicationId)
                                throws FacebookException
Gets the public information about the specified application, by application id.

Parameters:
applicationId - the id of the application to get the info for.
Returns:
the public information for the specified application
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Application.getPublicInfo

application_getPublicInfoByApiKey

T application_getPublicInfoByApiKey(java.lang.String applicationKey)
                                    throws FacebookException
Gets the public information about the specified application, by API key.

Parameters:
applicationKey - the public API key of the application to get the info for.
Returns:
the public information for the specified application
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Application.getPublicInfo

application_getPublicInfoByCanvasName

T application_getPublicInfoByCanvasName(java.lang.String applicationCanvas)
                                        throws FacebookException
Gets the public information about the specified application, by canvas-page name.

Parameters:
applicationCanvas - the canvas-page name of the application to get the info for.
Returns:
the public information for the specified application
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Application.getPublicInfo

admin_getAllocation

int admin_getAllocation(java.lang.String allocationType)
                        throws FacebookException
Get your application's current allocation of the specified type of request (i.e. the number of requests that it is currently allowed to send per user per day).

Parameters:
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"
Returns:
the number of the specified type of requests that the application is permitted to send per user per day.
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Admin.getAllocation

admin_getAllocation

int admin_getAllocation(AllocationType allocationType)
                        throws FacebookException
Get your application's current allocation of the specified type of request (i.e. the number of requests that it is currently allowed to send per user per day).

Parameters:
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"
Returns:
the number of the specified type of requests that the application is permitted to send per user per day.
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Admin.getAllocation

admin_getAllocation

int admin_getAllocation(java.lang.String allocationType,
                        java.lang.Long userId)
                        throws FacebookException
Get your application's current allocation of the specified type of request (i.e. the number of requests that it is currently allowed to send per user per day).

Parameters:
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"
Returns:
the number of the specified type of requests that the application is permitted to send per user per day.
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Admin.getAllocation

admin_getAllocation

int admin_getAllocation(AllocationType allocationType,
                        java.lang.Long userId)
                        throws FacebookException
Get your application's current allocation of the specified type of request (i.e. the number of requests that it is currently allowed to send per user per day).

Parameters:
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"
Returns:
the number of the specified type of requests that the application is permitted to send per user per day.
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Admin.getAllocation

admin_getRequestAllocation

@Deprecated
int admin_getRequestAllocation()
                               throws FacebookException
Deprecated. 

Get your application's current allocation for invites/requests (i.e. the total number of invites/requests that it is allowed to send per user, per day).

Returns:
the number of invites/requests that the application is permitted to send per user per day.
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Admin.getAllocation

admin_getNotificationAllocation

@Deprecated
int admin_getNotificationAllocation()
                                    throws FacebookException
Deprecated. 

Get your application's current allocation for notifications (i.e. the total number of notifications that it is allowed to send per user, per day).

Returns:
the number of notifications that the application is permitted to send per user per day.
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Admin.getAllocation

admin_getDailyMetrics

@Deprecated
T admin_getDailyMetrics(java.util.Set<Metric> metrics,
                                   java.util.Date start,
                                   java.util.Date end)
                        throws FacebookException
Deprecated. 

Retrieve the daily metrics for the current application.

Parameters:
metrics - a set specifying the specific metrics to retrieve
start - 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)
Returns:
daily metrics for your app, for each day in the specified range
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Admin.getDailyMetrics

admin_getMetrics

T admin_getMetrics(java.util.Set<Metric> metrics,
                   java.util.Date start,
                   java.util.Date end,
                   long period)
                   throws FacebookException
Retrieve metrics for the current application.

Parameters:
metrics - a set specifying the specific metrics to retrieve
start - 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
Returns:
daily metrics for your app, for each day in the specified range
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Admin.getMetrics

admin_getDailyMetrics

@Deprecated
T admin_getDailyMetrics(java.util.Set<Metric> metrics,
                                   long start,
                                   long end)
                        throws FacebookException
Deprecated. 

Retrieve the daily metrics for the current application.

Parameters:
metrics - a set specifying the specific metrics to retrieve
start - the starting date to retrieve data for (range must not exceed 30 days), the accepted unit of time is milliseconds, NOT seconds
end - the ending to to retrive data for (range must not exceed 30 days), the accepted unit of time is milliseconds, NOT seconds
Returns:
daily metrics for your app, for each day in the specified range
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Admin.getDailyMetrics

admin_getMetrics

T admin_getMetrics(java.util.Set<Metric> metrics,
                   long start,
                   long end,
                   long period)
                   throws FacebookException
Retrieve the daily metrics for the current application.

Parameters:
metrics - a set specifying the specific metrics to retrieve
start - the starting date to retrieve data for (range must not exceed 30 days), the accepted unit of time is milliseconds, NOT seconds
end - the ending to to retrive data for (range must not exceed 30 days), the accepted unit of time is milliseconds, NOT seconds
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
Returns:
daily metrics for your app, for each day in the specified range
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Admin.getMetrics

permissions_grantApiAccess

boolean permissions_grantApiAccess(java.lang.String apiKey,
                                   java.util.Set<FacebookMethod> methods)
                                   throws FacebookException
Grant permission to an external app to make API calls on behalf of the current application.

Parameters:
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.
Returns:
true if the operation succeeds false otherwise
Throws:
FacebookException

permissions_grantFullApiAccess

boolean permissions_grantFullApiAccess(java.lang.String apiKey)
                                       throws FacebookException
Grant permission to an external app to make API calls on behalf of the current application. Access is granted to the full set of allowed API methods.

Parameters:
apiKey - the API-key of the application to grant permission to.
Returns:
true if the operation succeeds false otherwise
Throws:
FacebookException

permissions_checkAvailableApiAccess

T permissions_checkAvailableApiAccess(java.lang.String apiKey)
                                      throws FacebookException
Check to see what permissions have been granted to current app by the specified external application. For example: Application A grants permission on users.getInfo to Application B, Applicatio B can then call permissions_checkAvailableApiAccess(A) and will recieve "users.getInfo" as a result.

Parameters:
apiKey - the API key of the application to check for permissions from.
Returns:
a list of all API methods that the specified application has permission to use.
Throws:
FacebookException

permissions_revokeApiAccess

boolean permissions_revokeApiAccess(java.lang.String apiKey)
                                    throws FacebookException
Revokes the specified application's permission to call API methods on behalf of the current app.

Parameters:
apiKey - the API key of the application to remove permissions for.
Returns:
true if the operation succeeds false otherwise
Throws:
FacebookException

permissions_checkGrantedApiAccess

T permissions_checkGrantedApiAccess(java.lang.String apiKey)
                                    throws FacebookException
Check to see what permissions have been granted to specified external application by the current application. For example: Application A grants permission on users.getInfo to Application B, Applicatio A can then call permissions_checkGrantedApiAccess(B) and will recieve "users.getInfo" as a result.

Parameters:
apiKey - the API key of the application to check permissions for.
Returns:
a list of all API methods that the specified application has permission to use.
Throws:
FacebookException

auth_expireSession

boolean auth_expireSession()
                           throws FacebookException
Expires the curently active session.

Returns:
true if the call succeeds false otherwise
Throws:
FacebookException

auth_revokeAuthorization

boolean auth_revokeAuthorization()
                                 throws FacebookException
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.

Returns:
true if the call succeeds false otherwise
Throws:
FacebookException

auth_revokeExtendedPermission

boolean auth_revokeExtendedPermission(Permission perm)
                                      throws FacebookException
Throws:
FacebookException
See Also:
auth_revokeExtendedPermission(Permission, Long), http://wiki.developers.facebook.com/index.php/Auth.revokeExtendedPermission

auth_revokeExtendedPermission

boolean auth_revokeExtendedPermission(Permission perm,
                                      java.lang.Long userId)
                                      throws FacebookException
Revokes the specified extended permission for the selected user. If no user is specified, then the user of the current session is used.

Parameters:
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.
Returns:
This method returns true upon success.
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Auth.revokeExtendedPermission

beginPermissionsMode

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. This method must be invoked prior to making an API request on behalf of another application. When you are done, be sure to call endPermissionsMode().

Parameters:
apiKey - the API key of the application to being making requests for.

endPermissionsMode

void endPermissionsMode()
Terminates permissions mode. After calling this, the current application will be unable to make requests on behalf of another app, until beginPermissionsMode is called again.


auth_promoteSession

java.lang.String auth_promoteSession()
                                     throws FacebookException
Generate a key for the current session that can be used to authenticate client-side components.

Returns:
the key.
Throws:
FacebookException

feed_registerTemplateBundle

@Deprecated
java.lang.Long feed_registerTemplateBundle(java.lang.String template)
                                           throws FacebookException
Deprecated. 

Registers a feed template. See: http://wiki.developers.facebook.com/index.php/Feed.registerTemplateBundle

Parameters:
template - the template to store
Returns:
the id which Facebook assigns to your template
Throws:
FacebookException

feed_registerTemplateBundle

@Deprecated
java.lang.Long feed_registerTemplateBundle(java.util.Collection<java.lang.String> templates)
                                           throws FacebookException
Deprecated. 

Registers a feed template. See: http://wiki.developers.facebook.com/index.php/Feed.registerTemplateBundle

Parameters:
templates - the templates to store
Returns:
the id which Facebook assigns to your template
Throws:
FacebookException

feed_registerTemplateBundle

@Deprecated
java.lang.Long feed_registerTemplateBundle(java.lang.String template,
                                                      java.lang.String shortTemplate,
                                                      java.lang.String longTemplate)
                                           throws FacebookException
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.

Registers a feed template. See: http://wiki.developers.facebook.com/index.php/Feed.registerTemplateBundle

Parameters:
template - the template to store.
shortTemplate - the short template to store.
longTemplate - the long template to store.
Returns:
the id which Facebook assigns to your template
Throws:
FacebookException

feed_registerTemplateBundle

@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
Deprecated. 

Registers a feed template. See: http://wiki.developers.facebook.com/index.php/Feed.registerTemplateBundle

Parameters:
template - the template to store.
shortTemplate - the short template to store.
longTemplate - the long template to store.
actionLinks - the action links to store
Returns:
the id which Facebook assigns to your template
Throws:
FacebookException

feed_registerTemplateBundle

@Deprecated
java.lang.Long feed_registerTemplateBundle(java.util.Collection<java.lang.String> templates,
                                                      java.util.Collection<BundleStoryTemplate> shortTemplates,
                                                      BundleStoryTemplate longTemplate)
                                           throws FacebookException
Deprecated. 

Registers a feed template. See: http://wiki.developers.facebook.com/index.php/Feed.registerTemplateBundle

Parameters:
template - the template to store.
shortTemplate - the short template to store.
longTemplate - the long template to store.
Returns:
the id which Facebook assigns to your template
Throws:
FacebookException

feed_getRegisteredTemplateBundles

@Deprecated
T feed_getRegisteredTemplateBundles()
                                    throws FacebookException
Deprecated. 

Get a list of all registered template bundles for your application.

Returns:
a list describing all registered feed templates.
Throws:
FacebookException

feed_getRegisteredTemplateBundleByID

@Deprecated
T feed_getRegisteredTemplateBundleByID(java.lang.Long id)
                                       throws FacebookException
Deprecated. 

Retrieve a template bundle by id.

Parameters:
id - the id to retrieve.
Returns:
the specified template bundle definition.
Throws:
FacebookException

feed_publishUserAction

@Deprecated
java.lang.Boolean feed_publishUserAction(java.lang.Long bundleId)
                                         throws FacebookException
Deprecated. 

Publishes a user action to the feed. See: http://wiki.developers.facebook.com/index.php/Feed.publishUserAction

Parameters:
bundleId - the template bundle-id to use to render the feed.
Returns:
true if the call succeeds false otherwise
Throws:
FacebookException

feed_publishUserAction

@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
Deprecated. 

Publishes a user action to the feed. See: http://wiki.developers.facebook.com/index.php/Feed.publishUserAction

Parameters:
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.
Returns:
true if the call succeeds false otherwise
Throws:
FacebookException

profile_getInfo

@Deprecated
T profile_getInfo(java.lang.Long userId)
                  throws FacebookException
Deprecated. 

Get the specified user's application-info section.

Parameters:
userId - the id of the user to get the info section for.
Returns:
the user's application-info section.
Throws:
FacebookException

profile_getInfoOptions

@Deprecated
T profile_getInfoOptions(java.lang.String field)
                         throws FacebookException
Deprecated. 

Get the options associated with the specified field for an application info section.

Parameters:
field - the field to get the options for.
Returns:
the options associated with the specified field for an application info section.
Throws:
FacebookException

profile_setInfo

@Deprecated
void profile_setInfo(java.lang.Long userId,
                                java.lang.String title,
                                boolean textOnly,
                                java.util.List<ProfileInfoField> fields)
                     throws FacebookException
Deprecated. 

Configures an application info section that the specified user can install on the Info tab of her profile. See: http://wiki.developers.facebook.com/index.php/Profile.setInfo

Parameters:
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.
Throws:
FacebookException

profile_setInfoOptions

@Deprecated
void profile_setInfoOptions(ProfileInfoField field)
                            throws FacebookException
Deprecated. 

Specifies the objects for a field for an application info section. These options populate the typeahead for a thumbnail. See: http://wiki.developers.facebook.com/index.php/Profile.setInfoOptions

Parameters:
field - the field to set.
Throws:
FacebookException

photos_addTags

T photos_addTags(java.lang.String photoId,
                 java.util.Collection<PhotoTag> tags,
                 java.lang.Long userId)
                 throws FacebookException
Adds several tags to a photo.

Parameters:
photoId - The photo id of the photo to be tagged.
tags - A list of PhotoTags.
userId - the id of the user adding the tags.
Returns:
a list of booleans indicating whether the tag was successfully added.
Throws:
FacebookException

liveMessage_send

java.lang.Boolean liveMessage_send(java.lang.Long recipient,
                                   java.lang.String eventName,
                                   org.json.JSONObject message)
                                   throws FacebookException
Sends a message using the LiveMessage API. Note that for the message to be recieved by the recipent, you must set up a FBJS handler function. See http://wiki.developers.facebook.com/index.php/LiveMessage for details.

Parameters:
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.
Returns:
true if the message is sent, false otherwise
Throws:
FacebookException

notifications_send

@Deprecated
java.util.Collection<java.lang.String> notifications_send(java.util.Collection<java.lang.Long> recipientIds,
                                                                     java.lang.String notification,
                                                                     boolean isAppToUser)
                                                          throws FacebookException
Deprecated. 

Sends a notification.

Parameters:
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.
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Notifications.send

feed_deactivateTemplateBundleByID

@Deprecated
boolean feed_deactivateTemplateBundleByID(java.lang.Long bundleId)
                                          throws FacebookException
Deprecated. 

Deactivates the specified template bundle.

Parameters:
bundleId - the id of the bundle to deactivate.
Returns:
true if the call succeeds, false otherwise.
Throws:
FacebookException

feed_publishUserAction

@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
Deprecated. 

Publishes a user action to the feed. See: http://wiki.developers.facebook.com/index.php/Feed.publishUserAction

Parameters:
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 entry
targetIds - 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.
Returns:
true if the call succeeds false otherwise
Throws:
FacebookException

links_post

java.lang.Long links_post(java.lang.Long userId,
                          java.lang.String url,
                          java.lang.String comment)
                          throws FacebookException
Posts a link to the specified user's Wall. The user must have previously given the calling application the "share_item" extended permission.

Parameters:
userId - the user ID
url - the URL to link to
comment - the user-generated comment about the URL
Returns:
the unique ID of the newly posted link entity
Throws:
FacebookException

events_get

T events_get(java.lang.Long userId,
             java.util.Collection<java.lang.Long> eventIds,
             java.lang.Long startTime,
             java.lang.Long endTime)
             throws FacebookException
Returns all visible events according to the filters specified.

Parameters:
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.
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Events.get

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
Returns all visible events according to the filters specified.

Parameters:
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
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Events.get

events_getMembers

T events_getMembers(java.lang.Long eventId)
                    throws FacebookException
Retrieves the membership list of an event

Parameters:
eventId - The event ID.
Returns:
T consisting of four membership lists corresponding to RSVP status, with keys 'attending', 'unsure', 'declined', and 'not_replied'
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Events.getMembers

events_create

java.lang.Long events_create(java.util.Map<java.lang.String,java.lang.String> event_info)
                             throws FacebookException
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.

Parameters:
event_info - The event information. You must pass the following parameters:
  • name
  • category
  • subcategory
  • host
  • location
  • city
  • start_time (seconds since epoch)
  • end_time (seconds since epoch)
Optionally, you can pass the following parameters in the event_info array:
  • street
  • phone
  • email
  • page_id
  • description
  • privacy_type
  • tagline
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Events.create

events_edit

boolean events_edit(java.lang.Long eid,
                    java.util.Map<java.lang.String,java.lang.String> event_info)
                    throws FacebookException
Edits the details of an existing event. The application must be an admin of the event. An application is the admin of an event if the application created the event on behalf of a user (with that user's active session) or if it is the creator of the event itself (that is, the event was created without an active user session).

Parameters:
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:
  • category
  • subcategory
  • host
  • location
  • start_time (seconds since epoch)
  • end_time (seconds since epoch)
  • street
  • phone
  • email
  • host_id
  • description
  • privacy_type
  • tagline
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Events.edit

events_cancel

boolean events_cancel(java.lang.Long eid,
                      java.lang.String cancel_message)
                      throws FacebookException
Cancels an event. The application must be an admin of the event. An application is the admin of an event if the application created the event on behalf of a user (with that user's active session) or if it is the creator of the event itself (that is, the event was created without an active user session).

Parameters:
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.
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Events.cancel

events_rsvp

boolean events_rsvp(java.lang.Long eid,
                    java.lang.String rsvp_status)
                    throws FacebookException
Sets a user's RSVP status for an event. An application can set a user's RSVP status only if the following are all true:

Parameters:
eid - The event ID.
rsvp_status - The user's RSVP status. Specify attending, unsure, or declined.
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Events.rsvp

sms_canSend

boolean sms_canSend()
                    throws FacebookException
Check to see if the application is permitted to send SMS messages to the current application user.

Returns:
true if the application is presently able to send SMS messages to the current user false otherwise
Throws:
FacebookException - if an error happens when executing the API call.

sms_canSend

boolean sms_canSend(java.lang.Long userId)
                    throws FacebookException
Check to see if the application is permitted to send SMS messages to the specified user.

Parameters:
userId - the UID of the user to check permissions for
Returns:
true if the application is presently able to send SMS messages to the specified user false otherwise
Throws:
FacebookException - if an error happens when executing the API call.

sms_send

java.lang.Integer sms_send(java.lang.String message,
                           java.lang.Integer smsSessionId,
                           boolean makeNewSession)
                           throws FacebookException
Send an SMS message to the current application user.

Parameters:
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.
Returns:
an integer specifying the value of the session id alocated by Facebook, if one was requested. If a new session id was not requested, this method will return null.
Throws:
FacebookException - if an error happens when executing the API call.

sms_send

java.lang.Integer sms_send(java.lang.Long userId,
                           java.lang.String message,
                           java.lang.Integer smsSessionId,
                           boolean makeNewSession)
                           throws FacebookException
Send an SMS message to the specified user.

Parameters:
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.
Returns:
an integer specifying the value of the session id alocated by Facebook, if one was requested. If a new session id was not requested, this method will return null.
Throws:
FacebookException - if an error happens when executing the API call.

sms_sendMessageWithSession

int sms_sendMessageWithSession(java.lang.Long userId,
                               java.lang.CharSequence message)
                               throws FacebookException
Sends a message via SMS to the user identified by 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.

Parameters:
userId - a user ID
message - the message to be sent via SMS
Returns:
a mobile session ID (can be used in #sms_sendResponse)
Throws:
FacebookException - in case of error, e.g. SMS is not enabled
See Also:
FacebookExtendedPerm.SMS, Developers Wiki: Mobile: Application Generated Messages, Developers Wiki: Mobile: Workflow

sms_sendMessage

void sms_sendMessage(java.lang.Long userId,
                     java.lang.CharSequence message)
                     throws FacebookException
Sends a message via SMS to the user identified by userId. The SMS extended permission is required for success.

Parameters:
userId - a user ID
message - the message to be sent via SMS
Throws:
FacebookException - in case of error
See Also:
FacebookExtendedPerm.SMS, Developers Wiki: Mobile: Application Generated Messages, Developers Wiki: Mobile: Workflow

connect_registerUsers

T connect_registerUsers(java.util.Collection<java.util.Map<java.lang.String,java.lang.String>> accounts)
                        throws FacebookException
This method is used to create an association between an external user account and a Facebook user account. This method takes an array of account data, including a required email_hash and optional account data. For each connected account, if the user exists, the information is added to the set of the user's connected accounts. If the user has already authorized the site, the connected account is added in the confirmed state. If the user has not yet authorized the site, the connected account is added in the pending state.

Parameters:
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:
  • email_hash: The public email hash of remote account. This property is required. Compute the email_hash property as follows:
    1. Normalize the email address. Trim leading and trailing whitespace, and convert all characters to lowercase.
    2. Compute the CRC32 value for the normalized email address and use the unsigned integer representation of this value. (Note that some implementations return signed integers, in which case you will need to convert that result to an unsigned integer.)
    3. Compute the MD5 value for the normalized email address and use the hex representation of this value (using lowercase for A through F).
    4. Combine these two value with an underscore.
    For example, the address mary@example.com converts to 4228600737_c96da02bba97aedfd26136e980ae3761.
  • account_id: The user's account ID on the Facebook Connect site. This property is optional. If you specify the account_id property, then you must also set a Connect Preview URL in your application's settings in order to generate a full user URL. The Connect Preview URL contains an account_id parameter, such as http://www.example.com/profile.php?user=account_id.
  • account_url: The URL to the user's account on the Facebook Connect site. This property is optional. If you specify the account_url property, that URL will be used directly.
Facebook recommends that you specify at least one of either the account_id or the account_url properties.
Returns:
This method returns an array of email hashes that have been successfully registered. If any email hashes are missing, we recommend that you try registering them again later.
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Connect.registerUsers

connect_unregisterUsers

T connect_unregisterUsers(java.util.Collection<java.lang.String> email_hashes)
                          throws FacebookException
This method allows a site to unregister a previously registered account (using connect.registerUsers). You should call this method if the user deletes his account on your site.

Parameters:
email_hashes - An array of email_hashes to unregister.
Returns:
This method returns an array of unregistered email hashes. If any email hashes are missing, we recommend that you try unregistering the account again later.
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Connect.unregisterUsers

connect_getUnconnectedFriendsCount

int connect_getUnconnectedFriendsCount()
                                       throws FacebookException
This method returns the number of friends of the current user who have accounts on your site, but have not yet connected their accounts. Also see fb:unconnected-friends-count. You can use the response from this call to determine whether or not to display a link allowing the user to invite their friends to connect as well.

Returns:
This method returns an int that indicates the number of users who have not yet connected their accounts.
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Connect.getUnconnectedFriendsCount

fbml_deleteCustomTags

void fbml_deleteCustomTags(java.util.Collection<java.lang.String> names)
                           throws FacebookException
Deletes one or more custom tags you previously registered for the calling application with fbml.registerCustomTags. Important! Use this method with extreme care, especially with public tags. Don't delete tags that may be in use, especially by other applications! This will break FBML pages that use those tags.

Parameters:
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.
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Fbml.deleteCustomTags

fbml_getCustomTags

T fbml_getCustomTags(java.lang.String appId)
                     throws FacebookException
Returns the custom tag definitions for tags that were previously defined using fbml.registerCustomTags.

Parameters:
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.).
Throws:
FacebookException
See Also:
http://wiki.developers.facebook.com/index.php/Fbml.getCustomTags

fbml_registerCustomTags

void fbml_registerCustomTags(java.util.Collection<org.json.JSONObject> tags)
                             throws FacebookException
Registers custom tags you can include in your that applications' FBML markup. Custom tags consist of FBML snippets that are rendered during parse time on the containing page that references the custom tag. Custom tags can be either private or public. For more information, see Custom Tags. When you register public custom tags, you should add the source code for the tags to the Custom Tags Directory. To use these custom tags in an FBML snippet, you must define a namespace with the fb:fbml tag. This imports an application's custom tags into an FBML namespace. See fb:fbml for more information on how to use custom tags. Please go to the Facebook Wiki Page for full documentation!!: http://wiki.developers.facebook.com/index.php/Fbml.registerCustomTags

Parameters:
tags - a JSON-encoded list of tag objects. Each tag object is an object with the following properties:
  • name (required) (string): the name of the tag. The name must be a string up to 30 characters. Only letters, numbers, underscores ('_') and hyphens ('-') are allowed.
  • type (optional) (string): Specify either leaf or container. Leaf tags can't contain any other tags (similar to ). Container tags may contain children between their open and close tags (like ). (Default value is leaf.).
  • description (optional) (string): A full description of the tag's functionality. This is used for documentation only, and is especially useful for public tags.
  • is_public (optional) (string): Specify either true or false. Specifying true indicates that other applications can use this tag. You can have a mix of public and private tags within the same array. (Default value is false.).
  • attributes (optional) (mixed): A list of attribute objects. Attributes are used to add dynamic elements to tags. The values of those attributes are substituted into the tag's FBML before it's parsed. Each attribute has the following fields:
    • o name (required) (string): The attribute's name. The name must be a string up to 30 characters in length. Only letters, numbers, underscores ('_') and hyphens ('-') are allowed.
    • o description (optional) (string): The attribute's description. This is used for documentation only, and is especially useful for public tags.
    • o default_value (optional) (string): The value to use when the attribute is missing. If an attribute doesn't have a default value, it is considered to be required and the developer will see an error message if the attribute is missing.
  • fbml (required) (string): The FBML markup to substitute into the page where the tag is encountered. This property is required only for leaf tags.
  • open_tag_fbml (required) (string): The FBML markup to substitute into the page where the open tag appears. This property is required for container tags only.
  • close_tag_fbml (required) (string): The FBML markup to substitute into the page where the close tag appears. This property is required for container tags only. Note: Facebook recommends you do not include SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD
    Copyright © 2010. All Rights Reserved.