Contenu multimédia mentionné

Renvoie les données sur un objet contenu multimédia Instagram dans lequel un utilisateur Instagram 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_media.media_id

Renvoie les données sur un objet contenu multimédia Instagram dans lequel un utilisateur Instagram a été @mentionné par un autre utilisateur Instagram.

Limites

Les mentions ne sont pas prises en charge dans les stories.
Il est impossible d’ajouter des commentaires aux photos dans lesquelles vous avez été identifié·e.
Les webhooks ne sont pas envoyés si le contenu multimédia dans lequel apparaît le commentaire ou la @mention a été créé par un compte défini comme privé.

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_media.media_id({media-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 de l’utilisateur·ice de l’application.
`{fields}` Liste d’éléments séparés par une virgule	Liste de champs Contenu multimédia Instagram séparés par une virgule que vous souhaitez voir renvoyer. En cas d’omission, les champs par défaut sont renvoyés.
`{media-id}` Chaîne obligatoire	ID de l’objet Contenu multimédia Instagram dans lequel l’utilisateur Instagram a été @mentionné dans une légende. Cet ID est inclus dans la charge utile de la notification du Webhook.

Champs

Champ	Description
`caption` Chaîne	Texte de la légende. Les légendes qui @mentionnent un utilisateur Instagram n’incluront pas le symbole `@`, sauf si l’utilisateur de l’app a créé l’objet Contenu multimédia Instagram auquel la légende est associée.
`comments` Objet	Liste de commentaires Instagram sur l’objet Contenu multimédia Instagram. Si l’élargissement de champ est utilisé pour obtenir le texte de commentaire, le texte qui @mentionne un utilisateur Instagram n’inclura pas le symbole `@`, sauf si l’utilisateur de l’app a créé l’objet Contenu multimédia Instagram auquel la légende est associée.
`comments_count` Chaîne	Nombre de commentaires Instagram sur l’objet Contenu multimédia Instagram.
`id` Chaîne par défaut	ID de l’objet Contenu multimédia Instagram.
`like_count` Chaîne	Nombre de mentions J’aime sur le contenu. Les mentions J’aime sur le contenu d’albums enfants et sur les publications promues créées à partir du contenu multimédia sont exclues. En revanche, les réponses aux commentaires sont incluses. Appels vers les versions 10.0 et antérieures : renvoie la valeur `0` si le ou la propriétaire du contenu multimédia possède des mentions J’aime masquées. Appels vers les versions 11.0 et ultérieures : le champ est omis si le ou la propriétaire du contenu multimédia possède des mentions J’aime masquées. La valeur `0` est renvoyée si le ou la propriétaire du contenu multimédia possède des mentions J’aime masquées.
`media_type` Chaîne	Type d’objet Contenu multimédia Instagram : `CAROUSEL_ALBUM`, `IMAGE`, `STORY` ou `VIDEO`.
`media_url` Chaîne	URL de l’objet Contenu multimédia Instagram publié.
`owner` Chaîne	ID de l’utilisateur Instagram qui a créé l’objet Contenu multimédia Instagram. Celui-ci est renvoyé uniquement si l’utilisateur de l’app a créé l’objet Contenu multimédia Instagram. Sinon, le champ `username` sera renvoyé.
`timestamp` Chaîne	Date de création de l’objet Contenu multimédia Instagram au format ISO 8601.
`username` Chaîne	Nom de l’utilisateur Instagram qui a créé l’objet Contenu multimédia Instagram.

Exemple de requête

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405309211844?fields=mentioned_media.media_id(17873440459141021){caption,media_type}&access_token=IGQVJ...'

Exemple de réponse

{
  "mentioned_media": {
    "caption": "metricsaurus headquarters!",
    "media_type": "IMAGE",
    "id": "17873440459141021"
  },
  "id": "17841405309211844"
}

Notez que dans l’exemple ci-dessus, l’API a supprimé le symbole @ principal sur la légende d’origine (@metricsaurus headquarters!) parce que l’utilisateur de l’app n’avait pas créé la légende.

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.