Instagram-Medien (IG Media)

Stellen ein Album, Foto oder Video (hochgeladenes Video, Live-Video, Reel oder Story) von Instagram dar.

Das folgende Feld ist neu:

• legacy_instagram_media_id

Die folgenden Endpunktfelder für Marketing API-Instagram-Werbeanzeigen werden nicht unterstützt:

• filter_name
• location
• location_name
• latitude
• longitude

Erstellen

Dieser Vorgang wird nicht unterstützt.

Lesen

GET /<IG_MEDIA_ID>

Ruft Felder und Edges zu Instagram-Medien ab.

Anforderungen

Einschränkungen

• Felder wie comments_count und like_count geben Interaktionen nur für die Ziel-Instagram-Medien zurück und enthalten keine Daten von anderen Oberflächen. So gibt beispielsweise comments_count die Anzahl der Kommentare zu einem Foto zurück, aber keine Kommentare zu Anzeigen, die dieses Foto enthalten. Mit total_comments_count und total_like_count erhältst du aggregierte Zahlen, die Interaktionen von hervorgehobenen oder beworbenen Medien bzw. Anzeigenmedien enthalten. Die Anzahl der crossgeposteten Facebook-Beiträge kann einbezogen werden, wenn der*die Sitzungsnutzer*in auf den Beitrag zugreifen kann.
• In Bildtexten ist das Symbol @ nur dann enthalten, wenn App-Nutzer*innen auch Aufgaben in der App durchführen können, die dem*der Admin vorbehalten sind.
• Einige Felder wie permalink können nicht für Fotos in Alben verwendet werden (untergeordnete Elemente).
• Live-Video-Instagram-Medien können nur während ihrer Übertragung gelesen werden.
• Diese API gibt nur Daten für Medien zurück, die professionellen Instagram-Konten gehören. Sie kann nicht verwendet werden, um Daten für Medien abzurufen, die persönlichen Instagram-Konten gehören.
• Die Felder reposts_count, saved_count, shares_count, total_like_count, total_comments_count und total_views_count sind für untergeordnete Carousel-Medien nicht verfügbar und werden nur für Medienobjekte der obersten Ebene zurückgegeben. Der*die Medieneigentümer*in kann das Anzeigen von „Gefällt mir“-Angaben, Kommentaren, Aufrufen, Reposts und geteilten Inhalten deaktivieren. In diesem Fall werden die entsprechenden Felder nicht zurückgegeben.

Anfragesyntax

GET https://<HOST_URL>/<API_VERSION>/<IG_MEDIA_ID> \
  ?fields=<LIST_OF_FIELDS> \
  &access_token=<ACCESS_TOKEN>

Pfadparameter

Abfrage-String-Parameter

Felder

Öffentliche Felder können mittels Felderweiterung gelesen werden.

Edges

Öffentliche Edges können durch die Felderweiterung zurückgegeben werden.

cURL-Beispiel

Beispielanfrage

curl -X GET \
  'https://graph.instagram.com/v26.0/17895695668004550?fields=id,media_type,media_url,owner,timestamp&access_token=IGQVJ...'

Beispielantwort

{
  "id": "17918920912340654",
  "media_type": "IMAGE",
  "media_url": "https://sconten...",
  "owner": {
    "id": "17841405309211844"
  },
  "timestamp": "2019-09-26T22:36:43+0000"
}

Aktualisieren

POST /<IG_MEDIA_ID>

Kommentare zu einem Instagram-Medien-Objekt aktivieren oder deaktivieren.

Einschränkungen

Live-Video-Instagram-Medien werden nicht unterstützt.

Anfragesyntax

POST https://<HOST_URL>/<API_VERSION>/<IG_MEDIA_ID>
  ?comment_enabled=<BOOL>
  &access_token=<ACCESS_TOKEN>

Pfadparameter

Abfrage-String-Parameter

cURL-Beispiel

Beispielanfrage

curl -i -X POST \
 "https://graph.instagram.com/v26.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."

Beispielantwort

{
  "success": true
}

Löschen

DELETE /<IG_MEDIA_ID>

Löscht Instagram-Medien.

Anforderungen

Einschränkungen

Diese API unterstützt nur die Instagram API mit Facebook-Login. Unterstützt werden Beiträge ohne Werbung, Stories, Reels und ganze Carousel-Alben. Um Medien in Carousel-Alben zu löschen, muss das gesamte Carousel-Album gelöscht werden, indem die Medien-ID des Carousel-Containers angegeben wird. Du kannst keine einzelnen Medien in einem Carousel löschen.

Anfragesyntax

POST https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>
  ?access_token=<ACCESS_TOKEN>

Pfadparameter

Abfrage-String-Parameter

cURL-Beispiel

Beispielanfrage

curl -i -X DELETE \
 "https://graph.facebook.com/v26.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."

Beispielantwort (Erfolg)

{
  "success": true,
  "deleted_id": "17918920912340654"
}

Beispielantwort (Fehler, Medientyp nicht unterstützt)

{
  "error": {
   "message": "Fatal",
   "type": "OAuthException",
   "code": -1,
   "error_subcode": 2207073,
   "is_transient": false,
   "error_user_title": "Media Type Not Supported",
   "error_user_msg": "The media type is not supported for this endpoint",
   "fbtrace_id": "Api-OlNdfcpOwIu6hNaT5Kw"
  },
}