Version 8.0

Graph API

Veröffentlicht 4. August 2020 | Verfügbar bis 1. November 2022 | Blog-Post

Zugriffsschlüssel

Veraltete Endpunkte

In v8.0 und höher veraltet. Wird am 2. November 2020 in allen Versionen eingestellt.

• GET /token_deprecation_check

Alben

Wiederhergestellte Endpunkte

Gilt für alle Versionen.

• GET /{album-id}/likes

App-Konfiguration

App-Typen

Diese Änderung gilt für alle Versionen.

Bei neu erstellten Apps kann nun ein App-Typ ausgewählt werden: „Business“, „Gaming“ oder „Keiner“. Auf diese Weise wird die Oberfläche für die App-Review vereinfacht, da basierend auf dem ausgewählten Typ nicht zutreffende Berechtigungen und Features entfernt werden. Darüber hinaus nutzen Apps, für die der Typ „Business“ ausgewählt wird, einen neuen Autorisierungsmechanismus. Sie verwenden außerdem keine Modi mehr und haben Zugriff auf ein neues Feature. Weitere Informationen findest du im Änderungsprotokolleintrag zu Business-Apps.

Business Apps

Bei Apps, für die der Typ „Business“ ausgewählt wird, kommt der neue Autorisierungsmechanismus Zugriffsebenen zum Einsatz. Zugriffsebenen ersetzen die Funktionen, die vom Entwicklungsmodus und Live-Modus bereitgestellt wurden. Diese wurden für Business-Apps entfernt, und der App-Review-Prozess ist dadurch nun einfacher und intuitiver. Darüber hinaus wurde ein neues Feature für den Unternehmenselemente-Benutzerprofil-Zugriff veröffentlicht, mit dem Business-Apps einen kleinen Satz von öffentlichen Nutzer-Feldern lesen können. Diese Änderungen werden weiter unten genauer beschrieben.

Zugriffsebenen

Gilt für alle Versionen.

Zugriffsebenen sind ein neuer Graph API-Autorisierungsmechanismus für Business-Apps, die Berechtigungen und Features individuell zuweisen. Der Standardzugriff gewährt nur Zugriff auf Daten, die App-Nutzern gehören, die eine Rolle in der App oder eine Rolle in dem Unternehmen innehaben, dem die App gehört. Der erweiterte Zugriff ermöglicht den Zugriff auf Daten jedes beliebigen App-Nutzers, setzt jedoch die App-Review voraus. Business-Apps erhalten automatisch Standardzugriff für alle Berechtigungen und Features, die für ihren Typ verfügbar sind.

Entwicklungsmodus und Live-Modus entfernt

Gilt für alle Versionen.

Der Entwicklungsmodus und der Live-Modus wurden für Apps entfernt, für die als Typ Business-App ausgewählt wurde. Diese Modi wurden durch Zugriffsebenen ersetzt, die die gleichen Funktionen, aber mehr Flexibilität bieten. Da Business-Apps Standardzugriff für alle Berechtigungen und Features haben, kann jeder Nutzer, der eine Rolle in der App oder eine Rolle in dem Unternehmen, dem die App gehört, hat, der App jederzeit alle verfügbaren Berechtigungen gewähren. Hierdurch wird die App-Review überflüssig und es muss bei der Entwicklung auch nicht mehr zwischen den Modi gewechselt werden.

Neues Feature für den Unternehmenselemente-Benutzerprofil-Zugriff

Gilt für alle Versionen.

Das neue Feature für den Zugriff auf Benutzerprofile mit Business Assets ermöglicht Business-Apps, einen kleinen Satz von öffentlichen Nutzer-Feldern zu lesen, solange der Nutzer Assets verwendet hat, die dem Unternehmen gehören, das Eigentümer der App ist. Eine Liste der lesbaren Nutzer-Felder findest du in der Referenz zum Business-Asset-Benutzerprofil-Zugriff.

