Instagram Graph API

Co-Autor*innen

Dies stellt eine Liste von Nutzer*innen dar, die als Collab-Partner*innen zu einem IG-Medienobjekt hinzugefügt wurden.

Erstellen

Dieser Vorgang wird nicht unterstützt.

Lesen

Eine Liste von Instagram-Nutzer*innen als Collab-Partner*innen mit dem jeweiligen Einladungsstatus für ein IG-Medienobjekt abrufen.

GET /{ig-media-id}

Einschränkungen

  • Bis zu drei Instagram-Konten können als Collab-Partner*innen hinzugefügt werden.
  • In der Antwort werden nur IG-Nutzer*innen zurückgegeben, die das Collab-Partner*innen-Tagging aktiviert haben.
  • Das Collab-Partner*innen-Tagging unterstützt Feed-Bilder, Reels und Carousel. Stories werden nicht unterstützt.

Anforderungen

TypBeschreibung

Zugriffsschlüssel

Nutzer*in – Das IG-Medienobjekt muss von einer*einem Nutzer*in erstellt worden sein.

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/{appi-version}/{ig-media-id}/collaborators

Beispielantwort

{
  "data": [
    {
      "id": "90010775360791",
      "username": "realtest1",
      "invite_status": "Accpeted"
    },
    {
      "id": "17841449208283139",
      "username": "realtest2",
      "invite_status": "Pending"
    },
    {
      "id": "90011117049518",
      "username": "realtest3",
      "invite_status": "Declined"
    }
  ]
}

Pfadparameter

PlatzhalterWert

{api-version}

API-Version.

{ig-user-id}

Erforderlich. IG-Nutzer*innen-ID

Abfrage-String-Parameter

SchlüsselPlatzhalterWert

access_token

{access-token}

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

Antwortfelder

Name des FeldesBeschreibung

id

Die App-spezifische ID für das Instagram-Konto des*der potenziellen Collab-Partner*in

invite_status

Der Status der Einladung, die an eine*n potenzielle*n Collab-Partner*in gesendet wurde. Dieser kann einer der Folgenden sein:

  • Accepted
  • Declined
  • Pending

username

Benutzername des Instagram-Profils für den*die potenzielle*n Collab-Partner*in

Aktualisieren

Dieser Vorgang wird nicht unterstützt.

Löschen

Dieser Vorgang wird nicht unterstützt.