Graph API

Version 2.8

Graph API | Marketing API

Changelog entries are categorized in the following way:

  • New Features — New products or services, including new nodes, edges, and fields.
  • Changes — Changes to existing products or services (not including Deprecations).
  • Deprecations — Existing products or services that are being removed.
  • 90-Day Breaking Changes — Changes and deprecations that will take effect 90 days after the version release date.

New Features, Changes, and Deprecations only affect this version. 90-Day Breaking Changes affect all versions.

Breaking Changes are not included here since they are not tied to specific releases.

Graph API v2.8

Released October 5, 2016 | Available until April 18, 2019

New Features v2.8

Open Graph Actions

  • Two new common Open Graph action types, available to all developers in all versions of the API, have been added:

    • books.rates
    • games.plays

Resumable Upload API

  • Upload files a small piece at a time, allowing for more reliability over poor connections. Please see our guide on the Resumable Upload API for more information. This API is only available for page thumbnails right now, but will expand to other types of media in the future (like video).

ThreatExchange

  • ThreatExchange has some new features, including support for Webhooks and new tagging functionality. Please see the ThreatExchange Changelog for more information.

Changes v2.8

Pages

  • Feed Targeting - The targeting and feed_targeting fields on the /page/feed edge now consistently use geo_locations instead of specifying geography via other methods. See our guide on targeting which includes information about the geo_locations object.

Deprecations v2.8

Open Graph

  • Custom Open Graph Actions - Apps can no longer create new Open Graph action or object types or publish Open Graph Stories that use custom action or object types. Approximately 1 year after the v2.8 release, no version of the API will allow publishing stories that use custom action or object types. Please see our deprecation guide for more information.

  • Open Graph Stories - Localization is no longer supported.

User

  • /admined_groups - This edge on the User node has been deprecated. Use groups edge on the User node instead.

  • bio - This field on the User node has been deprecated. Use the about field instead.

90-Day Breaking Changes v2.8

Open Graph

  • Custom Open Graph Actions

    • No versions of the API will allow the creation of new Open Graph action or object types.
    • All App Collections will be removed from people's profiles.
    • Please see our deprecation guide for more information.