Änderungsprotokoll für die Instagram-Plattform

Dieses Änderungsprotokoll bezieht sich auf die vorgenommenen Änderungen an den Instagram-APIs.

Verwandte Änderungsprotokolle

• Änderungsprotokoll der Graph API
• Änderungsprotokoll der Messenger-Plattform (beinhaltet Instagram Messaging)
• Änderungsprotokoll der Marketing API

3. Oktober 2024

Willkommen bei Messaging-Flows, die jetzt für Instagram API mit Instagram-Anmeldung verfügbar sind. Mehr erfahren.

2. Oktober 2024

17. September 2024

Neue scope-Werte

Gilt für alle Versionen.

Damit scope-Werte und Berechtigungsnamen einheitlich sind, führen wir neue scope-Werte für die Instagram API mit Instagram-Login ein. Die neuen scope-Werte sind:

• instagram_business_basic
• instagram_business_content_publish
• instagram_business_manage_comments
• instagram_business_manage_messages

Diese ersetzen die bestehenden Werte business_basic, business_content_publishing, business_manage_comments bzw. business_manage_messages.

Bitte beachte, dass die alten scope-Werte am 27. Januar 2025 eingestellt werden. Es ist wichtig, dass du deinen Code vor diesem Datum aktualisierst, um Störungen bei der Funktionalität deiner App zu vermeiden. Andernfalls kann die App die Instagram-Endpunkte nicht aufrufen.

Korrektur: Das Einstellungsdatum wurde vom 17. Dezember 2024 auf den 27. Januar 2025 verschoben.

23. Juli 2024

Launch der neuen Instagram-API mit Instagram-Login.

Komponenten dieser neuen Instagram-API:

• Eine Facebook-Seite ist nicht mehr erforderlich.
• Die Host-URL für API-Aufrufe lautet graph.instagram.com.
• Neue Berechtigungen für diese API:

  • instagram_business_basic
  • instagram_business_content_publish
  • instagram_business_manage_comments
  • instagram_business_manage_messages
• Die Messenger API wird nicht mehr zum Senden von Instagram-Nachrichten verwendet.
• Wenn eine Meta-App erstellt wird, wird bei neuen Apps das neue Instagram-Produkt hinzugefügt.
• Vorhandene Apps können das neue Instagram-Produkt im App-Dashboard hinzufügen.

Besuche unseren Migrationsleitfaden, wenn diese neue Instagram-API mit Instagram-Login für dich das Richtige ist.

11. Juni 2024

Webhooks für Instagram-Kommentare

Gilt für alle Versionen.

Zusätzlich zu ad_id und ad_title wird die original_media_id im media-Objekt des value-Objekts des comments-Felds zurückgegeben, wenn eine Person einen beworbenen Instagram-Post oder Instagram-Werbeanzeigen-Post kommentiert. Mehr darüber erfährt du unter Einrichten von Webhooks für Instagram.

21. Mai 2024

12. September 2023

9. November 2022

Instagram-Webhooks

Gilt für alle Versionen.

ad_id und ad_title werden im media-Objekt des value-Objekts des comments-Felds zurückgegeben, wenn eine Person einen beworbenen Instagram-Post oder Instagram-Werbeanzeigen-Post kommentiert.

31. Oktober

Reels – Produktmarkierungen

Gilt für alle Versionen.

Die Instagram Produktmarkierungs-API ist für Reels verfügbar. Du kannst bis zu 30 Produkte markieren, wenn du ein Reel veröffentlichst.

28. Juni 2022

27. Juni 2022

20. Juni 2022

27. Mai 2022

Produktvarianten

Gilt für alle Versionen.

Für Partner mit der Beta-Version für Produktmarkierungen werden jetzt alle Produktvarianten, die die Suchkriterien einer Anfrage erfüllen, zurückgegeben, wenn ein Katalog nach Produkten durchsucht wird.

15. März 2022

9. November 2021

20. Oktober 2021

5. Oktober 2021

8. Juni 2021

Anzahl der „Gefällt mir“-Angaben

