Neu: Graph API v26.0 und Marketing API v26.0

Graph API v26.0 und Marketing API v26.0 umfassen neue Funktionen, eingestellte Funktionen und nicht abwärtskompatible Änderungen. Sieh dir die nachstehenden Highlights an und rufe das Änderungsprotokoll für V26.0 auf, um eine vollständige Liste der Änderungen und Details zu erhalten.

Wichtige Termine und Änderungen

• Graph API – Commerce-Bestellverwaltung: Ab dem 29. Juli 2026 werden Aufrufe an betroffene Endpunkte ab Version 26.0 blockiert. Die Endpunkte werden am 27. Oktober 2026 aus allen übrigen Graph API-Versionen entfernt. Danach geben Aufrufe Fehler zurück. Es gibt keine Ersatz-API.
• Graph API – Inhaberfelder in Rights Manager: Mit Version 26.0 stehen ab dem 29. Juli 2026 Ersatzfelder zur Verfügung, die den Typ „RightsHolderOwner“ zurückgeben. Die eingestellten Inhaberfelder werden nicht mehr zurückgegeben. Die eingestellten Felder bleiben nach dem Launch von v26.0 noch zwei Jahre lang in v25.0 und früheren Versionen verfügbar.
• Graph API – Legacy-Protokoll-Features: Ab dem 29. Juli 2026 werden fünf Legacy-Verhaltensweisen aus v26.0-Aufrufen entfernt. Dasselbe Verhalten gilt für alle verbleibenden unterstützten Graph API-Versionen ab dem 27. Oktober 2026.
• Marketing API – Werbeanzeigen im WhatsApp-Status: Ab dem 29. Juli 2026 bietet Version 26.0 erweiterte Funktionen für Identität, Targeting, Optimierung und Anzeigengestaltung.
• Marketing API – Advantage+ Audience für Kampagnen zu Wohnraum, Beschäftigung sowie Finanzprodukten und -dienstleistungen: Mit Version 26.0 muss bei neuen oder kopierten Anzeigengruppen mit eingeschränktem Targeting advantage_audience ab dem 29. Juli 2026 explizit auf 1 oder 0 gesetzt werden. Standard- oder gelockerte Konfigurationen verwenden weiterhin standardmäßig den Wert „1“ und bestehende Anzeigen-Set-Updates bleiben unberührt.
• Marketing API – Instagram Explore-Feed: Die Platzierung ist ab Version 26.0 am 29. Juli 2026 nicht mehr verfügbar. Entwickler*innen sollten Explore aus ihren Platzierungskonfigurationen entfernen.
• Marketing API – Nur-Web-Ziel für Web+App-Kampagnen: Mit Version 26.0 können Anzeigen ab dem 29. Juli 2026 kein Creative verwenden, bei dem applink_treatment auf web_only gesetzt ist, wenn für die Kampagne „Website und App“ als Conversion-Orte festgelegt sind. Die Einschränkung gilt ab dem 27. Oktober 2026 für alle Versionen der Marketing API.
• Marketing API – Messenger Stories: Bei versionierten Aufrufen mit Version 26.0 wird der Wert story ab dem 29. Juli 2026 beim Erstellen oder Aktualisieren von Anzeigengruppen stillschweigend aus messenger_positions entfernt. Die Einstellung betrifft alle Versionen der Marketing API, einschließlich Aufrufe ohne Version, und tritt am 27. Oktober 2026 in Kraft.
• Marketing API – Erstellung von Poll Ads: Ab Version 26.0 am 29. Juli 2026 werden Anfragen zur Erstellung einer Umfrage-Anzeigengestaltung oder zur Änderung einer Anzeige in eine Umfrage-Anzeige abgelehnt. Aktualisierungen vorhandener Anzeigen, bei denen die Anzeigengestaltung unverändert bleibt, werden weiterhin unterstützt. Die Einstellung betrifft alle Marketing API-Versionen ab dem 27. Oktober 2026.
• Graph API und Marketing API – Felder zur Schätzung der Auslieferung: Die Antwortfelder daily_outcomes_curve, budget_guardrail und estimate_dau werden ab dem 29. Juli 2026 aus den Aufrufen der Version 26.0 und am 27. Oktober 2026 aus allen verbleibenden unterstützten Versionen entfernt. Es gibt keine Ersatz-API.
• Einstellung der Graph API-Version: Die Graph API v20.0 wird am 24. September 2026 eingestellt und entfernt. Die Graph API v21.0 wird am 21. Januar 2027 eingestellt und entfernt.

