Commentaire mentionné par un utilisateur IG

Renvoie les données sur un objet IG Comment dans lequel un Utilisateur IG a été @mentionné par un autre utilisateur Instagram.

Création

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

Lecture

GET /{ig-user-id}?fields=mentioned_comment.comment_id

Renvoie les données sur un objet Commentaire IG dans lequel un Utilisateur IG a été @mentionné par un·e autre utilisateur·ice Instagram.

Limites

Ce point de terminaison renvoie une erreur si les commentaires ont été désactivés sur l’objet IG Media sur lequel l’utilisateur IG a été @mentionné.

Conditions requises

Type Description

Type	Description
Tokens d’accès	Utilisateur·ice
Autorisations	`instagram_basic` `instagram_manage_comments` `pages_read_engagement` `pages_show_list` Si un rôle sur la Page a été attribué à l’utilisateur·ice de l’application via Business Manager, vous aurez également besoin de l’un des éléments suivants : `ads_management` `business_management`
Tâches	`MANAGE`, `CREATE_CONTENT` ou `MODERATE`

Tokens d’accès

Utilisateur·ice

Autorisations

instagram_basic
instagram_manage_comments
pages_read_engagement
pages_show_list

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

ads_management
business_management

Tâches

MANAGE, CREATE_CONTENT ou MODERATE

Syntaxe de la requête

GET https://graph.facebook.com/v19.0/{ig-user-id}
  ?fields=mentioned_comment.comment_id({comment-id}){{fields}}
  &access_token={access-token}

Paramètres de chaîne de requête

Paramètre	Valeur
`{access_token}` Chaîne obligatoire	Token d’accès utilisateur de l’utilisateur·ice de l’application.
`{comment-id}` Chaîne obligatoire	ID du commentaire IG dans lequel l’utilisateur IG a été @mentionné. Cet ID est inclus dans la charge utile de la notification du Webhook.
`{fields}` Liste d’éléments séparés par une virgule	Liste de champs Commentaire IG séparés par une virgule que vous souhaitez voir renvoyer. En cas d’omission, les champs par défaut sont renvoyés.

Champs

Champ	Description
`id` Chaîne par défaut	ID du commentaire IG.
`like_count` Chaîne	Nombre total de fois où le commentaire IG a été mentionné comme J’aime.
`media` Chaîne	ID de l’objet IG Media sur lequel le commentaire IG a été effectué. Utilisez l’élargissement de champ pour obtenir des champs supplémentaires sur l’entité IG Media renvoyée.
`text` Chaîne par défaut	Texte du commentaire IG.
`timestamp` Chaîne par défaut	Date de création du commentaire IG au format ISO 8601.

Réponse

Exemple de requête

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405309211844?fields=mentioned_comment.comment_id(17873440459141021){timestamp,like_count,text,id}&access_token=IGQVJ...'

Exemple de réponse

{
  "mentioned_comment": {
    "timestamp": "2017-05-03T16:09:08+0000",
    "like_count": 185,
    "text": "Shout out to @metricsaurus",
    "id": "17873440459141021"
  },
  "id": "17841405309211844"
}

Élargissement de champ

Vous pouvez élargir le champ media avec une liste de champs IG Media pour obtenir des données supplémentaires sur l’entité IG Media sur laquelle le commentaire a été effectué. Par exemple :

media{id,media_url}

Appels des versions 10.0 et antérieures jusqu’au 7 septembre 2021 : le champ like_count associé à un contenu multimédia Instagram renvoie la valeur 0 si le propriétaire du contenu a choisi de masquer les mentions J’aime pour ce contenu.

Appels des versions 11.0 et ultérieures à partir du 7 septembre 2021 : si vous interrogez un contenu multimédia Instagram de manière indirecte par le biais d’un autre point de terminaison ou élargissement de champ, le champ like_count sera omis des réponses de l’API si le propriétaire du contenu multimédia a masqué les mentions J’aime pour ce contenu. Si vous interrogez le contenu multimédia Instagram de manière directe, c’est-à-dire par l’intermédiaire de son propriétaire, le nombre réel de mentions J’aime sera renvoyé, même si le propriétaire a masqué les mentions J’aime pour ce contenu.

Exemple de demande d’élargissement de champ

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405309211844?fields=mentioned_comment.comment_id(17873440459141021){timestamp,like_count,text,media{id,media_url}}&access_token=IGQVJ...'

Exemple de réponse d’élargissement de champ

{
  "mentioned_comment": {
    "timestamp": "2017-05-03T16:09:08+0000",
    "like_count": 185,
    "text": "Shout out to @metricsaurus",
    "id": "17873440459141021",
    "media": {
      "id": "17895695668004550",
      "media_url": "https://scont..."
    }
  },
  "id": "17841405309211844"
}

Pagination

Si vous utilisez l’élargissement de champ pour accéder à une arête qui prend en charge la pagination en fonction de curseurs, la réponse inclura les curseurs before et after si la réponse contient plusieurs pages de données. Toutefois, à la différence de la pagination en fonction de curseurs standard, la réponse n’inclura pas les champs previous ou next. Vous devrez donc utiliser les curseurs before et after pour construire les chaînes de requête previous et next manuellement afin de parcourir les pages de l’ensemble de données renvoyé.

Mise à jour

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

Suppression

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