Kommentare

Wiederhergestellte Endpunkte

Gilt für alle Versionen.

• GET /{comment-id}/likes

Geräte

Veraltete Endpunkte

In v8.0 und höher veraltet. Wird am 2. November 2020 in allen Versionen eingestellt.

• POST /device/share

Gruppen

Veraltete Endpunkte

In v8.0 und höher veraltet.

• GET /{group-id}/posts

In v8.0 und höher veraltet. Wird am 2. November 2020 in allen Versionen eingestellt.

• GET /{group-post-id}/likes

Instagram

Neuer oEmbed-Endpunkt von Instagram

Gilt für alle Versionen.

Es wurde ein neuer GET /instagram_oembed-Endpunkt eingeführt. Er bietet die gleichen Funktionen wie die veralteten oEmbed-Endpunkte von Instagram, die am 24. Oktober 2020 eingestellt werden. Der neue Endpunkt erfordert einen Zugriffsschlüssel, daher benötigst du ein Facebook-Entwicklerkonto und eine registrierte App, um darauf zugreifen zu können. Anleitungen zur Verwendung und weitere Informationen findest du im Dokument zu Instagram oEmbed.

Lebensereignisse

Veraltete Endpunkte

In v8.0 und höher veraltet.

• GET /{life-event-id}
• GET /{life-events-id}/photos

Links

Veraltete Endpunkte

In v8.0 und höher veraltet.

• GET /{link-id}/reactions

Live-Videos

Veraltete Endpunkte

In v8.0 und höher veraltet.

• GET /{live-video-id}/likes

Sammle mit dem GET /{live-video-id}/reactions-Endpunkt „Gefällt mir“-Angaben für ein Live-Video.

Parameter „save_vod“

Gilt ab v8.0. Gilt ab dem 2. November 2020 für alle Versionen.

Der Parameter save_vod ist für die folgenden Edges veraltet:

• POST /{user_id}/live_videos
• POST /{group_id}/live_videos
• POST /{page_id}/live_videos
• POST /{event_id}/live_videos

Messenger-Plattform

Veraltete Endpunkte

In v8.0 und höher veraltet.

• GET /{page-id}/thread_settings
• POST /{page-id}/thread_settings
• DELETE /{page-id}/thread_settings

App-Review

Gilt für alle Versionen.

Die App-Review für Messenger wurde von Produkte > Messenger > Einstellungen zu App-Review im App-Dashboard verschoben. Messenger-spezifische Berechtigungen (pages_messaging, pages_user_gender, pages_user_locale und pages_user_timezone) kannst du unter App-Review > Berechtigungen und Features anfordern. Weitere Informationen findest du in der Dokumentation zu Messenger App-Review.

Messenger Profile Edge

Gilt ab v8.0.

Der verschachtelte persistente Menütyp ist für POST /{page-id}/messenger_profile veraltet.

Neue Funktion: Messenger für Shops

Gilt ab v8.0.

Unterstützung für das Senden und Empfangen von Produkten in Messenger für Shops. Dies beinhaltet die Produktvorlage, mit der Produkte in Nachrichten, Webhooks für Nachrichten mit Produktvorlage und Nachrichten aus der Facebook Shops-Produktdetailseite sowie Echo-Webhooks für Nachrichten mit Produkten gesendet werden können.

• GET /{message_id}/access_requests
• POST {page_id}/message
• message_echo Webhook
• messages Webhook

Native Angebote

Veraltete Endpunkte

In v8.0 und höher veraltet.

• GET /{native-offer-id}/nativeofferviews?photos

Open Graph

Veraltete Endpunkte

In v8.0 und höher veraltet. Wird zum 2. November 2020 in allen Versionen eingestellt.

• GET /{open-graph-action-id}/comments
• POST /{open-graph-action-id}/comments

Seiten

Veraltete Endpunkte

In v8.0 und höher veraltet.