Allgemeine Updates

Marketing API: Erweiterte Unterstützung für Anzeigen im WhatsApp-Status

Ab dem 29. Juli 2026 unterstützen Werbeanzeigen im WhatsApp-Status mit der Marketing API v26.0 zusätzliche Funktionen für Identität, Targeting, Optimierung und Anzeigengestaltung.

• WhatsApp-Identität: Drittanbieter, die die Marketing API verwenden, müssen explizit wamo_whatsapp_identity_spec in Anzeigen einbinden, die für die Auslieferung im WhatsApp-Status vorgesehen sind. Für diese Aufrufe wird die WhatsApp-Identität nicht automatisch als Standard verwendet.
• Targeting an Personen mit unbekanntem Alter: Wenn die Platzierung „WhatsApp-Status“ ausgewählt wird und user_age_unknown nicht festgelegt ist, wird das Feld standardmäßig auf true gesetzt. Das bedeutet, dass die Kampagne Personen auf WhatsApp erreichen kann, deren Alter nicht bekannt ist.
• Optimierung: Die Conversion-Optimierung für Offsite-Conversions wird für die Ziele „Umsatz“, „Leads“ und „Interaktionen“ unterstützt. Die Optimierung „Landingpage-Aufrufe“ wird ebenfalls unterstützt.
• Anzeigenformat: Carousel Ads unterstützen bis zu 10 Karten.

Weitere Informationen findest du in der Dokumentation zu Targeting nach Platzierung und Grundlegendes Targeting.

Einstellungen und nicht abwärtskompatible Änderungen

Graph API und Marketing API: Feld „Schätzwert zur Auslieferung“ entfernt

Die Felder daily_outcomes_curve, budget_guardrail und estimate_dau werden aus der Antwort des Delivery-Estimate-Endpunkts entfernt, da der Dienst, der diese Werte bereitstellt, eingestellt wurde. Ab dem 29. Juli 2026 werden diese Felder nicht mehr von der Graph API v26.0 und der Marketing API v26.0 zurückgegeben. Die Änderung gilt ab dem 27. Oktober 2026 für alle noch unterstützten Graph API- und Marketing API-Versionen. Es gibt keine Ersatz-API.

Entwickler*innen sollten diese Felder vor dem jeweiligen Entfernungstermin nicht mehr verwenden bzw. nicht mehr darauf verweisen.

Betroffen sind unter anderem folgende Endpunkte:

• GET /{ad-account-id}/delivery_estimate - Ad account delivery estimates
• GET /{adset-id}/delivery_estimate - Ad set delivery estimates

Die vollständige Liste der Felder und Endpunkte wird im Änderungsprotokoll für Version 26.0 verfügbar sein.

Graph API: Einstellung der Commerce Order Management API

Apps, die diese Endpunkte in der Graph API v26.0 und neuer aufrufen, werden ab dem 29. Juli 2026 blockiert. Die Endpunkte werden für alle verbleibenden Graph API-Versionen am 27. Oktober 2026 entfernt. Danach werden Aufrufe zu Fehlern führen.

Der Kaufabschluss direkt auf Facebook und Instagram für Shops wurde vollständig eingestellt. Mit der Commerce Order Management API konnten Drittanbieter-Plattformen Bestellungen auflisten, Bestelldetails anzeigen, Lieferungen verwalten, Stornierungen verarbeiten, Rückerstattungen abwickeln und Rücksendungen für dieses Checkout-Erlebnis verfolgen. Da die zugrunde liegende Infrastruktur für Commerce-Bestellungen stillgelegt wird, werden diese Endpunkte eingestellt.

