Graph:Application

From Facebook Developer Wiki (FbDevWiki.com)
Jump to: navigation, search

An application registered on Facebook Platform. The Graph API supports querying for information on existing applications. To create, administer or delete applications developers must go to the Developer Application.

Example

https://graph.facebook.com/2439131959 (The Graffiti Application)

Properties

Name Description Permissions Returns Condition
id The application ID Publicly available A JSON string always included
name The title of the application Publicly available A JSON string always included
description The description of the application written by the 3rd party developers Publicly available A JSON string only if one is set
category The category of the application Publicly available A JSON string only if one is set
subcategory The sub-category of the application Publicly available A JSON string only if one is set
link Used to go to the application's "about page", but now redirects straight to the application Publicly available A JSON string always included
migrations A JSON object listing migrations and the true/false settings for each only included when fields=migrations and an application access token is used
canvas_name namespace The canvas name of the application (ie http://apps.facebook.com/namespace/ goes to the application) Publicly available A JSON string only if one is set
company The company the application belongs to Publicly available A JSON string only if one is set
icon_url The URL of the application's icon. May point to generic one if not set. Publicly available A JSON string always included

if return_ssl_resources=1 then will return https version of icon

logo_url The URL of the application's logo. Points to generic one if not set. Publicly available A JSON string always included

if return_ssl_resources=1 then will return https version of logo

daily_active_users The number of daily active users the application has (rounded) Publicly available A JSON string NOT included if value is 0
weekly_active_users The number of weekly active users the application has (rounded) Publicly available A JSON string NOT included if value is 0
monthly_active_users The number of monthly active users the application has (rounded) Publicly available A JSON string NOT included if value is 0
mobile_web_url URL pointing to the mobile version of the application Publicly available A JSON string only if one is set
auth_referral_enabled Publicly available A JSON integer only if fields=auth_referral_enabled is included in request
social_discovery Publicly available A JSON integer only if fields=social_discovery is included in request


android_key_hash undocumented only if fields=android_key_hash is included in request
app_name same as "name" undocumented only if fields=app_name is included in request
app_type undocumented only if fields=app_type is included in request
client_config undocumented only if fields=client_config is included in request
configured_ios_sso undocumented only if fields=configured_ios_sso is included in request
ios_bundle_id undocumented only if fields=ios_bundle_id is included in request
ipad_app_store_id undocumented only if fields=ipad_app_store_id is included in request
supports_attribution undocumented only if fields=supports_attribution is included in request
url_scheme_suffix undocumented only if fields=url_scheme_suffix is included in request

Connections

Name Description Permissions Returns
feed The application's wall Publicly available A JSON Array of Post objects
posts The applications's own posts Publicly available A JSON Array of Post objects
picture The application's logo with maximum dimensions of 75x75 pixels suitable for embedding as the source of an image tag Publicly available Returns a HTTP 302 with the URL of the user's profile picture. This way you can include this directly in an img tag and have it display properly.
tagged The photos, videos, and posts in which this application has been tagged Publicly available An array of Post, Photo or Video objects
links The application's posted links Publicly available An array of Link objects
photos The photos this application has uploaded Publicly available array of Photo objects
albums The photo albums this page has created Publicly available array of Album objects
statuses The application's status updates Publicly available array of Status message objects
videos The videos this application has created Publicly available array of Video objects
notes The application's notes Publicly available array of Note objects
events The events this page is managing Publicly available array of Event objects
subscriptions All of the subscriptions this application has for real-time notifications Requires an application access token array of Subscription objects
insights Usage metrics for this application Requires an application access token array of Insights objects
accounts Test User accounts associated with the application. Note: this doesn't appear in the list of connections when passing metadata=1 into the query. Requires an application access token An array of JSON objects containing id, access_token and login_url for the test users
reviews Reviews of this application Publicly available An array of Review objects
banned Banned users from your app only accessible with that application's access token JSON object containing a data attribute. The data attribute is an array of JSON objects containing the name and id of banned users.
staticresources from official docs: "Usage stats about the canvas application's static resources, such as javascript and CSS, and which ones are being flushed to browsers early." access_token of application admin array of usage_stats and flushed_resources
translations The translated strings for this application. application access_token array of objects containing native_string, description for a given locale
scores Scores for the user and their friends user access_token array of objects containing user, score, application and type.
achievements Achievements registered for the app. application access_token
Personal tools
Namespaces
Variants
Actions
Navigation
Graph API
FQL
Toolbox