Instagram-Plattform

IG-Medien

IG-Medien stellen ein Album, Foto oder Video (hochgeladenes Video, Live-Video oder mit der Instagram TV-App erstelltes Video, Reel oder Story) von Instagram dar.

Erstellen

Dieser Vorgang wird nicht unterstützt.

Lesen

GET /{ig-media-id}

Ruft Felder und Edges zu einem IG-Medium ab.

Einschränkungen

  • Felder, die aggregierte Werte zurückgeben, enthalten keine anzeigengesteuerten Daten. So zählt beispielsweise comments_count Kommentare zu einem Foto, aber keine Kommentare zu Anzeigen, die dieses Foto enthalten.
  • In Bildtexten ist das Symbol @ nur dann enthalten, wenn App-Nutzer*innen auch Aufgaben in der App durchführen können, die dem Admin vorbehalten sind.
  • Einige Felder wie permalink können nicht für Fotos in Alben verwendet werden (untergeordnete Elemente).
  • Instagram TV-Medien müssen auf Instagram zum Zeitpunkt der Veröffentlichung geteilt werden (während Vorschau veröffentlichen oder Vorschau im Feed teilen aktiviert ist), damit sie über die API verfügbar sind.
  • Live-Video-IG-Medien können nur während ihrer Übertragung gelesen werden.

Anforderungen

TypBeschreibung

Zugriffsschlüssel

Nutzer*in

Berechtigungen

instagram_basic
pages_read_engagement
pages_show_list


Wenn dem*der App-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

Anfragesyntax

GET https://graph.facebook.com/{api-version}/{ig-media-id}
  ?fields={fields}
  &access_token={access-token}

Pfadparameter

PlatzhalterWert

{api-version}

API-Version.

{ig-media-id}

Erforderlich. IG-Medien-ID.

Abfrage-String-Parameter

SchlüsselPlatzhalterWert

access_token

{access-token}

Erforderlich. Der Nutzer-Zugriffsschlüssel eines*einer App-Nutzer*in.

fields

{fields}

Eine kommagetrennte Liste der Felder, die zurückgegeben werden sollen.

Felder

Öffentliche Felder können mittels Felderweiterung gelesen werden.

FeldBeschreibung

caption
Öffentlich

Bildtext. Ohne untergeordnete Albumelemente. Hiervon ausgenommen ist das @-Symbol, es sei denn, der*die App-Nutzer*in kann die Entsprechung von Admin-Aufgaben auf der Facebook-Seite durchführen, die mit dem Instagram-Konto verbunden ist, das zum Erstellen der Bildunterschrift verwendet wurde.

comments_count
Öffentlich

Anzahl der Kommentare zum Medienobjekt. Ohne Kommentare zu untergeordneten Medienobjekten des Albums und Bildtext des Medienobjekts. Mit Antworten auf Kommentare.

copyright_check_information.status

Gibt status- und matches_found-Objekte zurück.

„status“-ObjekteBeschreibung

status

  • completed: Der Erkennungsvorgang wurde abgeschlossen
  • error: Während des Erkennungsvorgangs ist ein Fehler aufgetreten.
  • in_progress: Der Erkennungsvorgang läuft.
  • not_started: Der Erkennungsvorgang hat noch nicht begonnen.

matches_found

Festgelegt auf einen der folgenden Werte:

  • false, wenn das Video nicht gegen das Urheberrecht verstößt,
  • true, wenn das Video gegen das Urheberrecht verstößt

Wenn ein Video gegen das Urheberrecht verstößt, wird copyright_matches mit einem Array aus Objekten zurückgegeben, die Angaben zum urheberrechtlich geschützten Material, zum Zeitpunkt im Video, an dem der Verstoß auftritt sowie zu den Maßnahmen zur Behebung des Verstoßes enthalten.

„copyright_matches“-ObjekteBeschreibung

author

Der Autor der des urheberrechtlich geschützten Videos

content_title

Der Name des urheberrechtlich geschützten Videos

matched_segments

Eine Array aus Objekten mit den folgenden Schlüssel-Wert-Paaren: * duration_in_seconds: die Anzahl der Sekunden, in denen der Inhalt gegen das Urheberrecht verstößt * segment_type: entweder AUDIO oder VIDEO * start_time_in_seconds: festgelegt auf die Startzeit des Videos

owner_copyright_policy

Die zurückgegebenen Objekte umfassen:

  • name: Der Name für die Richtlinie zum Urheberrecht des*der Eigentümer*in

  • actions: Ein Array aus action-Objekten mit den ergriffenen Behebungsmaßnahmen, die in der Richtlinie zum Urheberrecht des*der Eigentümer*in definiert sind. Kann je nach Standort unterschiedliche Behebungsmaßnahmen enthalten.

    • action: Die Behebungsmaßnahme, die gegen das Video mit dem Urheberrechtsverstoß ergriffen wird. Je nach Land können die ergriffenen Behebungsmaßnahmen variieren. Das Objekt kann die folgenden Werte haben:
      • BLOCK: Das Video ist für die im geos-Array aufgeführten Zielgruppen gesperrt.
      • MUTE: Das Video ist für die im geos-Array aufgeführten Zielgruppen stummgeschaltet.