Entwickler*innen sollten diese Endpunkte nicht mehr aufrufen und die Abhängigkeit entfernen. Es gibt keine Ersatz-API.

Betroffen sind unter anderem folgende Endpunkte:

• GET /{commerce-order-id} - Order details
• GET /{commerce-order-id}/items – Bestellungsposten
• GET /{commerce-order-id}/payments - Order payments
• GET /{commerce-order-id}/payment_transaction_details - Zahlungstransaktionsdetails
• GET /{commerce-order-id}/refunds - Order refunds
• GET /{commerce-order-id}/shipments - Order shipments
• GET /{commerce-order-shipment-id}/items – Versand-Positionen
• GET /{commerce-return-id} - Return details
• GET /{commerce-order-cancellation-id}/items - Cancellation line items
• GET /{page-id}/commerce_orders - List orders by Page
• GET /{commerce-merchant-settings-id}/commerce_orders – Bestellungen nach Commerce-Händler-Einstellungen auflisten
• GET /{commerce-merchant-settings-id}/commerce_returns - List returns by Commerce Merchant Settings
• GET /{commerce-merchant-settings-id}/tax_settings - Tax settings

Die vollständige Liste der 47 betroffenen Endpunkte wird im Änderungsprotokoll für Graph API v26.0 verfügbar sein.

Graph API: Felder zur Eigentümerschaft im Rights Manager wurden zu „RightsHolderOwner“ migriert

Die Felder reference_owner und matched_reference_owner für „AudioVisualReferenceMatch“ und „ImageReferenceMatch“ sowie die Felder sending_rights_holder und receiving_rights_holder für „CopyrightOwnershipTransfer“ werden eingestellt. Ab Graph API v26.0 sind Ersatzfelder verfügbar, die den dedizierten RightsHolderOwner-Typ zurückgeben, um das vom Rights Manager verwendete Eigentumsmodell besser darzustellen. Die eingestellten Felder werden in den Antworten der Version v26.0 und neuer nicht mehr zurückgegeben.

Die eingestellten Felder werden nach dem Start von v26.0 noch zwei Jahre lang in v25.0 und früheren Versionen funktionieren. Danach werden sie entfernt. Entwickler*innen sollten innerhalb dieses Zweijahreszeitraums auf die Ersatzfelder umsteigen.

Verwende die folgenden Ersatzfelder:

• Verwende reference_owner_rh_owner anstelle von reference_owner.
• Verwende matched_reference_owner_rh_owner anstelle von matched_reference_owner.
• Verwende sending_rights_holder_owner anstelle von sending_rights_holder.
• Verwende receiving_rights_holder_owner anstelle von receiving_rights_holder.

Betroffen sind unter anderem folgende Endpunkte:

• GET /{audio-visual-reference-match-id} – Referenzübereinstimmungsdetails
• GET /{image-reference-match-id} - Image reference match details
• GET /{copyright-ownership-transfer-id} - Ownership transfer details

Die vollständige Feldliste wird im Änderungsprotokoll für Graph API v26.0 verfügbar sein.

Graph API: Legacy-Protokollfunktionen eingestellt

Ab dem 29. Juli 2026 unterstützen Graph API v26.0 und höher fünf alte Protokollverhaltensweisen nicht mehr: pretty, debug, date_format, Root-GET /?ids=...-Anfragen und die alte If-None-Match-/ETag-Handhabung.

Diese Verhaltensweisen werden eingestellt, um die Graph API-Antworten zu vereinfachen und die Anfrageverarbeitung konsistenter zu gestalten.

Für Graph API v26.0 und neuer:

