Comentario con menciones de usuarios de Instagram

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

Creación

Esta operación no es compatible.

Lectura

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

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

Limitaciones

Este extremo devolverá un error si los comentarios se han desactivado en el contenido multimedia de Instagram en el que se ha @mencionado al usuario de Instagram.

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_comment.comment_id({comment-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.
`{comment-id}` Obligatorio Cadena	Identificador del comentario de Instagram en el que se ha @mencionado al usuario de Instagram. El identificador se incluye en la carga útil de la notificación del webhook.
`{fields}` Lista de valores separados por comas	Lista separada por comas de los campos del comentario de Instagram que quieres que se devuelvan. Si se omite, se devolverán los campos predeterminados.

Campos

Campo	Descripción
`id` Predeterminado Cadena	Identificador del comentario de Instagram.
`like_count` Cadena	Número de veces que se ha indicado Me gusta en el comentario de Instagram.
`media` Cadena	Identificador del contenido multimedia de Instagram en el que se realizó el comentario de Instagram. Usa la expansión de campos para obtener campos adicionales sobre la entidad de contenido multimedia de Instagram devuelta.
`text` Predeterminado Cadena	Texto del comentario de Instagram.
`timestamp` Predeterminado Cadena	Fecha de creación del comentario de Instagram en formato ISO 8601.

Respuesta

Ejemplo de solicitud

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

Ejemplo de respuesta

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

Expansión de campos

Puedes expandir el campo media con una lista de campos del contenido multimedia de Instagram a fin de obtener datos adicionales de la entidad de contenido multimedia sobre la que se realizó el comentario. Por ejemplo:

media{id,media_url}

Llamadas de la versión 10.0 y anteriores hasta el 7 de septiembre de 2021: el campo like_count de un contenido multimedia de Instagram devolverá 0 si la persona propietaria ha ocultado el recuento de Me gusta de dicho contenido.

Llamadas de la versión 11.0 y posteriores a partir del 7 de septiembre de 2021: si consultas un contenido multimedia de Instagram indirectamente a través de otro extremo o expansión de campo, el campo like_count se omitirá de las respuestas de la API si el propietario del contenido multimedia ha ocultado su recuento de Me gusta. Al consultar directamente el contenido multimedia de Instagram (solo puede hacerlo su propietario), se devolverá el recuento real de Me gusta, aunque se haya ocultado.

Ejemplo de solicitud de expansión de campos

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...'

Ejemplo de respuesta de expansión de campos

{
  "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"
}

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.

Eliminación

Esta operación no es compatible.