Graph API

Version 3.1

Veröffentlicht 26. Juli 2018 | Verfügbar bis 27. Oktober 2020 | Blog-Post

Allgemein

Diese Änderungen werden auf v3.1+ und alle Versionen ab dem 24. Oktober 2018 angewendet.

Alle Graph API-Endpunkte geben nun alle leeren Strukturen als {} und alle leere Listen als [] zurück.

Live API

Diese Änderungen werden auf v3.1+ und alle Versionen ab dem 24. Oktober 2018 angewendet.

Der Parameter type ist für die folgenden Edges veraltet. Er wurde durch einen neuen source-Parameter ersetzt.

  • /event/live_videos
  • /group/live_videos
  • /official_events/live_videos
  • /page/live_videos
  • /user/live_videos

Der neue source-Parameter kann einen von zwei möglichen Werten annehmen: target und owner. Mit der Abfrage der /live_videos-Edge eines Node mit source=target werden Live-Videos zurückgegeben, die an diesen Node gestreamt werden, während mit der Abfrage von source=owner von diesem Node gestreamte Live-Videos zurückgegeben werden.

Ereignis- und Gruppen-Nodes unterstützen nur target-Abfragen und einige target-Abfragen schlagen möglicherweise fehl, wenn du nicht über die Berechtigung zur Anzeige des targetierten Nodes verfügst.

Marketing API

Veröffentlicht 26. Juli 2018 | Verfügbar bis 14. Mai 2019 | Blog-Post

Werbeanzeigenverwaltung

  • Verhaltensbasierte Targeting-Kategorien: Einige in behaviors verwendete Optionen für das verhaltensbasierte Targeting sind jetzt veraltet. Wenn du versuchst, Werbeanzeigen mit einer dieser Kategorien zu erstellen, wird der Fehler The category you selected is no longer available. ausgegeben. Verwende Targeting-Suche, um für das Targeting verfügbare gültige Kategorien zu suchen.

  • VeraltetPAGE_ENGAGEMENTalsoptimization_goal: PAGE_ENGAGEMENT als ein optimization_goal für Werbekampagnen ist veraltet. Ab v3.1 kannst du Werbekampagnen, bei denen optimization_goal auf PAGE_ENGAGEMENT festgelegt ist, nicht mehr erstellen, aktualisieren oder duplizieren. Wenn du bereits bestehende Werbekampagnen hast, die vor v3.1 erstellt wurden, kannst du diese Kampagnen mit dieser Einstellung weiterhin ausführen. Du kannst auch weiterhin PAGE_ENGAGEMENT als Insights API-Aufschlüsselung für Daten zu bestehenden Werbekampagnen verwenden, die dieses optimization_goal verwenden.

  • Einzelbild-Page Like Ads ohne Beitrag veraltet: Ab v3.1 kannst du keine Einzelbild-Page Like Ads ohne Seitenbeitrag mehr erstellen. Stattdessen solltest du eine Page Like Ad mit einem Beitrag erstellen, siehe Werbeanzeige, Platzierung und Vorschau, Page Like Ads erstellen.

  • Kein Lead Ads Retrieval über Webhooks für Dev Tier: Wir senden keine in Lead Ads-Formularen erfassten Daten mehr über Webhooks an Apps im Entwicklungsmodus. Diese Änderung wird am 1. Februar 2019 wirksam.

    • Wenn du Updates in v3.1 abonnierst, senden wir nur dann Updates, wenn sich deine App im Produktionsmodus und im Live-Modus befindet.

    • Wenn du eine neue App erstellst, sobald v3.1 verfügbar ist, senden wir nur dann Updates, wenn sich deine App im Produktionsmodus und im Live-Modus befindet.

    • Wenn du eine bestehende App hast, muss sie bis zum 1. Februar 2019 im Live-Modus sein. Bis zu diesem Datum erhältst du weiterhin Updates im Entwicklungsmodus.

    Weitere Informationen zu den Zugriffsebenen und App-Modi der Marketing API findest du unter Neue Struktur für den Zugriff auf die Marketing API und Marketing API – Zugriff und Authentifizierung.

