Medien

Stellt ein Bild, Video oder Album dar.

Erstellen

Dieser Vorgang wird nicht unterstützt.

Lesen

GET /{media-id}

Felder und Edges zu einem Bild, Video oder Album abrufen

Anforderungen

Typ	Anforderung
Zugriffsschlüssel	Instagram-Nutzer
Berechtigungen	`instagram_graph_user_media`

Anfragesyntax

GET https://graph.instagram.com/{media-id}
  ?fields={fields}
  &access_token={access-token}

Abfrage-String-Parameter

Schließe die folgenden Abfrage-String-Parameter ein, um die Anfrage zu erweitern.

Schlüssel	Wert
`access_token` Erforderlich String	Der Instagram-Nutzer-Zugriffsschlüssel des App-Nutzers.
`fields` Kommagetrennte Liste	Eine durch Komma getrennte Liste der Felder und Edges, die zurückgegeben werden sollen. Wird keine Angabe gemacht, werden Standardfelder zurückgegeben.

Felder

Du kannst den fields-Abfrage-String-Parameter verwenden, um die folgenden Felder zu einem Medienelement anzufordern.

Name des Feldes	Beschreibung
`caption`	Die Bildunterschrift des Medienelements. Kann nicht für Medien in Alben zurückgegeben werden.
`id`	Die ID des Medienelements.
`is_shared_to_feed`	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.
`media_type`	Der Medientyp. Dieser kann `IMAGE`, `VIDEO` oder `CAROUSEL_ALBUM` lauten.
`media_url`	Die Medien-URL.
`permalink`	Die permanente Medien-URL. Wird weggelassen, wenn das Medienobjekt urheberrechtlich geschützte Materialien enthält oder mit einer Urheberrechtsverletzung gekennzeichnet wurde.
`thumbnail_url`	Die URL des Miniaturbilds des Medienelements. Nur bei `VIDEO`-Medien verfügbar.
`timestamp`	Das Veröffentlichungsdatum des Medienelements im ISO-8601-Format.
`username`	Der Benutzername des Medieneigentümers.

Edges

Du kannst die folgenden Edges als Pfadparameter anfordern oder den fields-Abfrage-String-Parameter verwenden.

Edge	Beschreibung
`children`	Eine Liste von Medien zum Medienalbum abrufen. Nur bei `CAROUSEL_ALBUM`-Medien verfügbar.

Antwort

Ein JSON-formatiertes Objekt mit standardmäßigen und angeforderten Feldern und Edges.

{
  "{field}":"{value}",
  ...
}

cURL-Beispiel

Anfrage

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

Antwort

{
  "id": "17895695668004550",
  "media_type": "IMAGE",
  "media_url": "https://fb-s-b-a.akamaihd.net/...",
  "username": "jayposiris"
  "timestamp": "2017-08-31T18:10:00+0000"
}

Aktualisieren

Dieser Vorgang wird nicht unterstützt.

Löschen

Dieser Vorgang wird nicht unterstützt.