[go: up one dir, main page]
Plateforme Instagram

Commentaire Instagram

Représente un commentaire sur un objet multimédia Instagram.

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

Vue d’ensemble des champs suivants :

  • legacy_instagram_comment_id

Les éléments suivants ne sont pas pris en charge :

  • 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

Création

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

Lecture

GET <HOST_URL>/<IG_COMMENT_ID>?fields=<LIST_OF_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 contenus multimédias soumis à une limite d’âge ne sont pas renvoyés.
  • Les commentaires créés par des utilisateur·ices Instagram pour lesquel·les des restrictions ont été définies par l’utilisateur·ice 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.

Syntaxe de la requête

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

Paramètres du chemin

Espace réservéValeur

<API_VERSION>

Version de l’API.

<HOST_URL>

Version de l’API.

<IG_COMMENT_ID>

Obligatoire. ID du commentaire Instagram.

Paramètres de la chaîne de requête

CléEspace réservéValeur

access_token

<ACCESS_TOKEN>

Obligatoire. Token d’accès de l’utilisateur·ice de l’application.

fields

<LIST_OF_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 : ID spécifique à Instagram (IGSID) de l’utilisateur·ice Instagram ayant créé le commentaire Instagram.
  • username : nom de l’utilisateur·ice Instagram ayant 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.

legacy_instagram_comment_id

ID Instagram du commentaire créé pour les points de terminaison de l’API Marketing dans les versions 21.0 et antérieures.

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·ice Instagram qui a créé le commentaire Instagram. Celui-ci est renvoyé uniquement si l’utilisateur·ice de l’application a créé le commentaire Instagram. Sinon, le champ username sera renvoyé à la place.

username

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

À compter du 27 août 2024, vous aurez besoin des autorisations instagram_manage_comments (si votre application utilise Facebook Login) et instagram_business_manage_comments (si votre application utilise la connexion Instagram) pour accéder au champ username d’un·e utilisateur·ice Instagram qui a commenté le contenu multimédia d’un compte professionnel Instagram d’un·e utilisateur·ice de l’application.

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

Requête

curl -i -X GET \
 "https://graph.instagram.com/v24.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 <HOST_URL>/<IG_COMMENT_ID>?hide=<BOOLEAN>

Paramètres de la 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.

Token d’accès

Token d'accès de l'utilisateur·ice qui possède l'objet multimédia qui a été commenté.

Exemple de requête

Masquer un commentaire :

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

Exemple de réponse

{
  "success": true
}

Suppression

Supprimer un commentaire

DELETE <HOST_URL>/<IG_COMMENT_ID>

Token d’accès

Token d’accès utilisateur provenant de l’utilisateur·ice ayant créé le commentaire.

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

Exemple de réponse

{
  "success": true
}