Version 2.10

Graph API | Marketing API

Einträge im Änderungsprotokoll sind in die folgenden Kategorien unterteilt:

  • Neue Funktionen: Neue Produkte oder Dienste, z. B. neue Nodes, Edges und Felder.
  • Änderungen: Änderungen an bestehenden Produkten oder Diensten (dazu gehören nicht veraltete Elemente)
  • Veraltete Elemente: Bestehende Produkte oder Dienstleistungen, die entfernt werden.
  • Funktionsgefährdende Änderungen nach 90 Tagen: Änderungen und veraltete Produkte, die 90 Tage nach dem Veröffentlichungsdatum der Version in Kraft treten werden.

Neue Funktionen, Änderungen und Veraltete Elemente betreffen nur diese Version. Funktionsgefährdende Änderungen nach 90 Tagen betreffen alle Versionen.

Funktionsgefährdende Änderungen werden hier nicht aufgeführt, da sie nicht an bestimmte Veröffentlichungen gebunden sind.


Graph API

Veröffentlicht 18. Juli 2017 | Verfügbar bis 7. November 2019


Neue Funktionen

Webhooks

  • Webhooks für Veranstaltungen der Seite: Bei folgenden Aktionen wird nun ein Update für Abonnements des feed-Felds der Seite ausgelöst:

    • Automatisches Veröffentlichen einer geplanten Veranstaltung
    • Kommentieren der Veranstaltungs-Story
    • Erstellen und Veröffentlichen einer Veranstaltung
    • Veröffentlichen eines Veranstaltungsentwurfs

Änderungen

Zuweisungen von Gutschriften

  • GET /{extended-credit-id}: Die folgenden Felder wurden umbenannt:

    • invoice_email zu extended_credit_emails
    • invoice_group zu extended_credit_invoice_groups
    • sequential_liability_amount zu allocated_amount
  • GET /{extended-credit-id}: Die folgenden Felder wurden hinzugefügt:

    • liable_biz_name fields
    • owner_business field mit den Unterfeldern id und name
    • owning_credit_allocation_configs
    • send_bill_to_biz_name
  • GET /{extended-credit-id}: Das folgende Feld wurde entfernt:

    • business_id field
  • extended_credit_invoice_groups: Die folgenden Unterfelder wurden hinzugefügt:

    • ad_accounts mit den Unterfeldern account_id und name
    • email
    • id
    • name
  • CurrencyAmount: Die folgenden Felder geben nun ein CurrencyAmount-Objekt zurück statt nur den Betrag:

    • allocated_amount
    • balance
    • max_balance
    • online_max_balance

Seiten

Nutzer

Webhooks

  • Durchsetzung der App-Beschränkungen: Die Angabe eines Zugriffsschlüssels für einen Nutzer, der die Beschränkungen der Application (wie Land oder Alter) nicht erfüllt, verursacht einen Fehler, falls in der Anfrage kein appsecret_proof angegeben ist.

Veraltete Elemente

Events

  • GET /{event-id}/videos: Diese Edge wurde entfernt.

Funktionsgefährdende Änderungen nach 90 Tagen

Kommentare

  • POST und DELETE /{comment-id}: Für diesen Node ist nun ein gültiger Seitenzugriffsschlüssel erforderlich.

  • POST and DELETE /{object-id}/comments: Für diesen Node ist nun ein gültiger Seitenzugriffsschlüssel erforderlich.

  • GET /{object-id}/comments: Für diese Edge ist nun ein gültiger Zugriffsschlüssel erforderlich.

URLs

  • POST /{url}: Für diesen Node ist nun ein gültiger Zugriffsschlüssel erforderlich.

  • GET /{url}: og_object wird nicht mehr standardmäßig zurückgegeben, sondern muss in den Feldparameter eingebunden werden.

  • /{url}-Scraping: GET-Anfragen veranlassen kein Scraping der URL. POST /{url} muss nun zum Scraping der URL verwendet werden.

Beiträge

  • /{post-id}: Für diesen Node ist nun ein gültiger Zugriffsschlüssel erforderlich.

Videos

  • /{video-id}: Für diesen Node ist nun ein gültiger Seitenzugriffsschlüssel erforderlich.

Marketing API

Released July 18, 2017 | Available until May 8, 2018


New Features

  • No new features.

Changes

  • No changes.

Deprecations

  • No deprecations.

90-Day Breaking Changes

  • No 90-day breaking changes.

Breaking Changes in Marketing API v2.10

Ads Management

  • Holdout fields - The following fields have been deprecated from POST /{ad_account_id}/ads and GET /{ad_id}:

    • holdout_end
    • holdout_hash
    • holdout_start
    • no_show_offset
    • no_show_percentage
    • show_end
    • show_start
  • POST /{ad_account_id}/adcreatives - The following parameter is now deprecated:

    • follow_redirect
  • creative_rotation_parameter and creative_rotation type from GET ADSET_ID and POST AD_ACCOUNT_ID/adsets are deprecated.

  • Real-time bidding partner GET endpoints are deprecated. This includes GET /RTB_PARTNER_ID and GET /RTB_PARTNER_ID/stats endpoints. We also removed the field rtb_flag from POST /ADSET_ID and POST /ADGROUP_ID.

Signals and Targeting

  • Reach and Frequency Predictions - As of 2.10 we now provide target_spec as a JSON object; you no longer have to parse the response into JSON.

Insights

  • Breakdowns - The following types have been deprecated for the action_link_click_destination breakdown. See Insights, Breakdowns.

    • app_store_clicks
    • deeplink_clicks
    • website_clicks

Replaced by:

  • click_to_app_store
  • click_to_app_deeplink
  • click_to_website