Ads Insights und Messung

  • Wir haben cost_per_store_visit und store_visits für die Insights API in cost_per_store_visit_actions und store_visit_actions umbenannt. Dies wirkt sich aus auf:

    • GET {adaccount-id}/insights,

    • GET {campaign-id}/insights,

    • GET {adset-id}/insights,

    • GET {ad-id}/insights,

    • POST {adaccount-id}/insights,

    • POST {campaign-id}/insights,

    • POST {adset-id}/insights und

    • POST {ad-id}/insights.

    Informationen zu den neu benannten Kennzahlen findest du unter Messung der Besuche im Geschäft. Beachte, dass die API für Besuche im Geschäft und die zugehörige Dokumentation nur eingeschränkt verfügbar sind. Kontaktiere deinen Facebook-Ansprechpartner, wenn du Zugriff benötigst.

Business Manager API

In v3.1 haben wir das neue Konzept der aufgabenbasierten Berechtigungen eingeführt und die aktuelle rollenbasierte Berechtigung damit ersetzt. Dies wirkt sich auf den Zugriff auf Werbekonten, die von Business Manager API verwaltet werden, und Seiten aus. Rollenbasierter Zugriff auf Werbekonten und Seiten ist nach wie vor verfügbar, wird aber eingestellt. Dies betrifft die folgenden Rollen und stellt die entsprechenden Aufgaben für Werbekonten bereit:

Rolle Aufgaben Beschreibung

ADMIN

['MANAGE', 'ADVERTISE', 'ANALYZE']

Alle Aspekte von Werbekampagnen, Berichterstellung, Abrechnung und Werbekontoberechtigungen verwalten.

GENERAL_USER

['ADVERTISE', 'ANALYZE']

Werbeanzeigen über die dem Werbekonto zugeordnete Finanzierungsquelle erstellen. Berichte ausführen.

GENERAL_USER

['ANALYZE']

Berichte ausführen.

Damit werden die folgenden Rollen in Business Manager API durch diese Aufgaben ersetzt:

Rolle Aufgaben

MANAGER

['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']

CONTENT_CREATOR

['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']

MODERATOR

['MODERATE', 'ADVERTISE', 'ANALYZE']

ADVERTISER

['ADVERTISE', 'ANALYZE']

INSIGHTS_ANALYST

['ANALYZE']

Was die Verwaltung von Facebook-Pixel betrifft, wirkt sich dies auf die folgenden Rollen aus und führt neue Aufgaben ein:

Rolle Aufgaben

PIXEL_EDITOR

['EDIT', 'ANALYZE']

PIXEL_ANALYST

['ANALYZE']

Im Rahmen dieser Änderung werden die folgenden Business Management API-Felder eingestellt und durch die folgenden ersetzt:

Gebiet Veraltet Neues Feld

GET {adaccount-id}/users

permissions, role

tasks

POST {adaccount-id}/users

role, uidRoles, emailRoles

tasks

GET {user-id}/adaccounts

permissions, role

tasks

GET {user-id}/assigned_ad_accounts

role, permitted_role

tasks, permitted_tasks

GET {user-id}/assigned_pages

role, permitted_role

tasks, permitted_tasks

GET {adaccount-id}/assigned_users

role, permitted_role

tasks, permitted_tasks

POST {adaccount-id}/assigned_users

role

tasks

GET {page-id}/assigned_users

role, permitted_role

tasks, permitted_tasks

POST {page-id}/assigned_users

role

tasks

GET {fb-pixel-id}/assigned_users

role, permitted_role

tasks, permitted_tasks

GET {adaccount-id}/userpermissions

role

tasks

POST {adaccount-id}/userpermissions

role

tasks

GET {page-id}/userpermissions

role

tasks

POST {page-id}/userpermissions

role

tasks

GET {business-id}/client_ad_accounts

permitted_role

permitted_tasks

POST {business-id}/client_ad_accounts

permitted_role

permitted_tasks

GET {business-id}/client_pages

permitted_role

permitted_tasks

POST {business-id}/client_pages

permitted_role

permitted_tasks

GET {business-id}/client_pixels

permitted_role

permitted_tasks

GET {adaccount-id}/agencies

permitted_role

permitted_tasks

POST {adaccount-id}/agencies

permitted_role

permitted_tasks

GET {page-id}/agencies

permitted_role

