Instagram(IG)-Container

Stellt einen Medien-Container für das Veröffentlichen von Instagram-Medienobjekten dar.

Requirements

Instagram API with Instagram LoginInstagram API with Facebook Login

Access Tokens

  • Instagram User 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_content_publish
  • instagram_basic
  • instagram_content_publish
  • pages_read_engagement

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
  • ads_read

Erstellen

Dieser Vorgang wird nicht unterstützt.

Lesen

GET <HOST_URL>/<IG_CONTAINER_ID>

Abrufen von Feldern und Edges in einem IG-Container.

Anfragesyntax

GET <HOST_URL>/<API_VERSION>/<IG_CONTAINER_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

Abfrage-String-Parameter

ParameterWert

access_token
Erforderlich
String

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

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

Name des FeldesBeschreibung

copyright_check_status

Wird verwendet, um festzustellen, ob ein hochgeladenes Video gegen das Urheberrecht verstößt. Zu den zurückgegebenen Schlüssel-Wert-Paaren zählen:

  • matches_found festgelegt auf einen der folgenden Werte:
    • true: Das Video verstößt gegen das Urheberrecht.
    • false: Das Video verstößt nicht gegen das Urheberrecht.
  • status festgelegt auf einen der folgenden Werte:
    • 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.

id

Instagram-Container-ID, in Codebeispielen als <IG_CONTAINER_ID> angegeben

status

Veröffentlichungsstatus. Wenn der status_codeERROR ist, ist dieser Wert ein Fehleruntercode.

status_code

Der Veröffentlichungsstatus des Containers. Mögliche Werte:


  • EXPIRED: Der Container wurde innerhalb von 24 Stunden nicht veröffentlicht und ist abgelaufen.
  • ERROR: Der Container konnte den Veröffentlichungsprozess nicht abschließen.
  • FINISHED: Der Container und sein Medienobjekt sind für die Veröffentlichung bereit.
  • IN_PROGRESS: Der Container befindet sich noch im Veröffentlichungsprozess.
  • PUBLISHED: Das Medienobjekt des Containers wurde veröffentlicht.

Edges

Es gibt keine Edges auf diesem Node.

Antwort

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

{
  "<FIELD>":"<VALUE>",
  ...
}

Beispielanfrage

curl -X GET \
  'https://graph.instagram.com/17889615691921648?fields=status_code&access_token=IGQVJ...'

Beispielantwort

{
  "status_code": "FINISHED",
  "id": "17889615691921648"
}

Aktualisieren

Dieser Vorgang wird nicht unterstützt.

Löschen

Dieser Vorgang wird nicht unterstützt.