Instagram Graph API

Veröffentlichung von IG-Nutzer*innenmedien

Veröffentlicht einen IG-Container für eine*n Instagram Business-IG-Nutzer*in. Die vollständigen Schritte zur Veröffentlichung findest du im Leitfaden zur Content-Veröffentlichung.

Erstellen

POST /{ig-user-id}/media_publish

Veröffentlicht ein IG Medien-Objekt für eine*n Instagram Business-IG-Nutzer*in.

Einschränkungen

  • Für Instagram-Konten können innerhalb von 24 Stunden maximal 25 Beiträge über die API veröffentlicht werden.
  • Wenn die mit dem Instagram-Business-Zielkonto verbundene Seite eine Page Publishing Authorization (PPA) erfordert, muss diese durchgeführt werden. Andernfalls schlägt die Anfrage fehl.
  • Wenn die mit dem Instagram-Business-Zielkonto verbundene Seite zweistufige Authentifizierung erfordert, muss der*die Facebook-Nutzer*in ebenfalls eine zweistufige Authentifizierung durchgeführt haben. Andernfalls schlägt die Anfrage fehl.
  • Das Veröffentlichen auf Instagram TV wird nicht unterstützt.

Anforderungen

TypBeschreibung

Zugriffsschlüssel

Nutzer*in

Unternehmensrollen

Bei der Veröffentlichung von Containern für die Produktmarkierung muss der*die App-Nutzer*in über eine Admin-Rolle für den Business Manager verfügen, dem der-Instagram Shop des*der IG-Nutzer*in gehört.

Instagram Shop

Bei der Veröffentlichung von Containern für die Produktmarkierung muss der*die IG-Nutzer*in über einen genehmigten Instagram Shop mit einem Produktkatalog mit Produkten verfügen.

Berechtigungen

instagram_basic
instagram_content_publish
pages_read_engagement oder pages_show_list


Wenn dem*derApp-Nutzer*in auf der Seite über den Business Manager eine Rolle zugewiesen wurde, benötigst du außerdem eine der folgenden Berechtigungen:


ads_management
business_management


Bei der Veröffentlichung von Containern für die Produktmarkierung brauchst du auch Folgendes:


catalog_management
instagram_shopping_tag_products

Aufgaben

Der*die App-Nutzer*in, dessen*deren Token in der Anfrage verwendet wird, muss MANAGE- oder CREATE_CONTENT Aufgaben auf der Seite durchführen können, die mit dem Instagram-Zielkonto verbunden ist.

Anfragesyntax

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media_publish
  ?creation_id={creation-id}
  &access_token={access-token}

Pfadparameter

PlatzhalterWert

{api-version}
String

API-Version.

{ig-user-id}
Erforderlich
String

App-spezifische ID des*der App-Nutzer*in.

Abfrage-String-Parameter

SchlüsselPlatzhalterBeschreibung

access_token

Erforderlich

{access-token}

Der Nutzer*innen-Zugriffsschlüssel des*der App-Nutzer*in.

creation_id

Erforderlich

{creation-id}

Die ID des IG-Containers, der veröffentlicht werden soll.

Beispielanfrage

POST graph.facebook.com
  /17841405822304914/media_publish
    ?creation_id=17889455560051444

Beispielantwort

{
  "id": "17920238422030506"
}

Lesen

Dieser Vorgang wird nicht unterstützt.

Aktualisieren

Dieser Vorgang wird nicht unterstützt.

Löschen

Dieser Vorgang wird nicht unterstützt.