• pretty wird ignoriert und JSON-Antworten verwenden eine kompakte Formatierung. Formatiere JSON in Client-Tools oder Code.
• debug wird ignoriert und es wird kein Debug-Antwort-Envelope hinzugefügt. Nutze Standard-Debugging-Tools. Der debug_token-Endpunkt ist nicht betroffen.
• Anfragen mit date_format führen zu einem Parameter-Fehler. Verwende das standardmäßige Datumsformat und konvertiere bei Bedarf Werte lokal.
• Stamm-Requests mit GET /?ids=... geben einen Parameter-Fehler zurück. Verwende Anfragen pro Objekt oder unterstütztes Batching.
• If-None-Match wird ignoriert. Die alten ETag-Antwort-Header und das 304 Not Modified-Verhalten werden entfernt und Anfragen geben vollständige Antworten zurück.

Ab dem 27. Oktober 2026 gelten diese Änderungen für alle verbleibenden unterstützten Graph API-Versionen. Sieh dir die Runtime-Anfrageprotokolle und das Änderungsprotokoll für die Graph API v26.0 an, um Details zur Migration zu erhalten.

Einstellung von veralteten Seitenfeldern für die neue Seitenversion (Graph API v26.0)

Entwickler-Blog: Entwurf für Beitrag. Ziel-Release: Graph API v26.0. Art der Änderung: Einstellung (90 Tage).

Zusammenfassung

Für die neue Seitenversion werden fünf alte Seiten-Node-Felder (current_location, genre, network, parking, start_info) und die Seiteneinstellung auto_publish_page_info_updates ab Graph API v26.0 eingestellt. Diese Felder werden nicht mehr gepflegt und sollten für Seiten mit dem neuen Erlebnis nicht mehr genutzt werden.

Zeitplan

• 29. Juli 2026: Die Felder werden blockiert und die Einstellung wird ab Version 26.0 für Seiten mit neuem Erlebnis entfernt.
• Etwa 90 Tage nach dem Launch: Die gleiche Änderung gilt für alle übrigen Versionen. Das genaue Datum im späten Oktober 2026 muss noch bestätigt werden.

Was sich ändert

Ab Version 26.0 führt die Anforderung eines dieser fünf Felder für eine Seite (neue Seitenversion) zu einem Versionsfehler. Außerdem wird die Einstellung auto_publish_page_info_updates nicht mehr in der Antwort zu den Seiteneinstellungen zurückgegeben. Bei früheren Versionen bleibt das Verhalten unverändert, bis das 90-tägige Migrationsfenster geschlossen wird. Danach gilt das Gleiche für alle Versionen.

Betroffene Endpunkte:

• GET /{page-id}?fields=current_location
• GET /{page-id}?fields=genre
• GET /{page-id}?fields=network
• GET /{page-id}?fields=parking
• GET /{page-id}?fields=start_info
• GET /{page-id}?fields=settings – die auto_publish_page_info_updates-Einstellung wird aus der zurückgegebenen Einstellungsliste entfernt

Was Entwickler*innen tun sollten

• Entferne diese Felder und die auto_publish_page_info_updates-Einstellung aus deinen Seitenanfragen.
• Überprüfe deine Anfrageprotokolle, Kundenintegrationen und Dashboards auf die Verwendung dieser Felder auf Seiten der New Pages Experience.
• Die vollständige, aktuelle Liste findest du im Änderungsprotokoll für Graph API v26.0.

Referenz

• Seiten-Node-Referenz

Marketing API: Advantage+ Audience-Anforderungen für Kampagnen zu Wohnraum, Jobangeboten bzw. Finanzprodukten und -dienstleistungen

Ab dem 29. Juli 2026 wird mit Marketing API v26.0 der Parameter advantage_audience innerhalb von targeting_automation für vollständig standardmäßige oder gelockerte Zielgruppenkonfigurationen automatisch auf 1 gesetzt. Bei eingeschränkten Zielgruppen-Einstellungen müssen Entwickler*innen advantage_audience explizit auf entweder 1 oder 0 für Kampagnen in den speziellen Anzeigenkategorien „Wohnraum“, „Beschäftigung“ oder „Finanzprodukte und -dienstleistungen“ setzen.

Dieses Verhalten gilt nur beim Erstellen einer neuen Anzeigengruppe. Beim Aktualisieren vorhandener Anzeigengruppen tritt dieses Verhalten in keiner API-Version auf.

