Connection Objects are the Facebook objects such as pages, apps and other assets which the user or business is an administrator. In the case of apps, the user or business may be the developer or advertiser. As an administrator of these objects you have the exclusive right to run ads on behalf of these objects as well as target users based on their connection to this object. For example, only a Page Administrator can target ads at the fans of their page.
The types of connection objects are:
If someone is an admin of pages within a specific business manager account, you can get a list of these pages. Query the business's owned_page
edge with an access token with pages_show_list
permission:
curl -G \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_pages"
You can also get a list of all pages a person is an admin for with their access token with pages_show_list
permission:
curl -G \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/<API_VERSION>/<USER_ID>/accounts"
Optional filters for ..{USER_ID}/accounts
queries:
Filter | Description |
---|---|
int | Filter and return pages belonging to this business. |
boolean | Filter and return pages for which you are admin, but are or are not associated with a business. If not specified, returns all pages you are an admin on. |
boolean | If set to |
boolean | Filter all pages which are/are not place pages. If not specified, returns all pages. |
See also Pages API
The endpoint /{user-id}/promotable_events
has been deprecated.
You can list all apps for a specific business manager that you can advertise for. Query the business's owned_apps
edge with an access token with ads_management
permissions:
curl -G \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_apps"
See also Business Manager, Apps
To list all apps that a person can promote, make the following query with an access token with ads_management
or ads_read
permissions:
curl -G \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/advertisable_applications"
Optional filters:
Filter | Description |
---|---|
int | Filter and return all apps belonging to this business. |
int | Filter to show only this app |
See also Application API