Released November 7, 2017 | Available Until Aug 7, 2018 | Blog Post
We now have a new relationship which represents clients and agencies. In the past we also had no
user; we handled all access and invitations to a business and it's assets through
bid/userpermissions which caused performance issues. Highlights of the new API include:
To access users on business:
To access assets assigned to users:
To access business pages:
BUSINESS_ID/owned_pages- To get a list of Pages the business owns
BUSINESS_ID/client_pages- To get a list of Pages of the clients of the business
BUSINESS_ID/pending_owned_pages- To get a list of Pages the business owns that are pending approval
BUSINESS_ID/pending_client_pages- To get a list of Pages belonging to clients of a business that are pending approval
To access business ad accounts:
BUSINESS_ID/owned_ad_accounts- To get a list of ad accounts the business owns
BUSINESS_ID/client_ad_accounts- To get a list of ad accounts of the clients of the business
BUSINESS_ID/pending_owned_ad_accounts- To get a list of ad accounts the business owns that are pending approval
BUSINESS_ID/pending_client_ad_accounts- To get a list of ad accounts of the clients of the business that are pending approval
To access business product catalogs
BUSINESS_ID/owned_product_catalogs- To get a list of product catalogs the business owns
BUSINESS_ID/client_product_catalogs- To get a list of product catalogs belonging to clients of the business
To access business apps:
BUSINESS_ID/owned_apps- To get a list of apps the business owns
BUSINESS_ID/client_apps- To get a list of apps of the clients of the business
BUSINESS_ID/pending_client_apps- To get a list of apps belonging to clients of a business that are pending approval
You can now create a carousel ad with an attachment that shows a real-time location. Added the options
location_source_id = PAGE_ID in
AD_CREATIVE_ID/object_story_spec. This is available at
object_story_spec field in:
You can now target geographic areas beyond a radius around a store location. We added
geo_locations parameter in the
targeting_specs field when you create an ad set with store visits as your objective. Under limited availability, see your Facebook Representative to access. See Store Visits Objective
POST AD_ACCOUNT_ID/adsetshas the new option.
country_groupsand targeting the
STORE_VISITSobjective available on a limited basis, see Store Visits
This reflects the type of destination an ad links to; in other words, where someone goes when they click on an ad or call-to-action in an ad. This provides a consistent destination type for all ads in an ad set, so that ads only contain different types of ad creative. See Ad Set, Destination Type.
destination_typefor ad sets
Added the new field
AD_ACCOUNT_ID/CAMPAIGN_ID which describes the type of key performance indicator you want to track for the campaign or ad objects in the campaign. For see insights data by
kpi_results make these calls:
For more information, see Ad Campaign, Reference.
Invalidate ads targeting
right_hand_column - Ads targeting this position with invalid creatives for
AD_ACCOUNT_ID/adsets returns an error. We do not allow
right_hand_column-only placement with video, collection, or canvas ads format. For
right_hand_column-only placement, you can only use single-image and carousel formats.
GET VERSION/RF_PREDICTION_ID/pause_periods - To return
Array now, not
String to enable easier handling.
Renamed fields — The
admin_system_user field has been renamed to
admin, and the
system_user field has been renamed to
employee. This affects the following edges:
Deprecated optimizations for
VIDEO_VIEWS - Campaigns with the
VIDEO_VIEWS objective can no longer use
REACH as optimization goals:
REACHoptimization goal, automatically converts to the
POST_ENGAGEMENTas the optimization goal returns an error. This is because creating or duplicating an ad in an existing ad set tries to reuse any of these optimization goals.
Edges impacted by this change:
reach - As a
optimization_goal for the brand awareness objective. Removed for or
/adset; it is available for ad recall optimization only. This avoids confusion for anyone using reach as a dedicated objective.
Deprecated the optimization
BRAND_AWARENESS - Replaced by
AD_RECALL_LIFT. This reflects a new, more efficient, ads delivery model. The new optimization goal supports mixed creative, such as static and video ads in the same ad set and manual bidding.
BRAND_AWARENESS is no longer available at:
frequency_cap - Including
frequency_cap_reset_period fields on:
POST_ENGAGEMENT - You can no longer use
POST_ENGAGEMENT as a
billing_event for this objective. This better aligns ads delivery and measurement. This impacts the endpoint:
recurrence_value - From Advanced Measurement API. The field was also known under Atlas API as report schedule. We replaced it with
recurrence_values. See Advanced Measurement, Report Schedules.
Deprecated endpoints for the redesign of Business Manager API:
Deprecated endpoints for managing your assets:
To access assets, use
Deprecated endpoints for managing assets belonging to another business:
These deprecations affect all API versions and will take effect on November 14, 2017.
Deprecated creating and editing Event Ads or Link Ads that are not connected to a valid page. The following format is no longer valid and returns an error.
Signatures that are being deprecated:
Existing Event and Link Ads that you created earlier continue to run, but you can't modify the ad's creative or create new ads once this change goes in effect otherwise you receive errors. See Event and Local Ads and Ad, Reference.