Instagram-Plattform

Instagram(IG)-Kommentar

Steht für einen Kommentar zu einem Instagram-Medienobjekt.

If you are migrating from Marketing API Instagram Ads endpoints to Instagram Platform endpoints, be aware that some field names are different.

Die folgenden Felder sind neu:

  • legacy_instagram_comment_id

Die folgenden Felder werden nicht unterstützt:

  • comment_type
  • mentioned_instagram_users

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

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_COMMENT_ID>?fields=<LIST_OF_FIELDS>

Abrufen von Feldern und Edges in einem IG-Kommentar.

Einschränkungen

  • Für Kommentare, die über die Mentions API ermittelt wurden, kann keine Anfrage ausgeführt werden, es sei denn, sie stammt von dem*der Eigentümer*in des Kommentars. Verwende stattdessen den Node für erwähnte Kommentare.
  • Es werden keine Kommentare zu Medien mit Altersbeschränkungen zurückgegeben.
  • Von IG-Nutzer*innen erstellte Kommentare, die der*die App-Nutzer*in eingeschränkt hat, werden nicht zurückgegeben, es sei denn, für die IG-Nutzer*innen gelten keine Einschränkungen und die Kommentare sind genehmigt.
  • Kommentare zu Live-Video-IG-Medien können nur gelesen werden, während das entsprechende IG-Medium, zu dem der Kommentar erstellt wurde, übertragen wird.

Anfragesyntax

GET https://<HOST_URL>/<API_VERSION>/<IG_COMMENT_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

Pfadparameter

PlatzhalterWert

<API_VERSION>

API-Version.

<HOST_URL>

API-Version.

<IG_COMMENT_ID>

Erforderlich. ID des IG-Kommentars.

Abfrage-String-Parameter

SchlüsselPlatzhalterWert

access_token

<ACCESS_TOKEN>

Erforderlich. Das Nutzer*innen-Zugriffstoken von App-Nutzer*innen.

fields

<LIST_OF_FIELDS>

Kommagetrennte Liste von IG-Kommentar-Feldern, die für die einzelnen IG-Kommentare im Ergebnissatz zurückgegeben werden sollen.

Felder

Name des FeldesBeschreibung

from

Ein Objekt, das Folgendes enthält:

  • id – Instagram-spezifische ID (IGSID) des*der Instagram-Nutzer*in, der*die den IG-Kommentar erstellt hat.
  • username – Benutzungsname des*der Instagram-Nutzer*in, der*die den IG-Kommentar erstellt hat.

hidden

Gibt an, ob ein Kommentar ausgeblendet wurde (true) oder nicht (false).

id

ID des IG-Kommentars.

like_count

Die Anzahl der „Gefällt mir“-Angaben zum IG-Kommentar.

legacy_instagram_comment_id

Die ID für Instagram-Kommentar, die für Marketing API-Endpunkte mit v21.0 und älter erstellt wurde.

media

Ein Objekt, das Folgendes enthält:


  • id – ID des IG-Mediums, zu dem der IG-Kommentar abgegeben wurde.
  • media_product_type – Veröffentlichungsoberfläche des IG-Mediums (d. h. wo das IG-Medium erscheint), zu dem der IG-Kommentar erstellt wurde.

parent_id

ID des übergeordneten IG-Kommentars, wenn dieser Kommentar in einem anderen IG-Kommentar erstellt wurde (d. h., wenn es sich um eine Antwort auf einen anderen Kommentar handelt).

replies

Eine Liste der Antworten (IG-Kommentare) zu dem IG-Kommentar.

text

Text des IG-Kommentars.

timestamp

Gemäß ISO 8601 formatierter Zeitstempel, aus dem hervorgeht, wann der IG-Kommentar erstellt wurde.


Beispiel: 2017-05-19T23:27:28+0000.

user

ID des*der IG-Nutzer*in, der*die den IG-Kommentar erstellt hat. Wird nur zurückgegeben, wenn der*die App-Nutzer*in den IG-Kommentar erstellt hat. Andernfalls wird das Feld username zurückgegeben.

username

Benutzungsname des*der Instagram-Nutzer*in, der*die den IG-Kommentar erstellt hat.

Ab dem 27. August 2024 sind die Berechtigungen instagram_manage_comments (wenn deine App Facebook-Login verwendet) und instagram_business_manage_comments (wenn deine App Instagram-Login verwendet) erforderlich, um auf das Feld username eines*einer Instagram-Nutzer*in zuzugreifen, der*die Medien des professionellen Instagram-Kontos eines*einer App-Nutzer*in kommentiert hat.

Edges

EdgeBeschreibung

replies

Eine Liste von IG-Kommentaren zum IG-Kommentar abrufen; IG-Kommentar zu einem IG-Kommentar erstellen.

Antwort

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

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

cURL-Beispiel

Anfrage

curl -i -X GET \
 "https://graph.instagram.com/v25.0/17881770991003328?fields=hidden%2Cmedia%2Ctimestamp&access_token=EAAOc..."

Antwort

{
  "hidden": false,
  "media": {
    "id": "17856134461174448"
  },
  "timestamp": "2017-05-19T23:27:28+0000",
  "id": "17881770991003328"
}

Aktualisieren

Aus-/Einblenden eines Kommentars

POST <HOST_URL>/<IG_COMMENT_ID>?hide=<BOOLEAN>

Abfrage-String-Parameter

  • {hide} (erforderlich). Bei der Einstellung true wird der Kommentar ausgeblendet, bei false eingeblendet.

Einschränkungen

  • Kommentare von Medienobjekt-Eigentümer*innen zu ihren eigenen Medienobjekten werden auch dann angezeigt, wenn für Kommentare ansonsten hide=true festgelegt wurde.
  • Kommentare zu Live-Video-IG-Medien werden nicht unterstützt.

Zugriffstoken

Ein Nutzer*innen-Zugriffstoken von dem*der Nutzer*in, der*die das Medienobjekt besitzt, das kommentiert wurde.

Beispielanfrage

Ausblenden eines Kommentars:

POST graph.instagram.com
  /17873440459141021?hide=true

Beispielantwort

{
  "success": true
}

Löschen

Löschen eines Kommentars

DELETE <HOST_URL>/<IG_COMMENT_ID>

Zugriffstoken

Ein Nutzer*innen-Zugriffstoken von einem*einer Nutzer*in, der*die den Kommentar erstellt hat.

Einschränkungen

  • Ein Kommentar kann nur von der*dem Eigentümer*in des Objekts gelöscht werden, zu dem der Kommentar erstellt wurde. Das gilt auch dann, wenn ein*e Nutzer*in seinen*ihren eigenen Kommentar löschen möchte.
  • Kommentare zu Live-Video-IG-Medien werden nicht unterstützt.

Beispielanfrage

DELETE graph.instagram.com
  /17873440459141021

Beispielantwort

{
  "success": true
}