id
Öffentlich

ID des Medienobjekts.

ig_id
Öffentlich

Instagram-Medien-ID. Wird mit der veralteten Instagram API verwendet – mittlerweile eingestellt. Verwende stattdessen id.

is_comment_enabled

Gibt an, ob Kommentare aktiviert oder deaktiviert sind. Ohne untergeordnete Albumelemente.

is_shared_to_feed
Öffentlich

Nur für Reels. Wenn true festgelegt ist, kann das Reel auf den Tabs Feed und Reels angezeigt werden. Der Wert false gibt an, dass das Reel nur auf dem Tab Reels angezeigt werden kann.

Keiner der Werte gibt an, ob das Reel tatsächlich auf dem Tab Reels angezeigt wird, da das Reel möglicherweise nicht die Berechtigungsanforderungen erfüllt oder nicht von unserem Algorithmus ausgewählt wird. Die Berechtigungskriterien findest du unter Reel-Spezifikationen.

like_count

Anzahl der „Gefällt mir“-Angaben für das Medienobjekt, einschließlich Antworten auf Kommentare. Ohne „Gefällt mir“-Angaben für untergeordnete Medienobjekte des Albums und „Gefällt mir“-Angaben für hervorgehobene Beiträge, die aus dem Medienobjekt erstellt wurden.


Bei der indirekten Abfrage über einen anderen Endpunkt oder eine Felderweiterung:


  • Aufrufe mit Version 10.0 oder älter: Der Wert lautet 0, wenn der*die Medien-Eigentümer*in verborgene „Gefällt mir“-Angaben hat.
  • Aufrufe mit Version 11.0 oder höher: Das like_count-Feld wird ausgelassen, wenn der*die Medien-Eigentümer*in verborgene „Gefällt mir“-Angaben hat.

media_product_type
Öffentlich

Oberfläche, auf der das Medienobjekt veröffentlicht wird. Diese kann AD, FEED, REELS oder STORY lauten.

media_type
Öffentlich

Medientyp. Dieser kann CAROUSEL_ALBUM, IMAGE oder VIDEO lauten.

media_url
Öffentlich

Die Medien-URL.

Das Feld media_url wird in Antworten weggelassen, wenn das Medienobjekt urheberrechtlich geschütztes Material enthält oder mit einer Urheberrechtsverletzung gekennzeichnet wurde. Beispiele für urheberrechtlich geschütztes Material können Audio in Reels beinhalten.

owner
Öffentlich

ID des*der Instagram-Nutzer*in, der*die das Medienobjekt erstellt hat. Wird nur zurückgegeben, wenn der*die App-Nutzer*in, der*die die Abfrage sendet, auch das Medienobjekt erstellt hat. Andernfalls wird stattdessen das Feld username zurückgegeben.

permalink
Öffentlich

Permanente Medien-URL.

shortcode
Öffentlich

Shortcode zum Medienobjekt.

thumbnail_url
Öffentlich

Die URL des Miniaturbilds des Medienobjekts. Nur bei VIDEO-Medien verfügbar.

timestamp
Öffentlich

Erstellungsdatum im ISO 8601-Format in UTC (Standard ist UTC ±00:00).

username
Öffentlich

Benutzername des*der Nutzer*in, der*die das Medienobjekt erstellt hat.

video_title
Öffentlich

Veraltet. Nicht in der Antwort enthalten.

Edges

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

EdgeBeschreibung

children
Öffentlich.

Stellt eine Collection von IG-Medien-Objekten in einem Album-IG-Medien-Objekt dar.

collaborators

Stellt eine Liste von Benutzer*innen dar, die als Collaborators zu einem IG-Medien-Objekt hinzugefügt werden.

comments

Stellt eine Collection von IG-Kommentaren zu einem IG-Medien-Objekt dar.

insights

Stellt Kennzahlen zu sozialer Interaktion für ein IG-Medien-Objekt dar.

cURL-Beispiel

Anfrage

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

Antwort

{
  "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 IG-Medienobjekt aktivieren oder deaktivieren.

Einschränkungen

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

Anforderungen

TypBeschreibung

Zugriffsschlüssel

Nutzer*in

Berechtigungen

instagram_basic
instagram_manage_comments
pages_show_list


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


ads_management
business_management

Anfragesyntax

POST https://graph.facebook.com/{api-version}/{ig-media-id}
  ?comment_enabled={comment-enabled}
  &access_token={access-token}

Pfadparameter

PlatzhalterWert

{api-version}

API-Version.

{ig-media-id}

Erforderlich. IG-Medien-ID.

Abfrage-String-Parameter

SchlüsselPlatzhalterWert

access_token

{access-token}

Erforderlich. Der Nutzer-Zugriffsschlüssel eines App-Nutzers.

comment_enabled

{comment-enabled}

Erforderlich. Setze diese Option auf true, um Kommentare zu aktivieren, oder auf false, um Kommentare zu deaktivieren.

cURL-Beispiel

Anfrage

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

Antwort

{
  "success": true
}

Löschen

Dieser Vorgang wird nicht unterstützt.