Dieses Verhalten wurde bereits für Kampagnen außerhalb der speziellen Anzeigenkategorien in der Marketing API v23.0 eingeführt. Weitere Informationen findest du in der Dokumentation zur Fehlerbehebung für Advantage+ Audience.

Die folgenden API-Endpunkte sind betroffen:

• POST /{ad-account-id}/adsets
• POST /{adset-id}
• POST /{adset-id}/copies

Marketing API: Anzeigenplatzierung in Explore nicht mehr verfügbar

Ab dem 29. Juli 2026 ist die Platzierung im Instagram Explore-Feed mit der Einführung der Marketing API v26.0 nicht mehr verfügbar. Die Auslieferung in Explore wird eingestellt und die Kampagnenausgaben werden automatisch auf andere zulässige Platzierungen verschoben.

Wenn du versuchst, eine Anzeigengruppe zu erstellen oder zu aktualisieren, die die Explore-Platzierung angibt, wird ein Fehler zurückgegeben. Entwickler*innen sollten Explore aus den Platzierungskonfigurationen entfernen und andere zulässige Platzierungen nutzen.

Die folgenden Endpunkte sind betroffen:

• POST /act_{ad-account-id}/adsets
• POST /{ad-set-id}

Marketing API: Einstellung des reinen Web-Ziels für Web+App-Kampagnen

Ab dem 29. Juli 2026 können Entwickler*innen mit Marketing API v26.0 keine Anzeigengestaltung mehr an eine Anzeige in einer Kampagne anhängen, die „Website und App“ als Conversion-Orte verwendet, wenn für applink_treatment der Wert web_only festgelegt ist. Dies betrifft die Anzeigenerstellung und Updates über POST /act_{ad-account-id}/ads und POST /{ad-id}.

Der Endpunkt der Anzeigengestaltung ändert sich nicht, aber POST /act_{ad-account-id}/adcreatives ist die Stelle, an der der applink_treatment-Wert konfiguriert wird. Entwickler*innen sollten ihre Integrationen für applink_treatment=web_only überprüfen und die automatische Zielauswahl oder ein anderes kompatibles manuelles Ziel für Website- und App-Kampagnen verwenden.

Am 27. Oktober 2026, 90 Tage nach der Veröffentlichung von v26.0, gilt diese Einschränkung für alle Marketing API-Versionen. Weitere Informationen findest du in der Dokumentation zu Anzeigen und zur Anzeigengestaltung.

Marketing API: Platzierung „Messenger Stories“ eingestellt

Ab dem 29. Juli 2026 ist der Wert story in messenger_positions bei versionierten Aufrufen ab Marketing API v26.0 zum Erstellen oder Aktualisieren von Anzeigengruppen nicht mehr verfügbar.

Bei diesen Aufrufen wird story stillschweigend aus der Targeting-Spezifikation entfernt und erscheint nicht mehr in den effektiven Platzierungen neuer oder bestehender Anzeigengruppen. Targeting-Daten aus der Vergangenheit können weiterhin story enthalten, wenn sie über GET /{ad_set-id}?fields=targeting abgefragt werden. Es wird kein spezifischer Fehler ausgegeben, aber es können Standardfehler bei der Platzierungsüberprüfung auftreten, wenn beim Entfernen von story eine ungültige Platzierungskonfiguration zurückbleibt.

Die folgenden Endpunkte sind betroffen:

• POST /act_{ad-account-id}/adsets
• POST /{ad_set-id}

Entwickler*innen, die manuelle Platzierungen verwenden, sollten story aus messenger_positions entfernen. Wenn dies der einzige Wert ist, entferne das gesamte messenger_positions-Feld und erwäge, messenger aus publisher_platforms zu entfernen, wenn keine andere Messenger-Platzierung wie marketing_messages verwendet wird. Für Advantage+-Platzierungen ist keine Handlung erforderlich.