• DELETE /{page-id}/tabs
• GET /{group-id}/posts
• GET /{page-id}/place_topics
• GET /{page-about-story-id}
• POST /{page-about-story-id}
• POST /{page-id}/page_about_story

Seitenbeitrag

In allen Versionen veraltet.

Das Kommentar-ID-Format für Seitenbeiträge, {page-id}_{post_id}_{comment-id}, wurde eingestellt. Verwende stattdessen das Format {pagepost-id}_{comment-id}.

Fotos

Veraltete Endpunkte

In allen Versionen veraltet.

• GET /{photo-id}/sharedposts

Orte

Veraltete Endpunkte

In v8.0 und höher veraltet.

• GET /{place-information-id} (siehe Korrekturen)

Beiträge

Veraltete Endpunkte

In v8.0 und höher veraltet. Wird zum 2. November 2020 in allen Versionen eingestellt.

• GET /{post-id}/likes

Sammle mit dem GET /post/reactions-Endpunkt „Gefällt mir“-Angaben für einen Beitrag.

Suche

Veraltete Endpunkte

In v8.0 und höher veraltet. Wird am 2. November 2020 in allen Versionen eingestellt.

• GET /search?type=place
• GET /search?type=audience_interest

Sicherheitseinstellungen

Veraltete Felder

In v8.0 und höher veraltet. Wird im November 2020 in allen Versionen eingestellt.

• secure_browsing

Soziale Plugins

Facebook oEmbed-Endpunkte

Diese Änderung gilt ab dem 24. Oktober 2020 für alle Versionen.

oEmbed-Endpunkte von Facebook, mit denen Apps eingebettetes HTML für öffentliche Facebook-Posts und Videos erhalten können, werden am 24. Oktober 2020 eingestellt. Es wurden drei neue Endpunkte eingeführt, die die gleichen Funktionen wie die veralteten Endpunkte bieten:

• GET /oembed_page
• GET /oembed_post
• GET /oembed_video

Die neuen Endpunkte erfordern einen Zugriffsschlüssel, und Anfragen unterliegen einer Durchsatzratenbegrenzung. Informationen zur Verwendung sowie weitere Informationen findest du in der Dokumentation zum neuen oEmbed-Endpunkt.

Nutzer

Veraltete Endpunkte

In v8.0 und höher veraltet.

• GET /{user-id}/taggable_friends

Veraltete Felder

In v8.0 und höher veraltet. Wird im November 2020 in allen Versionen eingestellt.

• security_settings
• test_group
• viewer_can_send_gift
• is_shared_login

In allen Versionen veraltet.

• can_review_measurement_request
• is_famedeeplinkinguser

Erneute Autorisierung

Diese Änderung gilt für alle Versionen.

Ab dem 24. Oktober 2020 erfordern die folgenden Felder nach 90 Tagen Inaktivität eine erneute Autorisierung des Datenzugriffs:

• is_eligible_promo
• payment_mobile_pricepoint
• payment_pricepoints

User Picture

Gilt ab 24. Oktober 2020 für alle Versionen.

Ab dem 24. Oktober 2020 erfordert der GET /{user-id}/picture-Endpunkt (GET /{user-id}?fields=picture) eine App-spezifische Nutzer-ID (ASID) für Anfragen ohne Schlüssel. Wenn du den Nutzer nicht mit einer ASID abfragst, musst du eine App, einen Client oder einen Nutzer in den Zugriffsschlüssel einschließen. Weitere Informationen findest du in der User Picture-Referenz.

Videofragen

Veraltete Endpunkte

In v8.0 und höher veraltet.

• GET /{question-id}
• GET /{question-id}/options
• GET /{question-id}/votes
• GET /{question-option-id}

Workplace

Veraltete Endpunkte

In v8.0 und höher veraltet. Wird zum 2. November 2020 in allen Versionen eingestellt.

