|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
public interface IFacebookRestClient<T>
Generic interface for a FacebookRestClient, parameterized by output format. For continually updated documentation, please refer to the Developer Wiki.
| Field Summary | |
|---|---|
static java.lang.String |
ERROR_TAG
|
static java.lang.String |
FB_SERVER
|
static java.lang.String |
HTTPS_SERVER_ADDR
|
static java.lang.String |
SERVER_ADDR
|
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(java.lang.String allocationType)
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.EnumSet<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. |
long |
auth_getUserId(java.lang.String authToken)
Deprecated. |
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. |
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. |
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. |
java.lang.String |
data_getUserPreference(java.lang.Integer prefId)
Lookup a single preference value for the current user. |
java.util.Map<java.lang.Integer,java.lang.String> |
data_getUserPreferences()
Get a map containing all preference values set for the current user. |
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_setUserPreference(java.lang.Integer 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 |
endPermissionsMode()
Terminates permissions mode. |
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_getMembers(java.lang.Number eventId)
Retrieves the membership list of an event |
java.util.List<? extends java.lang.Object> |
executeBatch(boolean serial)
Executes a batch of queries. |
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. |
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)
Deactivates the specified template bundle. |
T |
feed_getRegisteredTemplateBundleByID(java.lang.Long id)
Retrieve a template bundle by id. |
T |
feed_getRegisteredTemplateBundles()
Get a list of all registered template bundles for your application. |
boolean |
feed_publishTemplatizedAction(java.lang.CharSequence titleTemplate)
Publishes a Mini-Feed story describing an action taken by the logged-in user, and publishes aggregating News Feed stories to their friends. |
boolean |
feed_publishTemplatizedAction(java.lang.CharSequence titleTemplate,
java.lang.Long pageActorId)
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. |
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)
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. |
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)
Publishes a Mini-Feed story describing an action taken by a user, and publishes aggregating News Feed stories to the friends of that user. |
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)
Publishes a templatized action for the current user. |
boolean |
feed_PublishTemplatizedAction(TemplatizedAction action)
Publishes a templatized action for the current user. |
java.lang.Boolean |
feed_publishUserAction(java.lang.Long bundleId)
Publishes a user action to the feed. |
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)
Publishes a user action to the feed. |
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)
Publishes a user action to the feed. |
java.lang.Long |
feed_registerTemplateBundle(java.util.Collection<java.lang.String> templates)
Registers a feed template. |
java.lang.Long |
feed_registerTemplateBundle(java.util.Collection<java.lang.String> templates,
java.util.Collection<BundleStoryTemplate> shortTemplates,
BundleStoryTemplate longTemplate)
Registers a feed template. |
java.lang.Long |
feed_registerTemplateBundle(java.lang.String template)
Registers a feed template. |
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 friendListId)
Retrieves the friends of the currently logged in user that are members of the friends list with ID friendListId. |
T |
friends_getAppUsers()
Retrieves the friends of the currently logged in user, who are also users of the calling application. |
T |
friends_getLists()
Retrieves the friend lists of the currently logged in user. |
java.lang.Boolean |
getCacheAppAdded()
|
T |
getCacheFriendsList()
|
java.lang.Long |
getCacheSessionExpires()
|
java.lang.String |
getCacheSessionKey()
|
java.lang.String |
getCacheSessionSecret()
|
java.lang.Long |
getCacheUserId()
|
java.net.URL |
getDefaultServerUrl()
|
javax.xml.bind.JAXBContext |
getJaxbContext()
Get the JAXB context that is being used by the client. |
java.lang.String |
getRawResponse()
Returns a string representation for the last API response recieved from Facebook, exactly as sent by the API server. |
java.lang.Object |
getResponsePOJO()
Returns a JAXB object of the type that corresponds to the last API call made on the client. |
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 |
boolean |
isDesktop()
Check to see if the client is running in desktop-app mode |
java.lang.Boolean |
liveMessage_send(java.lang.Long recipient,
java.lang.String eventName,
org.json.JSONObject message)
Sends a message using the LiveMessage API. |
java.lang.Long |
marketplace_createListing(boolean showOnProfile,
MarketListing listing)
Create a new marketplace listing. |
java.lang.Long |
marketplace_createListing(boolean showOnProfile,
MarketListing listing,
java.lang.Long userId)
Create a new marketplace listing. |
java.lang.Long |
marketplace_createListing(java.lang.Boolean showOnProfile,
MarketplaceListing attrs)
Deprecated. provided for legacy support only. Please use the version that takes a MarketListing instead. |
java.lang.Long |
marketplace_createListing(java.lang.Long listingId,
boolean showOnProfile,
MarketListing listing)
Create a new marketplace listing, or modify an existing one. |
java.lang.Long |
marketplace_createListing(java.lang.Long listingId,
boolean showOnProfile,
MarketListing listing,
java.lang.Long userId)
Create a new marketplace listing, or modify an existing one. |
java.lang.Long |
marketplace_createListing(java.lang.Long listingId,
boolean showOnProfile,
java.lang.String attributes)
Create a new marketplace listing, or modify an existing one. |
java.lang.Long |
marketplace_createListing(java.lang.Long listingId,
boolean showOnProfile,
java.lang.String attributes,
java.lang.Long userId)
Create a new marketplace listing, or modify an existing one. |
java.lang.Long |
marketplace_editListing(java.lang.Long listingId,
java.lang.Boolean showOnProfile,
MarketListing attrs)
Modify a marketplace listing |
java.lang.Long |
marketplace_editListing(java.lang.Long listingId,
java.lang.Boolean showOnProfile,
MarketplaceListing attrs)
Deprecated. provided for legacy support only. Please use the version that takes a MarketListing instead. |
java.util.List<java.lang.String> |
marketplace_getCategories()
Get the categories available in marketplace. |
T |
marketplace_getCategoriesObject()
Deprecated. use the version that returns a List |
T |
marketplace_getListings(java.util.Collection<java.lang.Long> listingIds,
java.util.Collection<java.lang.Long> userIds)
Fetch marketplace listings, filtered by listing IDs and/or the posting users' IDs. |
java.util.List<Listing> |
marketplace_getListings(java.util.List<java.lang.Long> listingIds,
java.util.List<java.lang.Long> uids)
Retrieve listings from the marketplace. |
java.util.List<java.lang.String> |
marketplace_getSubCategories()
Return a list of all valid Marketplace subcategories. |
T |
marketplace_getSubCategories(java.lang.CharSequence category)
Get the subcategories available for a category. |
boolean |
marketplace_removeListing(java.lang.Long listingId)
Remove a marketplace listing. |
boolean |
marketplace_removeListing(java.lang.Long listingId,
java.lang.CharSequence status)
Deprecated. provided for legacy support only. Please use the version that takes a MarketListingStatus instead. |
boolean |
marketplace_removeListing(java.lang.Long listingId,
java.lang.Long userId)
Remove a marketplace listing. |
boolean |
marketplace_removeListing(java.lang.Long listingId,
MarketListingStatus status)
Remove a listing from the marketplace by id. |
boolean |
marketplace_removeListing(java.lang.Long listingId,
MarketListingStatus status,
java.lang.Long userId)
Remove a listing from the marketplace by id. |
T |
marketplace_search(java.lang.CharSequence category,
java.lang.CharSequence subCategory,
java.lang.CharSequence query)
Deprecated. provided for legacy support only. Please use the alternate version instead. |
java.util.List<Listing> |
marketplace_search(MarketListingCategory category,
MarketListingSubcategory subcategory,
java.lang.String searchTerm)
Search the marketplace listings by category, subcategory, and keyword. |
T |
notifications_get()
Retrieves the outstanding notifications for the session user. |
void |
notifications_send(java.lang.CharSequence notification)
Send a notification message to the logged-in user. |
void |
notifications_send(java.util.Collection<java.lang.Long> recipientIds,
java.lang.CharSequence notification)
Send a notification message to the specified users. |
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. |
void |
notifications_send(java.util.Collection<java.lang.Long> recipientIds,
java.lang.String notification,
boolean isAppToUser)
Sends a notification. |
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. |
T |
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. |
T |
notifications_sendEmailToCurrentUser(java.lang.String subject,
java.lang.String email,
java.lang.String fbml)
Send an e-mail to the currently logged-in user. |
T |
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. |
T |
notifications_sendFbmlEmailToCurrentUser(java.lang.String subject,
java.lang.String fbml)
Send an e-mail to the currently logged-in user. |
T |
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. |
T |
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.EnumSet<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.EnumSet<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. |
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.Long photoId,
java.lang.CharSequence tagText,
java.lang.Double xPct,
java.lang.Double yPct)
Adds a tag to a photo. |
boolean |
photos_addTag(java.lang.Long 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.Long photoId,
java.lang.Long taggedUserId,
java.lang.Double xPct,
java.lang.Double yPct)
Adds a tag to a photo. |
boolean |
photos_addTag(java.lang.Long 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.Long photoId,
java.util.Collection<PhotoTag> tags)
Adds several tags to a photo. |
T |
photos_addTags(java.lang.Long 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.Long> 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.Long> 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.Long 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.Long albumId,
java.util.Collection<java.lang.Long> 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.Long> 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.Long> albumIds)
Retrieves album metadata. |
T |
photos_getByAlbum(java.lang.Long albumId)
Used to retrieve photo objects using the search parameters (one or more of the parameters must be provided). |
T |
photos_getByAlbum(java.lang.Long albumId,
java.util.Collection<java.lang.Long> 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.Long> 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.Long albumId)
Uploads a photo to Facebook. |
T |
photos_upload(java.io.File photo,
java.lang.String caption)
Uploads a photo to Facebook. |
T |
photos_upload(java.io.File photo,
java.lang.String caption,
java.lang.Long 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.Long albumId)
Uploads a photo to Facebook. |
T |
photos_upload(java.lang.Long userId,
java.io.File photo,
java.lang.String caption)
Uploads a photo to Facebook. |
T |
photos_upload(java.lang.Long userId,
java.io.File photo,
java.lang.String caption,
java.lang.Long albumId)
Uploads a photo to Facebook. |
T |
profile_getFBML()
Gets the FBML for the current user's profile box. |
T |
profile_getFBML(int type)
Gets the FBML for the current user's profile boxes. |
T |
profile_getFBML(int type,
java.lang.Long userId)
Gets the FBML for the user's profile boxes. |
T |
profile_getFBML(java.lang.Long userId)
Gets the FBML for the user's profile box. |
T |
profile_getInfo(java.lang.Long userId)
Get the specified user's application-info section. |
T |
profile_getInfoOptions(java.lang.String field)
Get the options associated with the specified field for an application info section. |
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)
Sets the FBML for a user's profile, including the content for both the profile box and the profile actions. |
void |
profile_setInfo(java.lang.Long userId,
java.lang.String title,
boolean textOnly,
java.util.List<ProfileInfoField> fields)
Configures an application info section that the specified user can install on the Info tab of her profile. |
void |
profile_setInfoOptions(ProfileInfoField field)
Specifies the objects for a field for an application info section. |
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 |
setCacheAppAdded(java.lang.Boolean appAdded)
|
void |
setCacheFriendsList(java.util.List<java.lang.Long> friendIds)
|
void |
setCacheSession(java.lang.String cacheSessionKey,
java.lang.Long cacheUserId,
java.lang.Long cacheSessionExpires)
|
void |
setDefaultServerUrl(java.net.URL url)
|
void |
setIsDesktop(boolean isDesktop)
Set the client to run in desktop-app mode. |
void |
setJaxbContext(javax.xml.bind.JAXBContext context)
Set the JAXB context that the client will use. |
void |
setServerUrl(java.lang.String 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. |
boolean |
users_clearStatus()
Clears the logged-in user's Facebook status. |
T |
users_getInfo(java.util.Collection<java.lang.Long> userIds,
java.util.Collection<ProfileField> fields)
Retrieves the requested info fields for the requested set of users. |
T |
users_getInfo(java.util.Collection<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_isAppAdded()
Deprecated. |
boolean |
users_isAppAdded(java.lang.Long userId)
Deprecated. |
boolean |
users_isAppUser()
|
boolean |
users_isAppUser(java.lang.Long userId)
Returns whether the user (either the session user or user specified by uid) has authorized the calling application. |
boolean |
users_setStatus(java.lang.String status)
Sets the logged-in user's Facebook status. |
boolean |
users_setStatus(java.lang.String newStatus,
boolean clear)
Set the user's profile status message. |
boolean |
users_setStatus(java.lang.String newStatus,
boolean clear,
boolean statusIncludesVerb)
Set the user's profile status message. |
boolean |
users_setStatus(java.lang.String newStatus,
boolean clear,
boolean statusIncludesVerb,
java.lang.Long userId)
Set the user's profile status message. |
boolean |
users_setStatus(java.lang.String newStatus,
boolean clear,
java.lang.Long userId)
Set the user's profile status message. |
boolean |
users_setStatus(java.lang.String status,
java.lang.Long userId)
Sets the spedified user's Facebook status. |
| Field Detail |
|---|
static final java.lang.String TARGET_API_VERSION
static final java.lang.String ERROR_TAG
static final java.lang.String FB_SERVER
static final java.lang.String SERVER_ADDR
static final java.lang.String HTTPS_SERVER_ADDR
| Method Detail |
|---|
boolean isDesktop()
void setIsDesktop(boolean isDesktop)
isDesktop - set to true to enable desktop mode set to false to disable desktop modeT getCacheFriendsList()
void setCacheFriendsList(java.util.List<java.lang.Long> friendIds)
java.lang.Boolean getCacheAppAdded()
void setCacheAppAdded(java.lang.Boolean appAdded)
void setCacheSession(java.lang.String cacheSessionKey,
java.lang.Long cacheUserId,
java.lang.Long cacheSessionExpires)
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,
java.io.IOException
userId - The user ID for the user whose profile you are updating, or the page ID in case of a Page. If this parameter is not specified, then it defaults to the
session user. Note: This parameter applies only to Web applications and is required by them only if the session_key is not specified. Facebook returns
an error if this parameter is passed by a desktop application.profileFbml - The FBML intended for the application profile box that appears on the Boxes tab on the user's profile.actionFbml - The FBML intended for the user's profile actions. A profile action is the link under the user's profile picture that allows a user to take an action
with your application. Note: This attribute is being deprecated when the new profile design launches in July 2008, as there are no third party profile
action links on the new profile.mobileFbml - The FBML intended for mobile devices.profileMain - The FBML intended for the narrow profile box on the Wall and Info tabs of the user's profile. Note: This attribute applies only to the new profile
design that launched July 2008.
FacebookException
java.io.IOException
@Deprecated
boolean profile_setFBML(java.lang.Long userId,
java.lang.String profileFbml,
java.lang.String actionFbml,
java.lang.String mobileFbml)
throws FacebookException,
java.io.IOException
profile_setFBML(Long, String, String, String, String)
FacebookException
java.io.IOExceptionprofile_setFBML(Long, String, String, String, String)
@Deprecated
boolean profile_setProfileFBML(java.lang.CharSequence fbmlMarkup)
throws FacebookException,
java.io.IOException
profile_setFBML(Long, String, String, String, String)
fbmlMarkup - refer to the FBML documentation for a description of the markup and its role in various contexts
FacebookException
java.io.IOException
@Deprecated
boolean profile_setProfileActionFBML(java.lang.CharSequence fbmlMarkup)
throws FacebookException,
java.io.IOException
profile_setFBML(Long, String, String, String, String)
fbmlMarkup - refer to the FBML documentation for a description of the markup and its role in various contexts
FacebookException
java.io.IOException
@Deprecated
boolean profile_setMobileFBML(java.lang.CharSequence fbmlMarkup)
throws FacebookException,
java.io.IOException
profile_setFBML(Long, String, String, String, String)
fbmlMarkup - refer to the FBML documentation for a description of the markup and its role in various contexts
FacebookException
java.io.IOException
@Deprecated
boolean profile_setProfileFBML(java.lang.CharSequence fbmlMarkup,
java.lang.Long profileId)
throws FacebookException,
java.io.IOException
profile_setFBML(Long, String, String, String, String)
profileId.
fbmlMarkup - refer to the FBML documentation for a description of the markup and its role in various contextsprofileId - a page or user ID (null for the logged-in user)
FacebookException
java.io.IOException
@Deprecated
boolean profile_setProfileActionFBML(java.lang.CharSequence fbmlMarkup,
java.lang.Long profileId)
throws FacebookException,
java.io.IOException
profile_setFBML(Long, String, String, String, String)
profileId.
fbmlMarkup - refer to the FBML documentation for a description of the markup and its role in various contextsprofileId - a page or user ID (null for the logged-in user)
FacebookException
java.io.IOException
@Deprecated
boolean profile_setMobileFBML(java.lang.CharSequence fbmlMarkup,
java.lang.Long profileId)
throws FacebookException,
java.io.IOException
profile_setFBML(Long, String, String, String, String)
profileId on mobile devices.
fbmlMarkup - refer to the FBML documentation for a description of the markup and its role in various contextsprofileId - a page or user ID (null for the logged-in user)
FacebookException
java.io.IOException
@Deprecated
boolean profile_setFBML(java.lang.CharSequence profileFbmlMarkup,
java.lang.CharSequence profileActionFbmlMarkup)
throws FacebookException,
java.io.IOException
profile_setFBML(Long, String, String, String, String)
profileFbmlMarkup - the FBML for the profile boxprofileActionFbmlMarkup - the FBML for the profile actions
FacebookException
java.io.IOException
@Deprecated
boolean profile_setFBML(java.lang.CharSequence profileFbmlMarkup,
java.lang.CharSequence profileActionFbmlMarkup,
java.lang.Long profileId)
throws FacebookException,
java.io.IOException
profile_setFBML(Long, String, String, String, String)
profileId. Refer to the FBML documentation for a
description of the markup and its role in various contexts.
profileFbmlMarkup - the FBML for the profile boxprofileActionFbmlMarkup - the FBML for the profile actionsprofileId - a page or user ID (null for the logged-in user)
FacebookException
java.io.IOException
@Deprecated
boolean profile_setFBML(java.lang.CharSequence profileFbmlMarkup,
java.lang.CharSequence profileActionFbmlMarkup,
java.lang.CharSequence mobileFbmlMarkup,
java.lang.Long profileId)
throws FacebookException,
java.io.IOException
profile_setFBML(Long, String, String, String, String)
profileId. Refer to the FBML
documentation for a description of the markup and its role in various contexts.
profileFbmlMarkup - the FBML for the profile boxprofileActionFbmlMarkup - the FBML for the profile actionsmobileFbmlMarkup - the FBML for mobile devicesprofileId - a page or user ID (null for the logged-in user)
FacebookException
java.io.IOException
@Deprecated
boolean profile_setFBML(java.lang.CharSequence profileFbmlMarkup,
java.lang.CharSequence profileActionFbmlMarkup,
java.lang.CharSequence mobileFbmlMarkup)
throws FacebookException,
java.io.IOException
profile_setFBML(Long, String, String, String, String)
profileFbmlMarkup - the FBML for the profile boxprofileActionFbmlMarkup - the FBML for the profile actionsmobileFbmlMarkup - the FBML for mobile devicesprofileId - a page or user ID (null for the logged-in user)
FacebookException
java.io.IOException
T profile_getFBML()
throws FacebookException,
java.io.IOException
FacebookException
java.io.IOExceptionprofile_getFBML(int, Long)
T profile_getFBML(java.lang.Long userId)
throws FacebookException,
java.io.IOException
userId - The user whose profile FBML is to be fetched, or the page ID in case of a Page. If not specified, defaults to the session user.
FacebookException
java.io.IOExceptionprofile_getFBML(int, Long)
T profile_getFBML(int type)
throws FacebookException,
java.io.IOException
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.)
FacebookException
java.io.IOExceptionprofile_getFBML(int, Long)
T profile_getFBML(int type,
java.lang.Long userId)
throws FacebookException,
java.io.IOException
type - The type of profile box to retrieve. Specify 1 for the original style (wide and narrow column boxes), 2 for profile_main box. (Default value is 1.)userId - The user whose profile FBML is to be fetched, or the page ID in case of a Page. If not specified, defaults to the session user.
FacebookException
java.io.IOException
boolean fbml_refreshRefUrl(java.lang.String url)
throws FacebookException,
java.io.IOException
url - string representing the URL to refresh
FacebookException
java.io.IOException
boolean fbml_refreshRefUrl(java.net.URL url)
throws FacebookException,
java.io.IOException
url - the URL to refresh
FacebookException
java.io.IOException
boolean fbml_refreshImgSrc(java.lang.String imageUrl)
throws FacebookException,
java.io.IOException
imageUrl - String representing the image URL to refresh
FacebookException
java.io.IOException
boolean fbml_refreshImgSrc(java.net.URL imageUrl)
throws FacebookException,
java.io.IOException
imageUrl - the image URL to refresh
FacebookException
java.io.IOException
@Deprecated
boolean feed_publishTemplatizedAction(java.lang.Long actorId,
java.lang.CharSequence titleTemplate)
throws FacebookException,
java.io.IOException
actorId - deprecatedtitleTemplate - markup (up to 60 chars, tags excluded) for the feed story's title section. Must include the token {actor}.
FacebookException
java.io.IOException
boolean feed_publishTemplatizedAction(java.lang.CharSequence titleTemplate)
throws FacebookException,
java.io.IOException
titleTemplate - markup (up to 60 chars, tags excluded) for the feed story's title section. Must include the token {actor}.
FacebookException
java.io.IOException
boolean feed_publishTemplatizedAction(java.lang.CharSequence titleTemplate,
java.lang.Long pageActorId)
throws FacebookException,
java.io.IOException
pageActorId is provided, page), and publishes aggregating News
Feed stories to the user's friends/page's fans. Stories are identified as being combinable if they have matching templates and substituted values.
titleTemplate - markup (up to 60 chars, tags excluded) for the feed story's title section. Must include the token {actor}.pageActorId - (optional) the ID of the page into whose mini-feed the story is being published
FacebookException
java.io.IOException
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,
java.io.IOException
pageActorId is provided, page), and publishes aggregating News
Feed stories to the user's friends/page's fans. Stories are identified as being combinable if they have matching templates and substituted values.
titleTemplate - markup (up to 60 chars, tags excluded) for the feed story's title section. Must include the token {actor}.titleData - (optional) contains token-substitution mappings for tokens that appear in titleTemplate. Should not contain mappings for the {actor} or
{target} tokens. Required if tokens other than {actor} or {target} appear in the titleTemplate.bodyTemplate - (optional) markup to be displayed in the feed story's body section. can include tokens, of the form {token}, to be substituted using
bodyData.bodyData - (optional) contains token-substitution mappings for tokens that appear in bodyTemplate. Required if the bodyTemplate contains tokens other than
{actor} and {target}.bodyGeneral - (optional) additional body markup that is not aggregated. If multiple instances of this templated story are combined together, the markup in the
bodyGeneral of one of their stories may be displayed.targetIds - The user ids of friends of the actor, used for stories about a direct action between the actor and these targets of his/her action. Required if either
the titleTemplate or bodyTemplate includes the token {target}.images - (optional) additional body markup that is not aggregated. If multiple instances of this templated story are combined together, the markup in the
bodyGeneral of one of their stories may be displayed.pageActorId - (optional) the ID of the page into whose mini-feed the story is being published
FacebookException
java.io.IOException
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,
java.io.IOException
actorId - the user into whose mini-feed the story is being published.titleTemplate - markup (up to 60 chars, tags excluded) for the feed story's title section. Must include the token {actor}.titleData - (optional) contains token-substitution mappings for tokens that appear in titleTemplate. Should not contain mappings for the {actor} or
{target} tokens. Required if tokens other than {actor} or {target} appear in the titleTemplate.bodyTemplate - (optional) markup to be displayed in the feed story's body section. can include tokens, of the form {token}, to be substituted using
bodyData.bodyData - (optional) contains token-substitution mappings for tokens that appear in bodyTemplate. Required if the bodyTemplate contains tokens other than
{actor} and {target}.bodyGeneral - (optional) additional body markup that is not aggregated. If multiple instances of this templated story are combined together, the markup in the
bodyGeneral of one of their stories may be displayed.targetIds - The user ids of friends of the actor, used for stories about a direct action between the actor and these targets of his/her action. Required if either
the titleTemplate or bodyTemplate includes the token {target}.images - (optional) additional body markup that is not aggregated. If multiple instances of this templated story are combined together, the markup in the
bodyGeneral of one of their stories may be displayed.
FacebookException
java.io.IOException
T events_get(java.lang.Long userId,
java.util.Collection<java.lang.Long> eventIds,
java.lang.Long startTime,
java.lang.Long endTime)
throws FacebookException,
java.io.IOException
eventIds - filter by these event ID's (optional)userId - filter by this user only (optional)startTime - UTC lower bound (optional)endTime - UTC upper bound (optional)
FacebookException
java.io.IOException
T events_getMembers(java.lang.Number eventId)
throws FacebookException,
java.io.IOException
eventId - event id
FacebookException
java.io.IOException
T friends_areFriends(long userId1,
long userId2)
throws FacebookException,
java.io.IOException
userId1 - userId2 -
FacebookException
java.io.IOExceptionhttp://wiki.developers.facebook.com/index.php/Friends.areFriends
T friends_areFriends(java.util.Collection<java.lang.Long> userIds1,
java.util.Collection<java.lang.Long> userIds2)
throws FacebookException,
java.io.IOException
userIds1 is friends with the first user in userIds2,
the second user in userIds1 is friends with the second user in userIds2, etc.
userIds1 - userIds2 -
FacebookException
java.io.IOExceptionhttp://wiki.developers.facebook.com/index.php/Friends.areFriends
T friends_get()
throws FacebookException,
java.io.IOException
FacebookException
java.io.IOExceptionhttp://wiki.developers.facebook.com/index.php/Friends.get
T friends_getLists()
throws FacebookException,
java.io.IOException
FacebookException
java.io.IOExceptionhttp://wiki.developers.facebook.com/index.php/Friends.getLists
T friends_get(java.lang.Long friendListId)
throws FacebookException,
java.io.IOException
friendListId.
friendListId - the friend list for which friends should be fetched. if null, all friends will be retrieved.
FacebookException
java.io.IOExceptionhttp://wiki.developers.facebook.com/index.php/Friends.get
T friends_getAppUsers()
throws FacebookException,
java.io.IOException
FacebookException
java.io.IOException
T users_getInfo(java.util.Collection<java.lang.Long> userIds,
java.util.Collection<ProfileField> fields)
throws FacebookException,
java.io.IOException
userIds - a collection of user IDs for which to fetch infofields - a set of ProfileFields
FacebookException
java.io.IOExceptionhttp://wiki.developers.facebook.com/index.php/Users.getInfo
T users_getInfo(java.util.Collection<java.lang.Long> userIds,
java.util.Set<java.lang.CharSequence> fields)
throws FacebookException,
java.io.IOException
userIds - a collection of user IDs for which to fetch infofields - a set of strings describing the info fields desired, such as "last_name", "sex"
FacebookException
java.io.IOExceptionhttp://wiki.developers.facebook.com/index.php/Users.getInfo
T users_getStandardInfo(java.util.Collection<java.lang.Long> userIds,
java.util.Collection<ProfileField> fields)
throws FacebookException,
java.io.IOException
userIds - a collection of user IDs for which to fetch infofields - a set of ProfileFields
FacebookException
java.io.IOExceptionhttp://wiki.developers.facebook.com/index.php/Users.getStandardInfo
T users_getStandardInfo(java.util.Collection<java.lang.Long> userIds,
java.util.Set<java.lang.CharSequence> fields)
throws FacebookException,
java.io.IOException
userIds - a collection of user IDs for which to fetch infofields - a set of strings describing the info fields desired, such as "last_name", "sex"
FacebookException
java.io.IOExceptionhttp://wiki.developers.facebook.com/index.php/Users.getStandardInfo
long users_getLoggedInUser()
throws FacebookException,
java.io.IOException
FacebookException
java.io.IOException
@Deprecated
boolean users_isAppAdded()
throws FacebookException,
java.io.IOException
FacebookException
java.io.IOException
@Deprecated
boolean users_isAppAdded(java.lang.Long userId)
throws FacebookException,
java.io.IOException
userId - the if of the user to check for.
FacebookException
java.io.IOException
boolean users_isAppUser()
throws FacebookException,
java.io.IOException
FacebookException
java.io.IOExceptionusers_isAppUser(Long)
boolean users_isAppUser(java.lang.Long userId)
throws FacebookException,
java.io.IOException
userId - The user ID of the user who may have authorized the application. If this parameter is not specified, then it defaults to the session user. Note: This
parameter applies only to Web applications and is required by them only if the session_key is not specified. Facebook ignores this parameter if it is
passed by a desktop application.
FacebookException
java.io.IOException
boolean users_setStatus(java.lang.String status)
throws FacebookException,
java.io.IOException
FacebookException
java.io.IOExceptionusers_hasAppPermission(com.google.code.facebookapi.Permission),
FacebookExtendedPerm.STATUS_UPDATE,
http://wiki.developers.facebook.com/index.php/Users.setStatus
boolean users_setStatus(java.lang.String status,
java.lang.Long userId)
throws FacebookException,
java.io.IOException
FacebookException
java.io.IOExceptionusers_hasAppPermission(com.google.code.facebookapi.Permission),
FacebookExtendedPerm.STATUS_UPDATE,
http://wiki.developers.facebook.com/index.php/Users.setStatus
boolean users_setStatus(java.lang.String newStatus,
boolean clear)
throws FacebookException,
java.io.IOException
newStatus - the new status message to set.clear - whether or not to clear the old status message.
FacebookException - if an error happens when executing the API call.
java.io.IOException - if a communication/network error happens.http://wiki.developers.facebook.com/index.php/Users.setStatus
boolean users_setStatus(java.lang.String newStatus,
boolean clear,
java.lang.Long userId)
throws FacebookException,
java.io.IOException
newStatus - the new status message to set.clear - whether or not to clear the old status message.userId - the id of the user to set the status for.
FacebookException - if an error happens when executing the API call.
java.io.IOException - if a communication/network error happens.http://wiki.developers.facebook.com/index.php/Users.setStatus
boolean users_setStatus(java.lang.String newStatus,
boolean clear,
boolean statusIncludesVerb)
throws FacebookException,
java.io.IOException
newStatus - the new status message to set.clear - whether or not to clear the old status message.statusIncludesVerb - set to true if you do not want the Facebook Platform to automatically prepend "is " to your status message set to false if you want the "is " prepended
(default behavior)
FacebookException - if an error happens when executing the API call.
java.io.IOException - if a communication/network error happens.http://wiki.developers.facebook.com/index.php/Users.setStatus
boolean users_setStatus(java.lang.String newStatus,
boolean clear,
boolean statusIncludesVerb,
java.lang.Long userId)
throws FacebookException,
java.io.IOException
newStatus - the new status message to set.clear - whether or not to clear the old status message.statusIncludesVerb - set to true if you do not want the Facebook Platform to automatically prepend "is " to your status message set to false if you want the "is " prepended
(default behavior)userId - the id of the user to set the status for.
FacebookException - if an error happens when executing the API call.
java.io.IOException - if a communication/network error happens.http://wiki.developers.facebook.com/index.php/Users.setStatus
boolean users_clearStatus()
throws FacebookException,
java.io.IOException
FacebookException
java.io.IOExceptionusers_hasAppPermission(com.google.code.facebookapi.Permission),
FacebookExtendedPerm.STATUS_UPDATE,
http://wiki.developers.facebook.com/index.php/Users.setStatus
T photos_get(java.lang.Long subjId,
java.lang.Long albumId,
java.util.Collection<java.lang.Long> photoIds)
throws FacebookException,
java.io.IOException
subjId - retrieve from photos associated with this user (optional).albumId - retrieve from photos from this album (optional)photoIds - retrieve from this list of photos (optional)
FacebookException
java.io.IOException
T photos_get(java.lang.Long subjId,
java.util.Collection<java.lang.Long> photoIds)
throws FacebookException,
java.io.IOException
subjId - retrieve from photos associated with this user (optional).photoIds - retrieve from this list of photos (optional)
FacebookException
java.io.IOExceptionphotos_get(Long, Long, Collection),
Developers Wiki: Photos.get
T photos_get(java.lang.Long subjId,
java.lang.Long albumId)
throws FacebookException,
java.io.IOException
subjId - retrieve from photos associated with this user (optional).albumId - retrieve from photos from this album (optional)
FacebookException
java.io.IOExceptionphotos_get(Long, Long, Collection),
Developers Wiki: Photos.get
T photos_get(java.util.Collection<java.lang.Long> photoIds)
throws FacebookException,
java.io.IOException
photoIds - retrieve from this list of photos (optional)
FacebookException
java.io.IOExceptionphotos_get(Long, Long, Collection),
Developers Wiki: Photos.get
T photos_get(java.lang.Long subjId)
throws FacebookException,
java.io.IOException
subjId - retrieve from photos associated with this user (optional).
FacebookException
java.io.IOExceptionphotos_get(Long, Long, Collection),
Developers Wiki: Photos.get
T photos_getAlbums(java.lang.Long userId,
java.util.Collection<java.lang.Long> albumIds)
throws FacebookException,
java.io.IOException
userId - (optional) the id of the albums' owner (optional)albumIds - (optional) the ids of albums whose metadata is to be retrieved
FacebookException
java.io.IOException
T photos_getAlbums(java.lang.Long userId)
throws FacebookException,
java.io.IOException
userId - (optional) the id of the albums' owner (optional)
FacebookException
java.io.IOException
T photos_getAlbums(java.util.Collection<java.lang.Long> albumIds)
throws FacebookException,
java.io.IOException
albumIds - the ids of albums whose metadata is to be retrieved
FacebookException
java.io.IOException
T photos_getTags(java.util.Collection<java.lang.Long> photoIds)
throws FacebookException,
java.io.IOException
photoIds - The list of photos from which to extract photo tags.
FacebookException
java.io.IOException
T photos_createAlbum(java.lang.String albumName)
throws FacebookException,
java.io.IOException
albumName - The list of photos from which to extract photo tags.
FacebookException
java.io.IOException
T photos_createAlbum(java.lang.String name,
java.lang.String description,
java.lang.String location)
throws FacebookException,
java.io.IOException
name - The album name.location - The album location (optional).description - The album description (optional).
FacebookException
java.io.IOException
T photos_createAlbum(java.lang.String albumName,
java.lang.Long userId)
throws FacebookException,
java.io.IOException
albumName - The list of photos from which to extract photo tags.userId - the id of the user creating the album.
FacebookException
java.io.IOException
T photos_createAlbum(java.lang.String name,
java.lang.String description,
java.lang.String location,
java.lang.Long userId)
throws FacebookException,
java.io.IOException
name - The album name.location - The album location (optional).description - The album description (optional).userId - the id of the user creating the album.
FacebookException
java.io.IOException
T photos_addTags(java.lang.Long photoId,
java.util.Collection<PhotoTag> tags)
throws FacebookException,
java.io.IOException
photoId - The photo id of the photo to be tagged.tags - A list of PhotoTags.
FacebookException
java.io.IOException
boolean photos_addTag(java.lang.Long photoId,
java.lang.Long taggedUserId,
java.lang.Double xPct,
java.lang.Double yPct)
throws FacebookException,
java.io.IOException
photoId - The photo id of the photo to be tagged.xPct - The horizontal position of the tag, as a percentage from 0 to 100, from the left of the photo.yPct - The vertical position of the tag, as a percentage from 0 to 100, from the top of the photo.taggedUserId - The list of photos from which to extract photo tags.
FacebookException
java.io.IOException
boolean photos_addTag(java.lang.Long photoId,
java.lang.CharSequence tagText,
java.lang.Double xPct,
java.lang.Double yPct)
throws FacebookException,
java.io.IOException
photoId - The photo id of the photo to be tagged.xPct - The horizontal position of the tag, as a percentage from 0 to 100, from the left of the photo.yPct - The list of photos from which to extract photo tags.tagText - The text of the tag.
FacebookException
java.io.IOException
boolean photos_addTag(java.lang.Long photoId,
java.lang.Long taggedUserId,
java.lang.Double xPct,
java.lang.Double yPct,
java.lang.Long userId)
throws FacebookException,
java.io.IOException
photoId - The photo id of the photo to be tagged.xPct - The horizontal position of the tag, as a percentage from 0 to 100, from the left of the photo.yPct - The vertical position of the tag, as a percentage from 0 to 100, from the top of the photo.taggedUserId - The list of photos from which to extract photo tags.userId - the user tagging the photo.
FacebookException
java.io.IOException
boolean photos_addTag(java.lang.Long photoId,
java.lang.CharSequence tagText,
java.lang.Double xPct,
java.lang.Double yPct,
java.lang.Long userId)
throws FacebookException,
java.io.IOException
photoId - The photo id of the photo to be tagged.xPct - The horizontal position of the tag, as a percentage from 0 to 100, from the left of the photo.yPct - The list of photos from which to extract photo tags.tagText - The text of the tag.userId - the user tagging the photo.
FacebookException
java.io.IOException
T photos_upload(java.io.File photo)
throws FacebookException,
java.io.IOException
photo - an image file
FacebookException
java.io.IOException
T photos_upload(java.io.File photo,
java.lang.String caption)
throws FacebookException,
java.io.IOException
photo - an image filecaption - a description of the image contents
FacebookException
java.io.IOException
T photos_upload(java.io.File photo,
java.lang.Long albumId)
throws FacebookException,
java.io.IOException
photo - an image filealbumId - the album into which the photo should be uploaded
FacebookException
java.io.IOException
T photos_upload(java.io.File photo,
java.lang.String caption,
java.lang.Long albumId)
throws FacebookException,
java.io.IOException
photo - an image filecaption - a description of the image contentsalbumId - the album into which the photo should be uploaded
FacebookException
java.io.IOException
T photos_upload(java.lang.Long userId,
java.io.File photo)
throws FacebookException,
java.io.IOException
photo - an image fileuserId - the id of the user uploading the photo
FacebookException
java.io.IOException
T photos_upload(java.lang.Long userId,
java.io.File photo,
java.lang.String caption)
throws FacebookException,
java.io.IOException
photo - an image filecaption - a description of the image contentsuserId - the id of the user uploading the photo
FacebookException
java.io.IOException
T photos_upload(java.lang.Long userId,
java.io.File photo,
java.lang.Long albumId)
throws FacebookException,
java.io.IOException
photo - an image filealbumId - the album into which the photo should be uploadeduserId - the id of the user uploading the photo
FacebookException
java.io.IOException
T photos_upload(java.lang.Long userId,
java.io.File photo,
java.lang.String caption,
java.lang.Long albumId)
throws FacebookException,
java.io.IOException
photo - an image filecaption - a description of the image contentsalbumId - the album into which the photo should be uploadeduserId - the id of the user uploading the photo
FacebookException
java.io.IOException
T groups_get(java.lang.Long userId,
java.util.Collection<java.lang.Long> groupIds)
throws FacebookException,
java.io.IOException
userId - Optional: User associated with groups. A null parameter will default to the session user.groupIds - Optional: group ids to query. A null parameter will get all groups for the user.
FacebookException
java.io.IOException
T groups_getMembers(java.lang.Number groupId)
throws FacebookException,
java.io.IOException
groupId - the group id
FacebookException
java.io.IOException
T fql_query(java.lang.CharSequence query)
throws FacebookException,
java.io.IOException
query - :
the FQL query statement
FacebookException
java.io.IOException
T notifications_get()
throws FacebookException,
java.io.IOException
FacebookException
java.io.IOException
@Deprecated
java.net.URL notifications_send(java.util.Collection<java.lang.Long> recipientIds,
java.lang.CharSequence notification,
java.lang.CharSequence email)
throws FacebookException,
java.io.IOException
recipientIds - the user ids to which the message is to be sentnotification - the FBML to display on the notifications pageemail - the FBML to send to the specified users via email, or null if no email should be sent
FacebookException
java.io.IOException
void notifications_send(java.util.Collection<java.lang.Long> recipientIds,
java.lang.CharSequence notification)
throws FacebookException,
java.io.IOException
recipientIds - the user ids to which the message is to be sent.notification - the FBML to display on the notifications page.
FacebookException
java.io.IOException
java.lang.String auth_createToken()
throws FacebookException,
java.io.IOException
FacebookException
java.io.IOExceptionhttp://wiki.developers.facebook.com/index.php/Auth.createToken
java.lang.String auth_getSession(java.lang.String authToken)
throws FacebookException,
java.io.IOException
authToken - the token returned by auth_createToken or passed back to your callback_url.
FacebookException
java.io.IOExceptionhttp://wiki.developers.facebook.com/index.php/Auth.getSession
@Deprecated
long auth_getUserId(java.lang.String authToken)
throws FacebookException,
java.io.IOException
FacebookException
java.io.IOExceptionjava.lang.String getCacheSessionKey()
java.lang.Long getCacheUserId()
java.lang.Long getCacheSessionExpires()
java.lang.String getCacheSessionSecret()
@Deprecated
java.lang.Long marketplace_createListing(java.lang.Boolean showOnProfile,
MarketplaceListing attrs)
throws FacebookException,
java.io.IOException
showOnProfile - whether
FacebookException
java.io.IOExceptionusers_hasAppPermission(com.google.code.facebookapi.Permission),
FacebookExtendedPerm.MARKETPLACE,
Developers Wiki: marketplace.createListing
@Deprecated
java.lang.Long marketplace_editListing(java.lang.Long listingId,
java.lang.Boolean showOnProfile,
MarketplaceListing attrs)
throws FacebookException,
java.io.IOException
FacebookException
java.io.IOException
boolean marketplace_removeListing(java.lang.Long listingId)
throws FacebookException,
java.io.IOException
listingId - the listing to be removed
FacebookException
java.io.IOExceptionusers_hasAppPermission(com.google.code.facebookapi.Permission),
FacebookExtendedPerm.MARKETPLACE,
Developers Wiki: marketplace.removeListing
boolean marketplace_removeListing(java.lang.Long listingId,
java.lang.Long userId)
throws FacebookException,
java.io.IOException
listingId - the listing to be removeduserId - the id of the user removing the listing
FacebookException
java.io.IOExceptionusers_hasAppPermission(com.google.code.facebookapi.Permission),
FacebookExtendedPerm.MARKETPLACE,
Developers Wiki: marketplace.removeListing
@Deprecated
boolean marketplace_removeListing(java.lang.Long listingId,
java.lang.CharSequence status)
throws FacebookException,
java.io.IOException
listingId - the listing to be removedstatus - MARKETPLACE_STATUS_DEFAULT, MARKETPLACE_STATUS_SUCCESS, or MARKETPLACE_STATUS_NOT_SUCCESS
FacebookException
java.io.IOExceptionusers_hasAppPermission(com.google.code.facebookapi.Permission),
FacebookExtendedPerm.MARKETPLACE,
Developers Wiki: marketplace.removeListing
java.util.List<java.lang.String> marketplace_getCategories()
throws FacebookException,
java.io.IOException
FacebookException
java.io.IOException
T marketplace_getSubCategories(java.lang.CharSequence category)
throws FacebookException,
java.io.IOException
category - a category, e.g. "HOUSING"
FacebookException
java.io.IOException
T marketplace_getListings(java.util.Collection<java.lang.Long> listingIds,
java.util.Collection<java.lang.Long> userIds)
throws FacebookException,
java.io.IOException
listingIds - listing identifiers (required if uids is null/empty)userIds - posting user identifiers (required if listingIds is null/empty)
FacebookException
java.io.IOException
@Deprecated
T marketplace_search(java.lang.CharSequence category,
java.lang.CharSequence subCategory,
java.lang.CharSequence query)
throws FacebookException,
java.io.IOException
category - the category of listings desired (optional except if subcategory is provided)subCategory - the subcategory of listings desired (optional)query - a query string (optional)
FacebookException
java.io.IOException
T photos_getByAlbum(java.lang.Long albumId,
java.util.Collection<java.lang.Long> photoIds)
throws FacebookException,
java.io.IOException
albumId - retrieve from photos from this album (optional)photoIds - retrieve from this list of photos (optional)
FacebookException
java.io.IOException#photos_get(Integer, Long, Collection),
Developers Wiki: Photos.get
T photos_getByAlbum(java.lang.Long albumId)
throws FacebookException,
java.io.IOException
albumId - retrieve from photos from this album (optional)
FacebookException
java.io.IOException#photos_get(Integer, Long, Collection),
Developers Wiki: Photos.get
@Deprecated
T marketplace_getCategoriesObject()
throws FacebookException,
java.io.IOException
FacebookException
java.io.IOExceptionjava.lang.String getRawResponse()
java.lang.Object getResponsePOJO()
boolean feed_PublishTemplatizedAction(TemplatizedAction action)
throws FacebookException,
java.io.IOException
action - a TemplatizedAction instance that represents the feed data to publish
FacebookException - if any number of bad things happen
java.io.IOException
java.lang.String data_getUserPreference(java.lang.Integer prefId)
throws FacebookException,
java.io.IOException
prefId - the id of the preference to lookup. This should be an integer value from 0-200.
FacebookException - if an error happens when executing the API call.
java.io.IOException - if a communication/network error happens.
java.util.Map<java.lang.Integer,java.lang.String> data_getUserPreferences()
throws FacebookException,
java.io.IOException
FacebookException - if an error happens when executing the API call.
java.io.IOException - if a communication/network error happens.
void data_setUserPreference(java.lang.Integer prefId,
java.lang.String value)
throws FacebookException,
java.io.IOException
prefId - the id of the preference to set, an integer between 0 and 200.value - the value to store, a String of up to 127 characters in length.
FacebookException - if an error happens when executing the API call.
java.io.IOException - if a communication/network error happens.
void data_setUserPreferences(java.util.Map<java.lang.Integer,java.lang.String> values,
boolean replace)
throws FacebookException,
java.io.IOException
values - the values to store, specified in a map. The keys should be preference-id values from 0-200, and the values should be strings of up to 127 characters in
length.replace - set to true if you want to remove any pre-existing preferences before writing the new ones set to false if you want the new preferences to be merged
with any pre-existing preferences
FacebookException - if an error happens when executing the API call.
java.io.IOException - if a communication/network error happens.
boolean sms_canSend()
throws FacebookException,
java.io.IOException
FacebookException - if an error happens when executing the API call.
java.io.IOException - if a communication/network error happens.
boolean sms_canSend(java.lang.Long userId)
throws FacebookException,
java.io.IOException
userId - the UID of the user to check permissions for
FacebookException - if an error happens when executing the API call.
java.io.IOException - if a communication/network error happens.
java.lang.Integer sms_send(java.lang.String message,
java.lang.Integer smsSessionId,
boolean makeNewSession)
throws FacebookException,
java.io.IOException
message - the message to send.smsSessionId - the SMS session id to use, note that that is distinct from the user's facebook session id. It is used to allow applications to keep track of individual
SMS conversations/threads for a single user. Specify null if you do not want/need to use a session for the current message.makeNewSession - set to true to request that Facebook allocate a new SMS session id for this message. The allocated id will be returned as the result of this API call.
You should only set this to true if you are passing a null 'smsSessionId' value. Otherwise you already have a SMS session id, and do not need a new one.
FacebookException - if an error happens when executing the API call.
java.io.IOException - if a communication/network error happens.
java.lang.Integer sms_send(java.lang.Long userId,
java.lang.String message,
java.lang.Integer smsSessionId,
boolean makeNewSession)
throws FacebookException,
java.io.IOException
userId - the id of the user to send the message to.message - the message to send.smsSessionId - the SMS session id to use, note that that is distinct from the user's facebook session id. It is used to allow applications to keep track of individual
SMS conversations/threads for a single user. Specify null if you do not want/need to use a session for the current message.makeNewSession - set to true to request that Facebook allocate a new SMS session id for this message. The allocated id will be returned as the result of this API call.
You should only set this to true if you are passing a null 'smsSessionId' value. Otherwise you already have a SMS session id, and do not need a new one.
FacebookException - if an error happens when executing the API call.
java.io.IOException - if a communication/network error happens.
boolean users_hasAppPermission(Permission perm)
throws FacebookException,
java.io.IOException
FacebookException
java.io.IOExceptionusers_hasAppPermission(Permission,Long),
Users.hasAppPermission
boolean users_hasAppPermission(Permission perm,
java.lang.Long userId)
throws FacebookException,
java.io.IOException
perm - String identifier for the extended permission that is being checked for. Must be one of email, offline_access, status_update, photo_upload,
create_listing, create_event, rsvp_event, sms.userId - The user ID of the user whose permissions you are checking. If this parameter is not specified, then it defaults to the session user. Note: This
parameter applies only to Web applications and is required by them only if the session_key is not specified. Facebook ignores this parameter if it is
passed by a desktop application.
FacebookException
java.io.IOException
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,
java.io.IOException
titleTemplate - the template for the title of the feed entry, this must contain the "(actor}" token. Any other tokens are optional, i.e. "{actor} recommends {place}".titleData - JSON-formatted values for any tokens used in titleTemplate, with the exception of "{actor}" and "{target}", which Facebook populates automatically, i.e.
"{place: "Bizou"}".bodyTemplate - the template for the body of the feed entry, works the same as 'titleTemplate', but is not required to contain the "{actor}" token.bodyData - works the same as titleDatabodyGeneral - non-templatized content for the body, may contain markup, may not contain tokens.pictures - a list of up to 4 images to display, with optional hyperlinks for each one.targetIds - a comma-seperated list of the UID's of any friend(s) who are involved in this feed action (if there are any), this specifies the value of the "{target}"
token. If you use this token in any of your templates, you must specify a value for this parameter.
FacebookException - if any number of bad things happen
java.io.IOException
boolean fbml_setRefHandle(java.lang.String handle,
java.lang.String markup)
throws FacebookException,
java.io.IOException
handle - the id to associate the specified markup with. Put this in fb:ref FBML tags to reference your markup.markup - the FBML markup to store.
FacebookException - if an error happens when executing the API call.
java.io.IOException - if a communication/network error happens.
@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,
java.io.IOException
actorId - the user into whose mini-feed the story is being published.titleTemplate - markup (up to 60 chars, tags excluded) for the feed story's title section. Must include the token {actor}.titleData - (optional) contains token-substitution mappings for tokens that appear in titleTemplate. Should not contain mappings for the {actor} or
{target} tokens. Required if tokens other than {actor} or {target} appear in the titleTemplate.bodyTemplate - (optional) markup to be displayed in the feed story's body section. can include tokens, of the form {token}, to be substituted using
bodyData.bodyData - (optional) contains token-substitution mappings for tokens that appear in bodyTemplate. Required if the bodyTemplate contains tokens other than
{actor} and {target}.bodyGeneral - (optional) additional body markup that is not aggregated. If multiple instances of this templated story are combined together, the markup in the
bodyGeneral of one of their stories may be displayed.targetIds - The user ids of friends of the actor, used for stories about a direct action between the actor and these targets of his/her action. Required if either
the titleTemplate or bodyTemplate includes the token {target}.images - (optional) additional body markup that is not aggregated. If multiple instances of this templated story are combined together, the markup in the
bodyGeneral of one of their stories may be displayed.
FacebookException
java.io.IOException
java.lang.Long marketplace_createListing(java.lang.Long listingId,
boolean showOnProfile,
java.lang.String attributes)
throws FacebookException,
java.io.IOException
listingId - the id of the listing to modify, set to 0 (or null) to create a new listing.showOnProfile - set to true to show the listing on the user's profile (Facebook appears to ignore this setting).attributes - JSON-encoded attributes for this listing.
FacebookException - if an error happens when executing the API call.
java.io.IOException - if a communication/network error happens.
java.lang.Long marketplace_createListing(java.lang.Long listingId,
boolean showOnProfile,
MarketListing listing)
throws FacebookException,
java.io.IOException
listingId - the id of the listing to modify, set to 0 (or null) to create a new listing.showOnProfile - set to true to show the listing on the user's profile, set to false to prevent the listing from being shown on the profile.listing - the listing to publish.
FacebookException - if an error happens when executing the API call.
java.io.IOException - if a communication/network error happens.
java.lang.Long marketplace_createListing(boolean showOnProfile,
MarketListing listing)
throws FacebookException,
java.io.IOException
showOnProfile - set to true to show the listing on the user's profile, set to false to prevent the listing from being shown on the profile.listing - the listing to publish.
FacebookException - if an error happens when executing the API call.
java.io.IOException - if a communication/network error happens.
java.lang.Long marketplace_createListing(java.lang.Long listingId,
boolean showOnProfile,
java.lang.String attributes,
java.lang.Long userId)
throws FacebookException,
java.io.IOException
listingId - the id of the listing to modify, set to 0 (or null) to create a new listing.showOnProfile - set to true to show the listing on the user's profile (Facebook appears to ignore this setting).attributes - JSON-encoded attributes for this listing.userId - the id of the user to create the listing for.
FacebookException - if an error happens when executing the API call.
java.io.IOException - if a communication/network error happens.
java.lang.Long marketplace_createListing(java.lang.Long listingId,
boolean showOnProfile,
MarketListing listing,
java.lang.Long userId)
throws FacebookException,
java.io.IOException
listingId - the id of the listing to modify, set to 0 (or null) to create a new listing.showOnProfile - set to true to show the listing on the user's profile, set to false to prevent the listing from being shown on the profile.listing - the listing to publish.userId - the id of the user to create the listing for.
FacebookException - if an error happens when executing the API call.
java.io.IOException - if a communication/network error happens.
java.lang.Long marketplace_createListing(boolean showOnProfile,
MarketListing listing,
java.lang.Long userId)
throws FacebookException,
java.io.IOException
showOnProfile - set to true to show the listing on the user's profile, set to false to prevent the listing from being shown on the profile.listing - the listing to publish.userId - the id of the user to create the listing for.
FacebookException - if an error happens when executing the API call.
java.io.IOException - if a communication/network error happens.
java.util.List<java.lang.String> marketplace_getSubCategories()
throws FacebookException,
java.io.IOException
FacebookException - if an error happens when executing the API call.
java.io.IOException - if a communication/network error happens.
java.util.List<Listing> marketplace_getListings(java.util.List<java.lang.Long> listingIds,
java.util.List<java.lang.Long> uids)
throws FacebookException,
java.io.IOException
listingIds - the ids of listings to filter by, only listings matching the specified ids will be returned.uids - the ids of users to filter by, only listings submitted by those users will be returned.
FacebookException - if an error happens when executing the API call.
java.io.IOException - if a communication/network error happens.
java.util.List<Listing> marketplace_search(MarketListingCategory category,
MarketListingSubcategory subcategory,
java.lang.String searchTerm)
throws FacebookException,
java.io.IOException
category - the category to search in, optional (unless subcategory is specified).subcategory - the subcategory to search in, optional.searchTerm - the keyword to search for, optional.
FacebookException - if an error happens when executing the API call.
java.io.IOException - if a communication/network error happens.
boolean marketplace_removeListing(java.lang.Long listingId,
MarketListingStatus status)
throws FacebookException,
java.io.IOException
listingId - the id of the listing to remove.status - the status to apply when removing the listing. Should be one of MarketListingStatus.SUCCESS or MarketListingStatus.NOT_SUCCESS.
FacebookException - if an error happens when executing the API call.
java.io.IOException - if a communication/network error happens.
boolean marketplace_removeListing(java.lang.Long listingId,
MarketListingStatus status,
java.lang.Long userId)
throws FacebookException,
java.io.IOException
listingId - the id of the listing to remove.status - the status to apply when removing the listing. Should be one of MarketListingStatus.SUCCESS or MarketListingStatus.NOT_SUCCESS.userId - the id of the user removing the listing.
FacebookException - if an error happens when executing the API call.
java.io.IOException - if a communication/network error happens.
java.lang.Long marketplace_editListing(java.lang.Long listingId,
java.lang.Boolean showOnProfile,
MarketListing attrs)
throws FacebookException,
java.io.IOException
listingId - identifies the listing to be modifiedshowOnProfile - whether the listing can be shown on the user's profileattrs - the properties of the listing
FacebookException
java.io.IOExceptionMarketplaceListing,
Developers Wiki: marketplace.createListing
int sms_sendMessageWithSession(java.lang.Long userId,
java.lang.CharSequence message)
throws FacebookException,
java.io.IOException
userId, with the expectation that the user will reply. The SMS extended permission is required
for success. The returned mobile session ID can be stored and used in #sms_sendResponse when the user replies.
userId - a user IDmessage - the message to be sent via SMS
#sms_sendResponse)
FacebookException - in case of error, e.g. SMS is not enabled
java.io.IOExceptionFacebookExtendedPerm.SMS,
Developers Wiki: Mobile: Application Generated Messages,
Developers Wiki: Mobile: Workflow
void sms_sendMessage(java.lang.Long userId,
java.lang.CharSequence message)
throws FacebookException,
java.io.IOException
userId. The SMS extended permission is required for success.
userId - a user IDmessage - the message to be sent via SMS
FacebookException - in case of error
java.io.IOExceptionFacebookExtendedPerm.SMS,
Developers Wiki: Mobile: Application Generated Messages,
Developers Wiki: Mobile: Workflow
T pages_getInfo(java.util.Collection<java.lang.Long> pageIds,
java.util.EnumSet<PageProfileField> fields)
throws FacebookException,
java.io.IOException
pageIds. Can be called for pages that have added the application
without establishing a session.
pageIds - the page IDsfields - a set of page profile fields
FacebookException
java.io.IOException
T pages_getInfo(java.util.Collection<java.lang.Long> pageIds,
java.util.Set<java.lang.CharSequence> fields)
throws FacebookException,
java.io.IOException
pageIds. Can be called for pages that have added the application
without establishing a session.
pageIds - the page IDsfields - a set of page profile fields
FacebookException
java.io.IOException
T pages_getInfo(java.lang.Long userId,
java.util.EnumSet<PageProfileField> fields)
throws FacebookException,
java.io.IOException
userId.
userId - the ID of a user about whose pages to fetch infofields - a set of PageProfileFields
FacebookException
java.io.IOException
T pages_getInfo(java.lang.Long userId,
java.util.Set<java.lang.CharSequence> fields)
throws FacebookException,
java.io.IOException
userId.
userId - the ID of a user about whose pages to fetch infofields - a set of page profile fields
FacebookException
java.io.IOException
boolean pages_isAppAdded(java.lang.Long pageId)
throws FacebookException,
java.io.IOException
pageId - the ID of the page
FacebookException
java.io.IOException
boolean pages_isFan(java.lang.Long pageId,
java.lang.Long userId)
throws FacebookException,
java.io.IOException
pageId.
pageId - the ID of the pageuserId - the ID of the user (defaults to the logged-in user if null)
FacebookException
java.io.IOException
boolean pages_isFan(java.lang.Long pageId)
throws FacebookException,
java.io.IOException
pageId.
pageId - the ID of the page
FacebookException
java.io.IOException
boolean pages_isAdmin(java.lang.Long pageId)
throws FacebookException,
java.io.IOException
pageId.
pageId - the ID of the page
FacebookException
java.io.IOException
T notifications_sendEmailToCurrentUser(java.lang.String subject,
java.lang.String email,
java.lang.String fbml)
throws FacebookException,
java.io.IOException
subject - the subject of the email message.email - a plaintext version of the email to send.fbml - an FBML version of the email to send, the fbml parameter is a stripped-down set of FBML that allows only tags that result in text, links and linebreaks.
FacebookException - if an error happens when executing the API call.
java.io.IOException - if a communication/network error happens.
T notifications_sendEmail(java.util.Collection<java.lang.Long> recipients,
java.lang.CharSequence subject,
java.lang.CharSequence email,
java.lang.CharSequence fbml)
throws FacebookException,
java.io.IOException
recipients - the uid's of the users to send to.subject - the subject of the email message.email - a plaintext version of the email to send.fbml - an FBML version of the email to send, the fbml parameter is a stripped-down set of FBML that allows only tags that result in text, links and linebreaks.
FacebookException - if an error happens when executing the API call.
java.io.IOException - if a communication/network error happens.
T notifications_sendTextEmailToCurrentUser(java.lang.String subject,
java.lang.String email)
throws FacebookException,
java.io.IOException
subject - the subject of the email message.email - a plaintext version of the email to send.
FacebookException - if an error happens when executing the API call.
java.io.IOException - if a communication/network error happens.
T notifications_sendTextEmail(java.util.Collection<java.lang.Long> recipients,
java.lang.String subject,
java.lang.String email)
throws FacebookException,
java.io.IOException
recipients - the uid's of the users to send to.subject - the subject of the email message.email - a plaintext version of the email to send.
FacebookException - if an error happens when executing the API call.
java.io.IOException - if a communication/network error happens.
T notifications_sendFbmlEmailToCurrentUser(java.lang.String subject,
java.lang.String fbml)
throws FacebookException,
java.io.IOException
subject - the subject of the email message.fbml - the FBML version of the email to send, the fbml parameter is a stripped-down set of FBML that allows only tags that result in text, links and
linebreaks.
FacebookException - if an error happens when executing the API call.
java.io.IOException - if a communication/network error happens.
T notifications_sendFbmlEmail(java.util.Collection<java.lang.Long> recipients,
java.lang.String subject,
java.lang.String fbml)
throws FacebookException,
java.io.IOException
recipients - the uid's of the users to send to.subject - the subject of the email message.fbml - the FBML version of the email to send, the fbml parameter is a stripped-down set of FBML that allows only tags that result in text, links and
linebreaks.
FacebookException - if an error happens when executing the API call.
java.io.IOException - if a communication/network error happens.
void notifications_send(java.lang.CharSequence notification)
throws FacebookException,
java.io.IOException
notification - the FBML to be displayed on the notifications page; only a stripped-down set of FBML tags that result in text and links is allowed
FacebookException
java.io.IOException
@Deprecated
java.lang.String notifications_sendEmail(java.util.Collection<java.lang.Long> recipientIds,
java.lang.CharSequence subject,
java.lang.CharSequence fbml)
throws FacebookException,
java.io.IOException
recipientIds - up to 100 user ids to which the message is to be sentsubject - the subject of the notification email (optional)fbml - markup to be sent to the specified users via email; only a stripped-down set of FBML that allows only tags that result in text, links and linebreaks is
allowed
FacebookException
java.io.IOException
@Deprecated
java.lang.String notifications_sendEmailPlain(java.util.Collection<java.lang.Long> recipientIds,
java.lang.CharSequence subject,
java.lang.CharSequence text)
throws FacebookException,
java.io.IOException
recipientIds - up to 100 user ids to which the message is to be sentsubject - the subject of the notification email (optional)text - the plain text to send to the specified users via email
FacebookException
java.io.IOException
@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,
java.io.IOException
fbml or text must be specified.
recipientIds - up to 100 user ids to which the message is to be sentsubject - the subject of the notification email (optional)fbml - markup to be sent to the specified users via email; only a stripped-down set of FBML tags that result in text, links and linebreaks is allowedtext - the plain text to send to the specified users via email
FacebookException
java.io.IOException
boolean admin_setAppProperties(java.util.Map<ApplicationProperty,java.lang.String> properties)
throws FacebookException,
java.io.IOException
properties - a Map containing the properties to set.
FacebookException
java.io.IOException
@Deprecated
org.json.JSONObject admin_getAppProperties(java.util.Collection<ApplicationProperty> properties)
throws FacebookException,
java.io.IOException
properties - a collection indicating the properties you are interested in retrieving.
FacebookException
java.io.IOException
java.util.Map<ApplicationProperty,java.lang.String> admin_getAppPropertiesMap(java.util.Collection<ApplicationProperty> properties)
throws FacebookException,
java.io.IOException
properties - a collection indicating the properties you are interested in retrieving.
FacebookException
java.io.IOException
java.lang.String admin_getAppPropertiesAsString(java.util.Collection<ApplicationProperty> properties)
throws FacebookException,
java.io.IOException
properties - a collection indicating the properties you are interested in retrieving.
FacebookException
java.io.IOException
T data_getCookies()
throws FacebookException,
java.io.IOException
FacebookException
java.io.IOException
T data_getCookies(java.lang.Long userId)
throws FacebookException,
java.io.IOException
userId - the id of the user to get the cookies for.
FacebookException
java.io.IOException
T data_getCookies(java.lang.String name)
throws FacebookException,
java.io.IOException
name - the name of the cookie to retrieve.
FacebookException
java.io.IOException
T data_getCookies(java.lang.Long userId,
java.lang.CharSequence name)
throws FacebookException,
java.io.IOException
userId - the id of the user to get the cookies for.name - the name of the cookie to retrieve.
FacebookException
java.io.IOException
boolean data_setCookie(java.lang.String name,
java.lang.String value)
throws FacebookException,
java.io.IOException
name - the name of the cookie to setvalue - the value of the cookie
FacebookException
java.io.IOException
boolean data_setCookie(java.lang.String name,
java.lang.String value,
java.lang.String path)
throws FacebookException,
java.io.IOException
name - the name of the cookie to setvalue - the value of the cookiepath - the path relative to the application's callback URL, with which the cookie should be associated. (default is "/")
FacebookException
java.io.IOException
boolean data_setCookie(java.lang.Long userId,
java.lang.CharSequence name,
java.lang.CharSequence value)
throws FacebookException,
java.io.IOException
userId - the id of the user to set the cookie for.name - the name of the cookie to setvalue - the value of the cookie
FacebookException
java.io.IOException
boolean data_setCookie(java.lang.Long userId,
java.lang.CharSequence name,
java.lang.CharSequence value,
java.lang.CharSequence path)
throws FacebookException,
java.io.IOException
userId - the id of the user to set the cookie for.name - the name of the cookie to setvalue - the value of the cookiepath - the path relative to the application's callback URL, with which the cookie should be associated. (default is "/")
FacebookException
java.io.IOException
boolean data_setCookie(java.lang.String name,
java.lang.String value,
java.lang.Long expires)
throws FacebookException,
java.io.IOException
name - the name of the cookie to setvalue - the value of the cookieexpires - the timestamp at which the cookie expires
FacebookException
java.io.IOException
boolean data_setCookie(java.lang.String name,
java.lang.String value,
java.lang.Long expires,
java.lang.String path)
throws FacebookException,
java.io.IOException
name - the name of the cookie to setvalue - the value of the cookieexpires - the timestamp at which the cookie expirespath - the path relative to the application's callback URL, with which the cookie should be associated. (default is "/")
FacebookException
java.io.IOException
boolean data_setCookie(java.lang.Long userId,
java.lang.CharSequence name,
java.lang.CharSequence value,
java.lang.Long expires)
throws FacebookException,
java.io.IOException
userId - the id of the user to set the cookie for.name - the name of the cookie to setvalue - the value of the cookieexpires - the timestamp at which the cookie expires
FacebookException
java.io.IOException
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,
java.io.IOException
userId - the id of the user to set the cookie for.name - the name of the cookie to setvalue - the value of the cookieexpires - the timestamp at which the cookie expirespath - the path relative to the application's callback URL, with which the cookie should be associated. (default is "/")
FacebookException
java.io.IOException
boolean admin_setAppProperties(ApplicationPropertySet properties)
throws FacebookException,
java.io.IOException
properties - an ApplicationPropertySet that is translated into a single JSON String.
FacebookException
java.io.IOExceptionhttp://wiki.developers.facebook.com/index.php/Admin.setAppProperties
ApplicationPropertySet admin_getAppPropertiesAsSet(java.util.EnumSet<ApplicationProperty> properties)
throws FacebookException,
java.io.IOException
admin.setAppProperties call. A
session is not required to use this method.
This method cannot be called by desktop apps.
properties - an enumeration of the properties to get
FacebookException
java.io.IOExceptionApplicationProperty,
http://wiki.developers.facebook.com/index.php/Admin.getAppPropertiesvoid beginBatch()
T batch_run(java.lang.String methods,
boolean serial)
throws FacebookException,
java.io.IOException
methods - A JSON encoded array of strings. Each element in the array should contain the full parameters for a method, including method name, sig, etc. Currently,
there is a maximum limit of 15 elements in the array.serial - An optional parameter to indicate whether the methods in the method_feed must be executed in order. The default value is false.
FacebookException
java.io.IOException
java.util.List<? extends java.lang.Object> executeBatch(boolean serial)
throws FacebookException,
java.io.IOException
serial - set to true, and your batch queries will always execute serially, in the same order in which your specified them. If set to false, the Facebook API
server may execute your queries in parallel and/or out of order in order to improve performance.
FacebookException
java.io.IOException
T application_getPublicInfo(java.lang.Long applicationId,
java.lang.String applicationKey,
java.lang.String applicationCanvas)
throws FacebookException,
java.io.IOException
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.
FacebookException
java.io.IOExceptionhttp://wiki.developers.facebook.com/index.php/Application.getPublicInfo
T application_getPublicInfoById(java.lang.Long applicationId)
throws FacebookException,
java.io.IOException
applicationId - the id of the application to get the info for.
FacebookException
java.io.IOExceptionhttp://wiki.developers.facebook.com/index.php/Application.getPublicInfo
T application_getPublicInfoByApiKey(java.lang.String applicationKey)
throws FacebookException,
java.io.IOException
applicationKey - the public API key of the application to get the info for.
FacebookException
java.io.IOExceptionhttp://wiki.developers.facebook.com/index.php/Application.getPublicInfo
T application_getPublicInfoByCanvasName(java.lang.String applicationCanvas)
throws FacebookException,
java.io.IOException
applicationCanvas - the canvas-page name of the application to get the info for.
FacebookException
java.io.IOExceptionhttp://wiki.developers.facebook.com/index.php/Application.getPublicInfo
int admin_getAllocation(java.lang.String allocationType)
throws FacebookException,
java.io.IOException
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"
FacebookException
java.io.IOExceptionhttp://wiki.developers.facebook.com/index.php/Admin.getAllocation
int admin_getAllocation(AllocationType allocationType)
throws FacebookException,
java.io.IOException
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"
FacebookException
java.io.IOExceptionhttp://wiki.developers.facebook.com/index.php/Admin.getAllocation
@Deprecated
int admin_getRequestAllocation()
throws FacebookException,
java.io.IOException
FacebookException
java.io.IOExceptionhttp://wiki.developers.facebook.com/index.php/Admin.getAllocation
@Deprecated
int admin_getNotificationAllocation()
throws FacebookException,
java.io.IOException
FacebookException
java.io.IOExceptionhttp://wiki.developers.facebook.com/index.php/Admin.getAllocation
@Deprecated
T admin_getDailyMetrics(java.util.Set<Metric> metrics,
java.util.Date start,
java.util.Date end)
throws FacebookException,
java.io.IOException
metrics - a set specifying the specific metrics to retrievestart - the starting date to retrieve data for (range must not exceed 30 days)end - the ending to to retrive data for (range must not exceed 30 days)
FacebookException
java.io.IOExceptionhttp://wiki.developers.facebook.com/index.php/Admin.getDailyMetrics
T admin_getMetrics(java.util.Set<Metric> metrics,
java.util.Date start,
java.util.Date end,
long period)
throws FacebookException,
java.io.IOException
metrics - a set specifying the specific metrics to retrievestart - the starting date to retrieve data for (range must not exceed 30 days)end - the ending to to retrive data for (range must not exceed 30 days)period - a number specifying the desired period to group the metrics by, in seconds, Facebook currently only supports Metric.PERIOD_DAY, Metric.PERIOD_WEEK, and
Metric.PERIOD_MONTH
FacebookException
java.io.IOExceptionhttp://wiki.developers.facebook.com/index.php/Admin.getMetrics
@Deprecated
T admin_getDailyMetrics(java.util.Set<Metric> metrics,
long start,
long end)
throws FacebookException,
java.io.IOException
metrics - a set specifying the specific metrics to retrievestart - the starting date to retrieve data for (range must not exceed 30 days), the accepted unit of time is milliseconds, NOT secondsend - the ending to to retrive data for (range must not exceed 30 days), the accepted unit of time is milliseconds, NOT seconds
FacebookException
java.io.IOExceptionhttp://wiki.developers.facebook.com/index.php/Admin.getDailyMetrics
T admin_getMetrics(java.util.Set<Metric> metrics,
long start,
long end,
long period)
throws FacebookException,
java.io.IOException
metrics - a set specifying the specific metrics to retrievestart - the starting date to retrieve data for (range must not exceed 30 days), the accepted unit of time is milliseconds, NOT secondsend - the ending to to retrive data for (range must not exceed 30 days), the accepted unit of time is milliseconds, NOT secondsperiod - a number specifying the desired period to group the metrics by, in seconds, Facebook currently only supports Metric.PERIOD_DAY, Metric.PERIOD_WEEK, and
Metric.PERIOD_MONTH
FacebookException
java.io.IOExceptionhttp://wiki.developers.facebook.com/index.php/Admin.getMetrics
boolean permissions_grantApiAccess(java.lang.String apiKey,
java.util.Set<FacebookMethod> methods)
throws FacebookException,
java.io.IOException
apiKey - the API-key of the application to grant permission to.methods - the API methods to allow the other application to call. If the set is empty or null, permission is granted for all API methods.
FacebookException
java.io.IOException
boolean permissions_grantFullApiAccess(java.lang.String apiKey)
throws FacebookException,
java.io.IOException
apiKey - the API-key of the application to grant permission to.
FacebookException
java.io.IOException
T permissions_checkAvailableApiAccess(java.lang.String apiKey)
throws FacebookException,
java.io.IOException
apiKey - the API key of the application to check for permissions from.
FacebookException
java.io.IOException
boolean permissions_revokeApiAccess(java.lang.String apiKey)
throws FacebookException,
java.io.IOException
apiKey - the API key of the application to remove permissions for.
FacebookException
java.io.IOException
T permissions_checkGrantedApiAccess(java.lang.String apiKey)
throws FacebookException,
java.io.IOException
apiKey - the API key of the application to check permissions for.
FacebookException
java.io.IOException
boolean auth_expireSession()
throws FacebookException,
java.io.IOException
FacebookException
java.io.IOException
boolean auth_revokeAuthorization()
throws FacebookException,
java.io.IOException
FacebookException
java.io.IOExceptionvoid beginPermissionsMode(java.lang.String apiKey)
apiKey - the API key of the application to being making requests for.void endPermissionsMode()
javax.xml.bind.JAXBContext getJaxbContext()
void setJaxbContext(javax.xml.bind.JAXBContext context)
context - the context to use.
java.lang.String auth_promoteSession()
throws FacebookException,
java.io.IOException
FacebookException
java.io.IOException
java.lang.Long feed_registerTemplateBundle(java.lang.String template)
throws FacebookException,
java.io.IOException
template - the template to store
FacebookException
java.io.IOException
java.lang.Long feed_registerTemplateBundle(java.util.Collection<java.lang.String> templates)
throws FacebookException,
java.io.IOException
templates - the templates to store
FacebookException
java.io.IOException
@Deprecated
java.lang.Long feed_registerTemplateBundle(java.lang.String template,
java.lang.String shortTemplate,
java.lang.String longTemplate)
throws FacebookException,
java.io.IOException
template - the template to store.shortTemplate - the short template to store.longTemplate - the long template to store.
FacebookException
java.io.IOException
java.lang.Long feed_registerTemplateBundle(java.util.Collection<java.lang.String> templates,
java.util.Collection<BundleStoryTemplate> shortTemplates,
BundleStoryTemplate longTemplate)
throws FacebookException,
java.io.IOException
template - the template to store.shortTemplate - the short template to store.longTemplate - the long template to store.
FacebookException
java.io.IOException
T feed_getRegisteredTemplateBundles()
throws FacebookException,
java.io.IOException
FacebookException
java.io.IOException
T feed_getRegisteredTemplateBundleByID(java.lang.Long id)
throws FacebookException,
java.io.IOException
id - the id to retrieve.
FacebookException
java.io.IOException
java.lang.Boolean feed_publishUserAction(java.lang.Long bundleId)
throws FacebookException,
java.io.IOException
bundleId - the template bundle-id to use to render the feed.
FacebookException
java.io.IOException
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,
java.io.IOException
bundleId - the template bundle-id to use to render the feed.templateData - a map of name-value pairs to substitute into the template being rendered.targetIds - the ids of individuals that are the target of this action.bodyGeneral - additional markup to include in the feed story.
FacebookException
java.io.IOException
T profile_getInfo(java.lang.Long userId)
throws FacebookException,
java.io.IOException
userId - the id of the user to get the info section for.
FacebookException
java.io.IOException
T profile_getInfoOptions(java.lang.String field)
throws FacebookException,
java.io.IOException
field - the field to get the options for.
FacebookException
java.io.IOException
void profile_setInfo(java.lang.Long userId,
java.lang.String title,
boolean textOnly,
java.util.List<ProfileInfoField> fields)
throws FacebookException,
java.io.IOException
userId - the user to set the info section for.title - the title to use for the section.textOnly - set to true if your info fields are text only. set to false for thumbnail mode.fields - the fields to set.
FacebookException
java.io.IOException
void profile_setInfoOptions(ProfileInfoField field)
throws FacebookException,
java.io.IOException
field - the field to set.
FacebookException
java.io.IOException
T photos_addTags(java.lang.Long photoId,
java.util.Collection<PhotoTag> tags,
java.lang.Long userId)
throws FacebookException,
java.io.IOException
photoId - The photo id of the photo to be tagged.tags - A list of PhotoTags.userId - the id of the user adding the tags.
FacebookException
java.io.IOExceptionvoid setServerUrl(java.lang.String newUrl)
newUrl - the new URL to use, for example: "http://api.facebook.com/restserver.php"
java.net.MalformedURLExceptionjava.net.URL getDefaultServerUrl()
void setDefaultServerUrl(java.net.URL url)
java.lang.Boolean liveMessage_send(java.lang.Long recipient,
java.lang.String eventName,
org.json.JSONObject message)
throws FacebookException,
java.io.IOException
recipient - the id of the user to send the message to.eventName - the name associated with the FBJS handler you want to recieve your message.message - the JSON-object to send, the object will be passed to the FBJS handler that you have mapped to 'eventName'. See
http://wiki.developers.facebook.com/index.php/LiveMessage for details.
FacebookException
java.io.IOException
void notifications_send(java.util.Collection<java.lang.Long> recipientIds,
java.lang.String notification,
boolean isAppToUser)
throws FacebookException,
java.io.IOException
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.
FacebookException
java.io.IOExceptionhttp://wiki.developers.facebook.com/index.php/Notifications.send
boolean feed_deactivateTemplateBundleByID(java.lang.Long bundleId)
throws FacebookException,
java.io.IOException
bundleId - the id of the bundle to deactivate.
FacebookException
java.io.IOException
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,
java.io.IOException
bundleId - the template bundle-id to use to render the feed.templateData - a map of name-value pairs to substitute into the template being rendered.images - the images to associate with this feed entrytargetIds - the ids of individuals that are the target of this action.bodyGeneral - additional markup to include in the feed story.storySize - story size to use. valid values are 1, 2 or 4.
FacebookException
java.io.IOException
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||