Plate-forme Instagram

Commentaire IG

Représente un commentaire sur un objet IG Media.

Création

Cette opération n’est pas prise en charge.

Lecture

GET /{ig-comment-id}?fields={fields}

Obtenir des champs et des arêtes sur un commentaire Instagram.

Limites

  • Aucune requête ne peut être effectuée sur les commentaires découverts à l’aide de l’API Mentions, à moins que la requête n’émane du propriétaire du commentaire. Utilisez plutôt le nœud Commentaire mentionné.
  • Les commentaires ajoutés à des médias soumis à une limite d’âge ne sont pas renvoyés.
  • Les commentaires créés par des utilisateurs Instagram pour lesquels des restrictions ont été définies par l’utilisateur de l’application ne seront pas renvoyés, sauf si ces restrictions sont levées et les commentaires approuvés.
  • Les commentaires sur les vidéos IG Media en direct peuvent être lus uniquement lorsque la vidéo IG Media concernée est en cours de diffusion.

Conditions requises

TypeCondition requise

Tokens d’accès

Utilisateur·trice

Autorisations

instagram_basic
pages_read_engagement
pages_show_list


Si un rôle a été attribué à l'utilisateur de l'application via Business Manager sur la Page connectée à l’utilisateur Instagram ciblé, vous aurez également besoin de l'un des éléments suivants :


ads_management
business_management

Syntaxe de la requête

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

Paramètres du chemin

Espace réservéValeur

{api-version}

Version de l’API.

{ig-comment-id}

Obligatoire. ID du commentaire Instagram.

Paramètres de chaîne de requête

CléEspace réservéValeur

access_token

{access-token}

Obligatoire. Token d’accès Utilisateur de l’utilisateur/utilisatrice de l’application.

fields

{fields}

Liste des champs de commentaire Instagram séparés par une virgule que vous souhaitez renvoyer pour chaque commentaire Instagram figurant dans les résultats.

Champs

Nom du champDescription

from

Un objet contenant :


  • id : IGSID de l’utilisateur Instagram qui a créé le commentaire Instagram.
  • username : nom d’utilisateur Instagram qui a créé le commentaire Instagram.

hidden

Indique si le commentaire a été masqué (true) ou non (false).

id

ID du commentaire Instagram.

like_count

Nombre de mentions J’aime sur le commentaire Instagram.

media

Un objet contenant :


  • id : ID de l’objet IG Media sur lequel le commentaire Instagram a été effectué.
  • media_product_type : surface de publication de l’objet IG Media (c’est-à-dire l’endroit où l’objet IG Media apparaît) sur lequel le commentaire Instagram a été effectué.

parent_id

ID du commentaire Instagram parent si le commentaire a été créé sur un autre commentaire Instagram (réponse à un autre commentaire, par exemple).

replies

Liste des réponses (commentaires Instagram) apportées sur le commentaire Instagram.

text

Texte du commentaire Instagram.

timestamp

Horodatage au format ISO 8601 indiquant quand le commentaire Instagram a été créé.


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

user

ID de l’utilisateur Instagram qui a créé le commentaire Instagram. Celui-ci est renvoyé uniquement si l’utilisateur de l’application a créé le commentaire Instagram. Sinon, le champ username sera renvoyé à la place.

username

Nom d’utilisateur de l’utilisateur Instagram qui a créé le commentaire Instagram.

Arêtes

ArêteDescription

replies

Obtenir une liste de commentaires Instagram sur le commentaire Instagram ; créer un commentaire Instagram sur un commentaire Instagram.

Réponse

Objet au format JSON contenant des arêtes et des champs demandés et par défaut.

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

Exemple de cURL

Demande

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

Réponse

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

Mise à jour

Masquer ou afficher un commentaire

POST /{ig-comment-id}?hide={hide}

Paramètres de chaîne de requête

  • {hide} (obligatoire) : définir sur true pour masquer le commentaire ou sur false pour l’afficher.

Limites

  • Les commentaires effectués par les propriétaires d’objets médias sur leurs propres objets médias seront toujours affichés, même si les commentaires ont été définis sur hide=true.
  • Les commentaires sur les vidéos IG Media en direct ne sont pas pris en charge.

Autorisations

Un token d’accès utilisateur provenant d’un utilisateur Facebook ayant créé le commentaire, avec les autorisations suivantes :

  • instagram_basic
  • instagram_manage_comments
  • pages_show_list
  • pages_read_engagement

Si le token émane d’un utilisateur ou une utilisatrice dont le rôle sur la Page a été attribué par le biais du compte Business Manager, l’une des autorisations suivantes est également requise :

  • ads_management
  • pages_read_engagement
  • business_management

Exemple de requête

Masquer un commentaire

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

Exemple de réponse

{
  "success": true
}

Suppression

Supprimer un commentaire

DELETE /{ig-comment-id}

Autorisations

Un token d’accès utilisateur provenant de l’utilisateur ayant créé le commentaire, avec les autorisations suivantes :

  • instagram_basic
  • instagram_manage_comments

Si le token émane d’un utilisateur ou une utilisatrice dont le rôle sur la Page a été attribué par le biais du compte Business Manager, l’une des autorisations suivantes est également requise :

  • ads_management
  • pages_read_engagement
  • business_management

Limites

  • Un commentaire ne peut être supprimé que par le propriétaire de l’objet auquel ce commentaire a été ajouté, même si c’est son auteur qui tente de le supprimer.
  • Les commentaires sur les vidéos IG Media en direct ne sont pas pris en charge.

Exemple de requête

DELETE graph.facebook.com
  /17873440459141021

Exemple de réponse

{
  "success": true
}