• GET /{company-id}/access_requests
• GET /access_requests

Marketing API

Veröffentlicht 4. August 2020 | Verfügbar bis 4. Mai 2021 | Blog-Post

Werbekonten

Veraltete Endpunkte

In v8.0 und höher veraltet.

• GET /AdReportSchedule
• DELETE act_{ad-account-id}/adsets

Berechtigungen

Gilt ab v8.0. Gilt ab dem 2. November 2020 für alle Versionen.

Apps benötigen granulare Berechtigungen für den Zugriff auf die Unternehmensfelder eines Werbekontos. Berechtigungen sollten für ein bestimmtes Unternehmensobjekt gewährt werden.

Asset Customization-Regeln

Validierung

Gilt ab v8.0.

Alle Werbeanzeigen mit asset_feed_spec müssen mindestens zwei Zielgruppen-Anpassungsregeln beinhalten. Wenn deine Werbeanzeige asset_feed_spec verwendet und nicht mindestens zwei Regeln beinhaltet, kannst du diese Anzeige nicht erstellen.

Diese Änderung wirkt sich auf Placement Asset Customization, Multi-Language Ads und Segment Asset Customization aus.

Segment Asset Customization

Gilt ab v8.0. Gilt ab dem 2. November 2020 für alle Versionen.

Alle Anwendungsfälle, bei denen es nicht um Geolocation geht, wurden für Nutzer von Segment Asset Customization eingestellt. Aufgrund dieser Änderung müssen alle Targeting-Regeln Geolocation-Informationen in „customization_spec“ enthalten. Eine Ausnahme gilt für die Standardregel, die keine Geolocation umfassen muss.

Gebote

Zielkosten-Gebotsstrategie

Gilt ab v8.0

Die TARGET_COST-Gebotsstrategie ist veraltet. Um Kosten weiterhin kontrollieren zu können, empfehlen wir dir die Nutzung von Geboten mit Kostenbegrenzung. Alle verfügbaren Gebotsstrategien anzeigen

Business Manager

Veraltete Endpunkte

In v8.0 und höher veraltet.

• GET{system-user-id}/updated_by

Erneute Einführung von Sharing Agreements-Endpunkten

Gilt für alle Versionen

Die folgenden Endpunkte wurden wieder eingeführt:

• /{business-id}/received_sharing_agreements
• /{business-id}/initiated_sharing_agreements

Beide Endpunkte waren mit der Veröffentlichung von Graph API v6.0 eingestellt worden.

Canvas

Veraltete Endpunkte

• /{canvas-id}/collection_hero_image
• /{canvas-id}/collection_hero_video
• /{canvas-id}/collection_thumbnails

Catalog API

Berechtigungen

Gilt ab v8.0. Gilt ab dem 31. Januar 2021 für alle Versionen.

Du benötigst nicht mehr die ads_management-Berechtigung, um auf Produktkatalog-Endpunkte zuzugreifen. Künftig benötigst du die catalog_management-Berechtigung zum Aufrufen dieser Endpunkte. Entwickler, die über ads_management in den letzten 90 Tagen Zugriff auf Katalog-Endpunkte hatten, werden bis zum 14. August 2020 automatisch zur catalog_management-Berechtigung migriert.

Bis zum 28. Februar 2021 können Entwickler, die mit älteren Versionen der API arbeiten, weiterhin Produktkatalog-Endpunkte mit der ads_management-Berechtigung aufrufen. Bei Version 8.0 benötigst du die catalog_management-Berechtigung.

Nach dem Ablaufdatum im Februar ist die catalog_management-Berechtigung nicht mehr mit ads_management verknüpft, sodass Nutzer die catalog_management-Berechtigung für deine App explizit gewähren müssen.

Authentifizierung

Gilt ab v8.0. Gilt ab dem 2. November 2020 für alle Versionen.

