Instagram-Plattform

IG-Kommentar

Steht für einen Kommentar in einem IG-Medienobjekt.

Erstellen

Dieser Vorgang wird nicht unterstützt.

Lesen

GET /{ig-comment-id}?fields={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 vom Eigentümer des Kommentars. Verwende stattdessen den Node Erwähnter Kommentar.
  • Es werden keine Kommentare zu Medien mit Altersbeschränkungen zurückgegeben.
  • Von IG-Nutzern erstellte Kommentare, die der App-Nutzer eingeschränkt hat, werden nicht zurückgegeben, es sei denn, für die IG-Nutzer 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.

Anforderungen

TypAnforderung

Zugriffsschlüssel

Nutzer

Berechtigungen

instagram_basic
pages_read_engagement
pages_show_list


Wenn der App-Nutzer über den Business Manager auf der mit dem IG-Nutzer aus der Zielgruppe verbundenen Seite eine Rolle zugewiesen bekommen hat, benötigst du außerdem eine der folgenden Berechtigungen:


ads_management
business_management

Anfragesyntax

GET https://graph.facebook.com/{api-version}/{ig-comment-id}
  ?fields={fields}
  &access_token={access-token}

Pfadparameter

PlatzhalterWert

{api-version}

API-Version.

{ig-comment-id}

Erforderlich. ID des IG-Kommentars.

Abfrage-String-Parameter

SchlüsselPlatzhalterWert

access_token

{access-token}

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

fields

{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 – IGSID des Instagram-Nutzers, der den IG-Kommentar erstellt hat.
  • username – Benutzername des Instagram-Nutzers, der 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.

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 IG-Nutzers, der den IG-Kommentar erstellt hat. Wird nur zurückgegeben, wenn der App-Nutzer den IG-Kommentar erstellt hat. Andernfalls wird das Feld username zurückgegeben.

username

Benutzername des Instagram-Nutzers, der den IG-Kommentar erstellt 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.facebook.com/v19.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 /{ig-comment-id}?hide={hide}

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.

Berechtigungen

Ein Nutzer-Zugriffsschlüssel von einem Facebook-Nutzer, der den Kommentar erstellt hat, mit den folgenden Berechtigungen:

  • instagram_basic
  • instagram_manage_comments
  • pages_show_list
  • pages_read_engagement

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
  • pages_read_engagement
  • business_management

Beispielanfrage

Ausblenden eines Kommentars:

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

Beispielantwort

{
  "success": true
}

Löschen

Löschen eines Kommentars

DELETE /{ig-comment-id}

Berechtigungen

Ein Nutzer-Zugriffsschlüssel von einem Nutzer, der den Kommentar erstellt hat, mit den folgenden Berechtigungen:

  • instagram_basic
  • instagram_manage_comments

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
  • pages_read_engagement
  • business_management

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.facebook.com
  /17873440459141021

Beispielantwort

{
  "success": true
}