Diese API-spezifische Änderung hat keine Auswirkungen auf den Werbeanzeigenmanager. Aufrufe ohne Versionsangabe und Aufrufe an Versionen vor v26.0 sind zunächst nicht betroffen. Am 27. Oktober 2026, 90 Tage nach der Veröffentlichung von Version 26.0, wird die Abschaffung auf alle Versionen der Marketing API angewendet, einschließlich Aufrufe, die keine Version angeben.

Marketing API: Das Erstellen von Abstimmungsannoncen ist veraltet

Ab der Marketing API-Version 26.0 vom 29. Juli 2026 werden Umfragekomponenten beim Erstellen oder Aktualisieren von Werbeanzeigen und Anzeigengestaltungen nicht mehr unterstützt. Das Feld poll_spec und der Wert "poll" für das Feld type sind unter interactive_components_spec nicht mehr verfügbar.

Anfragen, die eine Abstimmungsgestaltung erstellen oder eine Anzeige so ändern, dass sie eine Abstimmungsgestaltung verwendet, werden abgelehnt. Du kannst jedoch weiterhin bestehende Anzeigen aktualisieren, ohne die Anzeigengestaltung zu verändern. Dazu zählen Änderungen am Status, am Budget oder am Zeitplan.

Die folgenden Endpunkte sind betroffen:

• POST /{ad_account_id}/adcreatives
• POST /{ad_account_id}/ads
• POST /{ad_id}
• GET /{ad_account_id}/generatepreviews

Entwickler*innen sollten umfragebezogene Felder aus ihren Anzeigenspezifikationen entfernen und eine Anzeigengestaltung ohne Umfragekomponente verwenden. Aufrufe an Versionen vor v26.0 und nicht versionierte Aufrufe sind zunächst nicht betroffen.

Ab 27. Oktober 2026, 90 Tage nach der Veröffentlichung von Version 26.0, gilt diese Einstellung für alle Versionen der Marketing API.

Einführung der Meta-Business-SDKs v26

Das Meta-Business-SDK v26 wird kurz nach der Graph API v26 eingeführt. Diese Version enthält Abhängigkeits-Upgrades, die Integration des Conversions API Parameter Builder, neue API-Funktionen und die Abschaffung der Commerce Order Management API sowie mehrerer veralteter Protokollfunktionen.

Das Business-SDK ist jetzt in den Open-Source Conversions API Parameter Builder integriert. Du kannst diese neue Integration nutzen, um die Qualität deiner Conversions API-Integration zu verbessern. Wichtige Features: Automatische Generierung (abhängig von den Einstellungen der Werbetreibenden) und Verbesserung der Parameter fbc, fbp, event_source_url, referrer_url, client_ip_address und automatische Normalisierung/Hashing personenbezogener Informationen für unterstützte Sprachen. Weitere Informationen findest du hier. Die Commerce Order Management API (47 Endpunkte) wird vollständig eingestellt und es gibt keine Alternative. Die Anzeigenplatzierung im Instagram Explore-Feed wurde entfernt und gibt Fehler zurück, wenn sie festgelegt wird. Die Platzierung „Messenger Stories“ wird stillschweigend aus messenger_positions entfernt. Werbeanzeigen im WhatsApp-Status erhalten neue Funktionen wie Identitätsspezifikation, Carousel mit bis zu 10 Karten und Optimierung für Offsite-Conversions.

Im Rahmen unseres zweijährigen Zeitplans für die Abkündigung von Platform-SDKs möchten wir dich auf die bevorstehenden Abkündigungen und Außerbetriebnahmen hinweisen:

• 27. September 2026: Facebook Platform-SDK v20.0 wird eingestellt
• Januar 2027: Facebook Platform-SDK v21.0 wird eingestellt

Abkündigungen von API-Versionen

Beachte bitte die folgenden bevorstehenden Entfernungen, die Teil des Versionierungszeitplans von Facebook für die Graph API sind:

Graph API

• 24. September 2026: Graph API v20.0 wird eingestellt und von der Plattform entfernt.
• 21. Januar 2027: Graph API v21.0 wird eingestellt und von der Plattform entfernt.

Um Unterbrechungen zu vermeiden, migriere alle Aufrufe zur aktuellen API-Version.