permitted_tasks

POST {page-id}/agencies

permitted_role

permitted_tasks

GET {business-id}/pending_client_pages

permitted_role

permitted_tasks

GET {business-id}/pending_client_ad_accounts

permitted_role

permitted_tasks

Dieses neue Design wirkt sich auch auf Pages API aus, siehe Graph API 3.1, Pages API, Funktionsgefährdende Änderungen. Business Manager API-Dokumentation siehe:

Messenger-Plattform

Für vor dem 26. Juli 2018 erstellte Apps werden diese Änderungen am 8. Januar 2019 wirksam. Für nach dem 26. Juli 2018 erstellte Apps werden diese Änderungen sofort wirksam.

Die User Profile API gibt nun standardmäßig nur first_name-, last_name- und profile_pic-Felder zurück. Für zusätzliche Felder ist nun eine Produkt-Review über die Registerkarte „Messenger-Plattform“ des App-Dashboards erforderlich.

Die last_ad_referral- und is_payment_enabled-Felder sind veraltet und werden am 30. Oktober 2018 aus der API entfernt.

Mutual Friends API

Diese Änderungen werden auf v3.1+ und alle Versionen ab dem 24. Oktober 2018 angewendet.

Die Mutual Friends API wurde am 4. April 2018 eingestellt und die Endpunkte unten haben ab diesem Zeitpunkt leere Datensätze zurückgegeben. Die Endpunkte sind nun vollständig eingestellt und geben eine Fehlermeldung zurück.

  • /user-context/all_mutual_friends
  • /user-context/mutual_friends
  • /user-context/three_degree_mutual_friends

Pages API

Berechtigungen

Diese Änderungen werden auf v3.1+ und alle Versionen ab dem 1. Februar 2019 angewendet.

Für die pages_manage_cta-Berechtigung ist nun App Review für alle POST- und DELETE-Anfragen erforderlich. Vor dem 26. Juli 2018 erstellte Apps können diese Berechtigung weiter verwenden, müssen sie jedoch vor dem 1. Februar 2019 zur Überprüfung einreichen, um pages_manage_cta weiter verwenden zu können.

Seitenrollen

Die folgenden Änderungen gelten für v3.1+.

Seitenrollen werden demnächst eingestellt und durch Seitenaufgaben ersetzt. Anstatt auf einer Seite eine Nutzerrolle zu gewähren, musst du nun dem Nutzer ihre Entsprechung in den Aufgaben gewähren.

RolleEntsprechende Aufgaben

Admin

ADVERTISE, ANALYZE, CREATE_CONTENT, MANAGE, MODERATE

Advertiser

ADVERTISE, ANALYZE

Analyst

ANALYZE

Editor

ADVERTISE, ANALYZE, CREATE_CONTENT, MODERATE

Moderator

ADVERTISE, ANALYZE, MODERATE

Bis zur vollständigen Ersetzung rollenbasierter Berechtigungen durch aufgabenbasierte Berechtigungen musst du bei der Gewährung von Aufgaben über /page/roles alle entsprechenden Aufgaben der Rolle gewähren. Andernfalls schlägt der POST-Vorgang fehl.

Zur Unterstützung dieser Änderungen wurden die perms- und role-Felder eingestellt und durch ein neues tasks-Feld ersetzt. Dies wirkt sich auf die folgenden Edges aus:

  • /me/accounts
  • /page/roles
  • /user/accounts

Im Änderungsprotokoll zur Marketing API findest du Informationen darüber, wie sich diese Änderungen auf die Marketing API und die Business Manager API auswirken.

Webhooks

Diese Änderungen werden auf v3.1+ und alle Versionen ab dem 24. Oktober 2018 angewendet.

Die folgenden Nutzer-Webhook-Felder sind veraltet:

  • pic_big_with_logo
  • pic_small_with_logo
  • pic_square_with_logo
  • pic_with_logo

Die folgenden Nutzer-Webhook-Felder verwenden nun HTTPS-URLs anstatt HTTP.

  • pic
  • pic_big
  • pic_small
  • pic_square
  • picture

Zusätzlich werden die URLs für diese Felder auslaufen – dies wirkt sich mit sofortiger Wirkung auf alle API-Versionen aus.