Commentaires

Représente une collection de Commentaires IG sur un objet IG Media.

Commentaires non organiques

Les commentaires sur les publicités contenant un objet IG Media (c.-à-d. des commentaires non organiques) font partie d’un autre type et ils ne sont pas pris en charge. Pour obtenir des commentaires non organiques, utilisez l’API Marketing et demandez l’effective_instagram_story_id de la publicité. Vous pourrez alors interroger l’arête /comments de l’ID renvoyé pour obtenir une collection de Commentaires Instagram non organiques. Pour en savoir plus, consultez le guide Modération des publications de l’API Marketing.

Création

Création d’un commentaire sur un objet multimédia

POST /{ig-media-id}/comments?message={message}

Crée un commentaire IG sur un objet IG Media.

Restrictions

Les commentaires sur les vidéos IG Media en direct ne sont pas pris en charge.

Paramètres de chaîne de requête

Les paramètres de chaîne de requête sont facultatifs, sauf mention contraire.

  • {message} (obligatoire) : texte à inclure dans le commentaire.

Autorisations

Token d’accès d’un utilisateur qui a créé l’objet IG Media 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 demande

POST graph.facebook.com
  /17895695668004550/comments?message=This%20is%20awesome!

Exemple de réponse

{
  "id": "17870913679156914"
}

Lecture

Obtention de commentaires sur un objet multimédia

GET /{ig-media-id}/comments

Renvoie une liste de Commentaires IG sur un objet IG Media.

Restrictions

  • Les résultats des demandes effectuées à l’aide de l’API version 3.1 ou antérieure seront renvoyés dans l’ordre chronologique. Les résultats des demandes effectuées à l’aide de l’API version 3.2 ou ultérieure seront renvoyés dans l’ordre chronologique inverse.
  • Renvoie uniquement les commentaires de niveau supérieur. Les réponses aux commentaires ne sont pas incluses sauf si vous utilisez l’élargissement de champ pour demander le champ replies.
  • Renvoie un maximum de 50 commentaires par requête.

Autorisations

Token d’accès d’un utilisateur qui a créé l’objet IG Media avec les autorisations suivantes :

  • instagram_basic
  • 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 demande

GET graph.facebook.com
  /17895695668004550/comments

Exemple de réponse

{
  "data": [
    {
      "timestamp": "2017-08-31T19:16:02+0000",
      "text": "This is awesome!",
      "id": "17870913679156914"
    },
    {
      "timestamp": "2017-08-31T18:10:30+0000",
      "text": "*Sniff*",
      "id": "17873440459141021"
    }
  ]
}

Mise à jour

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

Suppression

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