Tags

Stellt eine Collection von IG-Medien-Objekten dar, in denen ein IG-Nutzer von einem anderen Instagram-Nutzer markiert wurde.

Erstellen

Dieser Vorgang wird nicht unterstützt.

Lesen

GET /{ig-user-id}/tags

Gibt eine Liste von IG-Medien-Objekten zurück, in denen ein IG-Nutzer von einem anderen Instagram-Nutzer markiert wurde.

Einschränkungen

Private IG-Medien-Objekte werden nicht zurückgegeben.

Anforderungen

Typ	Beschreibung
Zugriffsschlüssel	Nutzer*in
Features	Nicht zutreffend.
Berechtigungen	`instagram_basic` `instagram_manage_comments` `pages_read_engagement` `pages_show_list` Wenn der Schlüssel für einen Nutzer gilt, dessen Seitenrolle über den Business Manager erteilt wurde, ist außerdem eine der folgenden Berechtigungen erforderlich: `ads_management`, `business_management` oder `pages_read_engagement`.
Aufgaben	Der App-Nutzer muss die entsprechenden Aufgaben auf der Seite ausführen können, basierend auf den von der App angefragten Berechtigungen.

Anfragesyntax

GET https://graph.facebook.com/{ig-user-id}/tags
  ?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 kommagetrennte Liste der Felder und Edges, die in der Antwort enthalten sein sollen. Wird keine Angabe gemacht, werden Standardfelder zurückgegeben.

Felder

Verwende den Abfrage-String-Parameter fields, um Felder anzugeben, die für alle zurückgegebenen IG-Medien-Objekte eingeschlossen werden sollen.

Bei Aufrufen mit Version 10.0 und älter bis zum 7. September 2021: Das Feld like_count bei IG-Medien gibt 0 zurück, wenn der Eigentümer des Mediums „Gefällt mir“-Angaben dafür verborgen hat.

Bei Aufrufen mit Version 11.0 und neuer sowie allen Versionen ab dem 7. September 2021: Bei der indirekten Abfrage eines IG-Medien-Objekts über einen anderen Endpunkt oder eine Felderweiterung wird das Feld like_count bei API-Antworten ausgelassen, wenn der Medien-Eigentümer „Gefällt mir“-Angaben dafür verborgen hat. Die direkte Abfrage des IG-Medien-Objekts (die nur durch den Eigentümer des IG-Medien-Objekts ausgeführt werden kann) gibt die tatsächliche Anzahl der „Gefällt mir“-Angaben zurück, auch wenn „Gefällt mir“-Angaben verborgen sind.

Edges

Verwende den Abfrage-String-Parameter fields, um Edges anzugeben, die für alle zurückgegebenen IG-Medien-Objekte eingeschlossen werden sollen.

Antwort

Ein JSON-formatiertes Objekt mit IG-Medien-Objekten.

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

Paginierung

Diese Edge unterstützt die Cursor-basierte Paginierung. Die Antwort enthält daher before- und after-Cursor, wenn sie mehrere Seiten mit Daten umfasst. Im Gegensatz zur standardmäßigen Cursor-basierten Paginierung enthält die Antwort allerdings keine previous- oder next-Felder. Daher musst du mit dem before- bzw. dem after-Cursor manuell previous- und next-Abfrage-Strings erstellen, um dich seitenweise durch den zurückgegebenen Datensatz zu bewegen.

Beispielanfrage

GET graph.facebook.com/17841405822304914/tags
    ?fields=id,username
    &access_token=EAADd...

Beispielantwort

{
  "data": [
    {
      "id": "18038...",
      "username": "keldo..."
    },
    {
      "id": "17930...",
      "username": "ashla..."
    },
    {
      "id": "17931...",
      "username": "jaypo..."
    }
  ]
}

Aktualisieren

Dieser Vorgang wird nicht unterstützt.

Löschen

Dieser Vorgang wird nicht unterstützt.