Gilt ab Version 11.0. Gilt ab dem 7. September 2021 für alle Versionen.

Bei der indirekten Abfrage eines IG-Medien-Objekts über einen anderen Endpunkt oder eine Felderweiterung wird das Feld like_count bei API-Antworten ausgelassen, wenn der*die Medien-Eigentümer*in die Anzahl der „Gefällt mir“-Angaben dafür verborgen hat. Die direkte Abfrage des IG-Medien-Objekts (die nur durch den*die Eigentümer*in des IG-Medien-Objekts ausgeführt werden kann) gibt die tatsächliche Anzahl der „Gefällt mir“-Angaben zurück, auch wenn „Gefällt mir“-Angaben verborgen sind.

Zeitbasierte Paginierung

Gilt ab Version 11.0.

Die Parameter since und until wurden zum GET /{ig-user-id}/media-Endpunkt hinzugefügt, um die zeitbasierte Paginierung zu unterstützen.

26. Mai 2021

4. Mai 2021

14. April 2021

12. April 2021

Kleinerer Fehler im Zusammenhang mit Kennzahlen für Story-IG-Medien behoben.

9. April 2021

16. März 2021

IGTV-Medien werden nun in v10.0+ unterstützt. Das gilt für alle Endpunkte außer diejenigen, die für Content-Veröffentlichung und Webhooks verwendet werden. Um diese Änderung zu unterstützen, haben wir neue media_product_type- und video_title-Felder zum IG Media-Node hinzugefügt. IGTV-Medien müssen bei Veröffentlichung auf Instagram geteilt werden (während Vorschau posten oder Vorschau im Feed teilen aktiviert ist), damit über die API darauf zugegriffen werden kann.

26. Januar 2021

Die Betaversion der Content-Veröffentlichung wurde beendet. Alle Entwickler*innen können jetzt Medien über professionelle Instagram-Konten veröffentlichen. Details zur Verwendung findest du im Leitfaden zur Content-Veröffentlichung.

2. Dezember 2020

Gemäß der Datenschutzrichtlinie für elektronische Kommunikation der Europäischen Union werden Messaging-bezogene Story-IG-Medien-Interaktionen von Nutzer*innen im Europäischen Wirtschaftsraum (EWR) ab dem 1. Dezember 2020 in einigen Kennzahlenberechnungen nicht mehr berücksichtigt:

• Für Stories, die von Nutzer*innen im EWR erstellt werden, gibt die replies-Kennzahl nun den Wert 0 zurück.
• Für Stories, die von Nutzer*innen außerhalb des EWR erstellt werden, gibt die replies-Kennzahl die Anzahl der Antworten zurück. Antworten von Nutzer*innen im EWR werden jedoch bei dieser Berechnung nicht berücksichtigt.

Diese Änderung gilt für alle Versionen.

10. November 2020

• IG-Nutzer*innen-Insights: Die follower_count-Werte orientieren sich jetzt enger an den entsprechenden Werten, die in der Instagram-App angezeigt werden. Außerdem gibt follower_count jetzt Daten für maximal 30 Tage anstatt für 2 Jahre zurück. Diese Änderung gilt für v9.0+ und wird am 9. Mai 2021 auf alle Versionen angewendet.

5. Mai 2020

• Hashtag-Suche: Diese Änderung gilt für v7.0+. Du kannst jetzt das timestamp-Feld für IG-Medien-Objekte anfragen, die von GET /{ig-hashtag-id}/top_media- und GET /{ig-hashtag-id}/recent_mediaHashtag-Such-Anfragen zurückgegeben werden. Beispiel: GET /{ig-hashtag-id}/top_media?fields=timestamp.

3. Dezember 2019

• Insights: Damit das API-Verhalten dem Verhalten der Instagram-App entspricht, sind Insights zu IG-Nutzer*innen jetzt nur für IG-Nutzer*innen mit mindestens 100 Follower*innen verfügbar.

13. August 2019

• Business Discovery: Die Business Discovery API kann jetzt dazu genutzt werden, Daten zu anderen Instagram Creator-Konten abzurufen.