[AKTUALISIERT] Die folgenden Catalog API-Endpunkte akzeptieren nun Einstellungen für die zweistufige Authentifizierung von Unternehmen. Ruft eine App diesen Endpunkt auf, tritt ein Fehler auf, wenn das Unternehmen, das Eigentümer des Katalogs ist, für den aktuellen App-Nutzer die zweistufige Authentifizierung erfordert, sich der App-Nutzer jedoch nicht damit authentifiziert hat.

Wenn der aktuelle App-Nutzer über ein Partnerunternehmen Zugriff auf den Katalog hat, werden die Authentifizierungsanforderungen des Business Managers des Partners berücksichtigt. Systemnutzer müssen sich nicht über die zweistufige Authentifizierung authentifizieren.

• POST /{business-id}/owned_product_catalogs
• POST /{destination-id}
• POST /{home-listing-id}
• DELETE /{home-listing-id}
• POST /{hotel-id}
• DELETE /{hotel-id}
• POST /{hotel-id}/hotel_rooms
• POST /{hotel-room-id}
• DELETE /{hotel-room-id}
• POST /{page-id}/product_catalogs
• POST /{product-catalog-id}
• DELETE /{product-catalog-id}
• POST /{product-catalog-id}/agencies
• DELETE /{product-catalog-id}/agencies
• POST /{product-catalog-id}/assigned_users
• DELETE /{product-catalog-id}/assigned_users
• POST /{product-catalog-id}/batch
• POST /{product-catalog-id}/categories
• POST /{product-catalog-id}/destinations
• POST /{product-catalog-id}/external_event_sources
• DELETE /{product-catalog-id}/external_event_sources
• POST /{product-catalog-id}/flights
• POST /{product-catalog-id}/home_listings
• POST /{product-catalog-id}/hotel_rooms_batch
• POST /{product-catalog-id}/hotels
• POST /{product-catalog-id}/items_batch
• /{product-catalog-id}/pricing_variables_batch
• POST /{product-catalog-id}/product_groups
• POST /{product-catalog-id}/product_feeds
• POST /{product-catalog-id}/product_sets
• POST /{product-catalog-id}/products
• POST /{product-catalog-id}/vehicles
• POST /{product-feed-rule-id}
• DELETE /{product-feed-rule-id}
• POST /{product-feed-id}
• DELETE /{product-feed-id}
• POST /{product-feed-id}/rules
• POST /{product-feed-id}/uploads
• POST /{product-feed-id}/upload_schedules
• POST /{product-feed-schedule-id}
• DELETE /{product-feed-schedule-id}
• POST /{product-feed-upload-id}/error_report
• POST /{product-group-id}
• DELETE /{product-group-id}
• POST /{product-group-id}/products
• POST /{product-item-id}
• DELETE /{product-item-id}
• POST /{product-set-id}
• DELETE /{product-set-id}
• POST /{vehicle-id}

Reporting

Eingestellte Funktionen

Gilt ab v8.0

• GET /{ad-study-id}?fields=split_test_config
• GET /{ad-study-id}?fields=iterative_split_test_config

Targeting

Eingestellte Funktionen

Gilt ab v8.0

• GET /search?type=adzipcode

Korrekturen

• 28. September 2020: Aktualisierung des Eintrags über die Catalog API-Authentifizierung, um mehr Klarheit zu schaffen.
• 23. Oktober 2020: Aktualisierung des Catalog API-Eintrags:

  • Wir haben die Frist verlängert, bis zu der Entwickler, die frühere Versionen der API verwenden, Produktkatalog-Endpunkte noch mit der ads_management-Berechtigung aufrufen können. Die neue Frist ist nun der 28. Februar 2021.
  • Wir haben Unklarheiten in Bezug auf die Authentifizierung von Systemnutzern beseitigt.
• 17. Mai 2021: Änderung des veralteten Endpunkts von GET /{place-id} in GET /{place-information-id}. GET /{place-id} wurde nicht eingestellt.