Version 2.5

Graph API | Marketing API

Graph API v2.5

Veröffentlicht am 07. Oktober 2015 | Verfügbar bis 12. April 2018

Neue Funktionen

• Seiten
• Videos

Seiten

• Berechtigungen

  • GET {user_id}/accounts erfordert jetzt entweder manage_pages oder pages_show_list. Letzteres ist eine neue Berechtigung in v2.5.
  • POST {page_id}/call_to_actions und POST/DELETE {call-to-action-id} erfordern die neue Berechtigung pages_manage_cta, die in Version 2.5 eingeführt wird.

• Verwalten von Calls to Action: Die Seiten-API kann jetzt Calls to Action auf einer Seite verwalten:

  • GET page/call_to_actions oder GET {call-to-action-id}, um einen Call to Action zu lesen.
  • POST page/call_to_actions, um einen Call to Action zu einer Seite hinzuzufügen.
  • POST {call-to-action-id} zum Aktualisieren.
  • DELETE {call-to-action-id}, um einen Call to Action von einer Seite zu löschen.

• Place-Node: Das folgende Feld wurde zum Place-Node hinzugefügt:

  • overall_rating: Damit wird die durchschnittliche Bewertung basierend auf den öffentlichen Bewertungen eines Orts angegeben.

Videos

• Video-Upload: Folgende Parameter wurden hinzugefügt:

  • slideshow_spec: Erstelle Slideshow-Videos, indem du Bilder hochlädst.
  • secret: Mit diesem Parameter wird das veröffentlichte Video nicht im Facebook-News Feed, der Chronik oder den Video-Tabs einer Seite angezeigt und kann nicht gesucht werden. Ein Video kann nur mit Permalink angezeigt und geteilt werden. Nur für Seitennutzer.
  • social_actions: Ermögliche oder verhindere die Nutzung von sozialen Facebook-Handlungen, wie „Gefällt mir“-Angaben, Kommentare und Teilen, für verborgene Videos. Nur für Seitennutzer.

• Videobearbeitung: Folgende Parameter wurden hinzugefügt:

  • publish_to_videos_tab: Poste Videoelemente öffentlich auf dem Tab „Videos“ der Seite, aber nicht im News Feed oder in der Chronik.
  • publish_to_news_feed: Poste Videoelemente öffentlich im News Feed, in der Chronik und im Tab „Videos“ der Seite.

Änderungen

• Seiten
• Beiträge
• Nutzer
• Webhooks

Seiten

• Endpunkt für markierte Beiträge: GET /{page-id}/tagged umfasst alle öffentlichen Beiträge, in denen die Seite markiert ist. Du benötigst einen Seiten-Zugriffsschlüssel mit der Berechtigung manage_pages.

Beiträge

• story_tags: Gibt ab sofort ein Array und kein Objekt zurück.

Nutzer*innen

• GET /{user-id}?fields=address gibt einen Fehler zurück: Das address-Feld, das in früheren Versionen verfügbar war und einen leeren Wert zurückgab, gibt ab Version 2.5 einen Fehler zurück.

Webhooks (früher Echtzeit-Updates)

• Abonnements automatisch deaktivieren: Wir deaktivieren Webhooks-Abonnements nun automatisch, wenn die Rückruf-URL 7 aufeinander folgende Tage lang fehlschlägt. Du kannst das Abonnement mit einer POST-Anfrage an /subscriptions wieder aktivieren. Diese Änderung gilt nicht für Zahlungsabonnements.

• Aktualisieren bestehender Abonnements: Bestehende Webhooks-Abonnements können über die /subscriptions-API geändert werden. POST /subscriptions ergänzt das Abonnement für das jeweilige Thema, ohne die vorhandenen Felder zu überschreiben. Du kannst bestimmte Felder aus deinem Abonnement löschen, indem du einen Feldparameter beim Aufruf von DELETE /subscriptions angibst.

Veraltete Elemente

• Keine veralteten Elemente.

Funktionsgefährdende Änderungen nach 90 Tagen

• Seiten
• Webhooks

Seiten

• URI-Format für Page Tab Apps – Das URI-Format für Page Tab Apps https://www.facebook.com/{vanity}?v={app_id} funktioniert nur noch innerhalb der ersten 90 Tage nach der Einführung dieser Version. Verwende bitte https://www.facebook.com/{vanity}?sk={app_id} oder https://www.facebook.com/{vanity}/{app_id}.

Webhooks

• Neue Echtzeit-Updates nur über HTTPS – Neue Abonnements können ausschließlich mit einer HTTPS-Rückruf-URL erstellt werden. Dies betrifft Updates für User, Page, App und Payment.