22. Mai 2019

• Instagram Creator*innen-Konten: Die API unterstützt jetzt Instagram Creator*innen-Konten mit zwei Ausnahmen. (1) Die Content Publishing API kann nicht von Instagram-Creator*innen verwendet werden, und (2) die Business Discovery API kann von Creator*innen verwendet werden, aber nur Unternehmen ansprechen.

9. Mai 2019

• Webhooks: Das story_insights-Feld erfordert jetzt die Berechtigung instagram_manage_insights anstelle von instagram_manage_comments.

31. Oktober 2018

• Hashtag Search API: Mit unserer neuen Hashtag Search API kannst du jetzt nach Medien suchen, die mit bestimmten Hashtags markiert sind. #spooky!

23. Oktober 2018

• /{ig-media-id}/comments-Edge: GET-Anfragen, die mit API-Version 3.1 oder früher gesendet werden, geben Ergebnisse in chronologischer Reihenfolge zurück. Die Ergebnisse für mit Version 3.2+ erstellte Anfragen werden in umgekehrter chronologischer Reihenfolge zurückgegeben.

7. Juni 2018

• /{ig-media-id}-Node: Du kannst das permalink-Feld für Medienobjekte jetzt mit Felderweiterung abrufen.

1. Mai 2018

• Unternehmensverifizierung: Zur Nutzung der Instagram Graph API ist für alle Apps eine Unternehmensverifizierung erforderlich. Diese ist Teil des App Review-Vorgangs und wird nun für alle Instagram Graph API-Endpunkte benötigt. Vor dem 1. Mai 2018 überprüfte Apps müssen bis zum 1. August 2018 erneut überprüft werden. Andernfalls geht der Zugriff auf die API verloren.

24. April 2018

• /{ig-comment-id}-Node:

  • Neues username-Feld hinzugefügt.
  • Bei GET-Anfragen wird das user-Feld nur in die Antworten aufgenommen, wenn der*die Nutzer*in, von dem*der die Anfrage stammt, Eigentümer*in des Kommentars ist. Stattdessen wird username für alle Kommentarersteller*innen zurückgegeben. Das gilt auch für Abfragen von Kommentaren, die über andere APIs wie die Mentions API erstellt wurden.
• /{ig-media-id}-Node:

  • Neues username-Feld hinzugefügt.
  • Bei GET-Anfragen wird das owner-Feld nur in die Antworten aufgenommen, wenn der*die Nutzer*in, von dem*der die Anfrage stammt, Eigentümer*in des Medienobjekts ist. Stattdessen wird username für alle Kommentarersteller zurückgegeben. Das gilt auch für Abfragen von Medienobjekten, die über APIs wie die Mentions API erstellt wurden.

23. April 2018

• Insights API: Insights enthalten jetzt Werbeaktivitäten, die über die API, Facebook-Werbeschnittstellen und das Feature „Hervorheben“ von Instagram generiert wurden. Das wirkt sich auf die folgenden Kennzahlen aus:

  • impressions
  • reach

13. März 2018

• Content Publishing API: Betapartner können jetzt mit der /{ig-user-id}/media-Edge Standorte und öffentliche Instagram-Nutzer*innen beim Veröffentlichen von Fotos markieren.

8. März 2018

• Öffentliche Felder: Das timestamp-Feld im /{ig-media-id}-Node ist jetzt ein öffentliches Feld und kann über die Felderweiterung zurückgegeben werden.

22. Februar 2018

• Öffentliche Felder: Die Nodes /{ig-user-id}, /{ig-comment-id} und /{ig-media-id} geben jetzt alle öffentlichen Felder zurück, wenn über eine Edge mit Felderweiterung darauf zugegriffen wird. In den Referenzdokumenten der einzelnen Nodes findest du heraus, welche Felder öffentlich sind.

8. Februar 2018

• Content Publishing API: Betapartner können jetzt Hashtags beim Veröffentlichen von Fotos über die /{ig-user-id}/media-Edge angeben. #crazywildebeest FTW!