Contenido multimedia mencionado

Devuelve datos sobre un contenido multimedia de Instagram en el que un usuario de Instagram haya sido @mencionado por otro en un texto.

Creación

Esta operación no es compatible.

Lectura

GET /{ig-user-id}?fields=mentioned_media.media_id

Devuelve datos sobre un contenido multimedia de Instagram en el que un usuario de Instagram haya sido @mencionado por otro en un texto.

Limitaciones

No se admiten las menciones en Stories.
No se admiten los comentarios en las fotos en las que te hayan etiquetado.
No se enviarán webhooks si el contenido multimedia en el que aparece el comentario o la @mención se creó desde una cuenta definida como privada.

Requisitos

Tipo Descripción

Tipo	Descripción
Identificadores de acceso	Usuario
Permisos	`instagram_basic` `instagram_manage_comments` `pages_read_engagement` `pages_show_list` Si se ha concedido un rol en la página al usuario de la aplicación mediante Business Manager, también necesitarás uno de los permisos siguientes: `ads_management` `business_management`
Tareas	`MANAGE`, `CREATE_CONTENT` o `MODERATE`

Identificadores de acceso

Usuario

Permisos

instagram_basic
instagram_manage_comments
pages_read_engagement
pages_show_list

Si se ha concedido un rol en la página al usuario de la aplicación mediante Business Manager, también necesitarás uno de los permisos siguientes:

ads_management
business_management

Tareas

MANAGE, CREATE_CONTENT o MODERATE

Sintaxis de la solicitud

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

Parámetros de la cadena de consulta

Parámetro	Valor
`{access_token}` Obligatorio Cadena	Identificador de acceso del usuario de la aplicación.
`{fields}` Lista de valores separados por comas	Lista separada por comas de los campos de contenido multimedia de Instagram que quieres que se devuelvan. Si se omite, se devolverán los campos predeterminados.
`{media-id}` Cadena obligatoria	Identificador del contenido multimedia de Instagram en el que se ha @mencionado en un texto al usuario de Instagram. El identificador se incluye en la carga de la notificación del webhook.

Campos

Campo	Descripción
`caption` Cadena	Texto del comentario. Los comentarios que @mencionen a un usuario de Instagram no incluirán el símbolo `@`, a menos que el usuario de la aplicación haya creado el objeto de contenido multimedia de Instagram en el que se realizó el comentario.
`comments` Objeto	Lista de comentarios de Instagram del contenido multimedia de Instagram. Si se usa la expansión de campos para obtener el texto del comentario, el texto que @mencione a un usuario de Instagram no incluirá el símbolo `@` a menos que el usuario de la aplicación haya creado el objeto de contenido multimedia de Instagram en el que se escribió el texto.
`comments_count` Cadena	Número de comentarios de Instagram del contenido multimedia de Instagram.
`id` Cadena predeterminada	Identificador del archivo multimedia de Instagram.
`like_count` Cadena	Recuento de Me gusta del contenido multimedia. Excluye los Me gusta del contenido multimedia del elemento dependiente del álbum y los de las publicaciones promocionadas creadas desde el contenido multimedia. Incluye las respuestas en los comentarios. Llamadas de la versión 10.0 y anteriores: el valor será `0` si el propietario del contenido multimedia ha ocultado su recuento de Me gusta. Llamadas a partir de la versión 11.0: el campo se omitirá si el propietario del contenido multimedia ha ocultado su recuento de Me gusta. El valor será `0` si el propietario del contenido multimedia ha ocultado su recuento de Me gusta.
`media_type` Cadena	Tipo de contenido multimedia de Instagram: `CAROUSEL_ALBUM`, `IMAGE`, `STORY` o `VIDEO`.
`media_url` Cadena	URL del archivo multimedia de Instagram publicado.
`owner` Cadena	Identificador del usuario de Instagram que creó el contenido multimedia de Instagram. Solo se devuelve si el usuario de la aplicación creó el objeto de contenido multimedia de Instagram; de lo contrario, se devolverá el campo `username`.
`timestamp` Cadena	Fecha de creación del contenido multimedia de Instagram en formato ISO 8601.
`username` Cadena	Nombre del usuario de Instagram que creó el contenido multimedia de Instagram.

Ejemplo de solicitud

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

Ejemplo de respuesta

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

Ten en cuenta que, en el ejemplo anterior, la API ha quitado el símbolo @ del principio del texto original (@metricsaurus headquarters!) porque el usuario de la aplicación no creó el texto.

Paginación

Si usas la expansión de campos para acceder a un perímetro que admite la paginación basada en cursores, la respuesta incluirá los cursores before y after si contiene varias páginas de datos. Sin embargo, a diferencia de la paginación basada en cursores estándar, la respuesta no incluirá los campos previous o next, por lo que deberás usar los cursores before y after para construir las cadenas de consulta previous y next manualmente a fin de examinar el conjunto de datos devuelto.

Actualización

Esta operación no es compatible.

Eliminar

Esta operación no es compatible.