Instagram-Plattform
Zurück zu Deutsch
Dieses Dokument wurde aktualisiert.
Die Übersetzung ins Deutsche ist noch nicht fertig.
Englisch aktualisiert: 5. Sept.

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.

Ab dem 3. Juni 2024 kannst du das Feld boost_eligibility_info auf einfache und effiziente Weise verwenden, um zu bestimmen, ob Medien als Anzeige beworben werden können, und das Feld boost_ads_list, um Bewerbungsinformationen vergangener Instagram-Werbeanzeigen zu der Anzeige nachzuverfolgen. Weitere Informationen findest du im Blog. Nur für die Instagram Graph API verfügbar.

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).
  • Live-Video-IG-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.

Anfragesyntax

GET https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

Pfadparameter

PlatzhalterWert

<API_VERSION>

API-Version.

<IG_MEDIA_ID>

Erforderlich. ID der zu veröffentlichenden Medien.

Abfrage-String-Parameter

SchlüsselPlatzhalterWert

access_token

<ACCESS_TOKEN>

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

fields

<LIST_OF_FIELDS>

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

Felder

Öffentliche Felder können mittels Felderweiterung gelesen werden.

FeldBeschreibung

boost_ads_list

Bietet einen Überblick über alle Instagram-Anzeigeninformationen, die mit dem organischen Medium verknüpft sind. Dazu gehören die relative Anzeigen-ID und der Status der Anzeigenauslieferung. Nur für die Instagram Graph API verfügbar.

boost_eligibility_info

Das Feld enthält Informationen zur Bewerbung der Eignung eines IG-Instagram-Mediums als Anzeige sowie zusätzliche Details, falls keine Eignung vorliegt. Nur für die Instagram Graph API verfügbar.

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 (gilt nur für die Instagram Graph API).

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.

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, wird das Feld like_count ausgeschlossen, wenn der*die Medieneigentümer*in ausgeblendete „Gefällt mir“-Angaben festgelegt hat.

media_product_type
Öffentlich

Oberfläche, auf der das Medienobjekt veröffentlicht wird. Diese kann AD, FEED, REELS oder STORY lauten. Nur für die Instagram Graph API verfügbar.

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.

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. Nur für die Instagram Graph API verfügbar.

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. Nur für die Instagram Graph API verfügbar.

cURL-Beispiel

Beispielanfrage

curl -X GET \
  'https://graph.instagram.com/v21.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 IG-Medienobjekt aktivieren oder deaktivieren.

Einschränkungen

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

Requirements

Instagram API with Instagram LoginInstagram API with Facebook Login

Access Tokens

  • Instagram User access token

Host URL

graph.instagram.com

graph.facebook.com

Login Type

Business Login for Instagram

Facebook Login for Business

Permissions
  • instagram_business_basic
  • instagram_business_manage_comments
  • instagram_basic
  • instagram_manage_comments
  • pages_read_engagement
  • pages_show_list

If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of:

  • ads_management
  • business_management

Anfragesyntax

POST https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>
  ?comment_enabled=<BOOL>
  &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*innen-Zugriffsschlüssel eines*einer App-Nutzer*in.

comment_enabled

<BOOL>

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

cURL-Beispiel

Beispielanfrage

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

Beispielantwort

{
  "success": true
}

Löschen

Dieser Vorgang wird nicht unterstützt.