Comentario de Instagram

Representa un comentario en un objeto multimedia de Instagram.

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

Se introducen los siguientes campos:

legacy_instagram_comment_id

No se admiten los siguientes campos:

comment_type
mentioned_instagram_users

Requirements

	Instagram API with Instagram Login	Instagram API with Facebook Login
Access Tokens	Instagram User access token	Facebook 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`

Creación

No se admite esta operación.

Lectura

GET <HOST_URL>/<IG_COMMENT_ID>?fields=<LIST_OF_FIELDS>

Se usa para obtener campos y perímetros en un comentario de Instagram.

Limitaciones

Las solicitudes no se pueden realizar en comentarios descubiertos a través de la API de Mentions, a menos que el propietario del comentario sea quien realice la solicitud. Como alternativa, usa el nodo del comentario mencionado.
Los comentarios sobre contenido multimedia con restricciones por edad no se devuelven.
No se devolverán los comentarios creados por usuarios de Instagram que el usuario de la app haya restringido, a menos que se eliminen las restricciones de los usuarios de Instagram y se aprueben los comentarios.
Los comentarios del contenido multimedia de Instagram de videos en vivo solo pueden leerse mientras el contenido multimedia de Instagram sobre el cual se creó el comentario se está transmitiendo.

Sintaxis de la solicitud

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

Parámetros de ruta

Marcador de posición	Valor
`<API_VERSION>`	Versión de la API.
`<HOST_URL>`	Versión de la API.
`<IG_COMMENT_ID>`	Obligatorio. Identificador del comentario de Instagram.

Parámetros de la cadena de consulta

Clave	Marcador de posición	Valor
`access_token`	`<ACCESS_TOKEN>`	Obligatorio. Token de acceso del usuario de la app.
`fields`	`<LIST_OF_FIELDS>`	Lista separada por comas de los campos de comentarios de Instagram que deseas que se devuelvan en el conjunto de resultados en relación con cada comentario de Instagram.

Campos

Nombre del campo	Descripción
`from`	Un objeto que contiene lo siguiente: `id`: el identificador específico de Instagram (IGSID) del usuario de Instagram que creó el comentario en IG. `username`: el nombre del usuario de Instagram que creó el comentario en IG.
`hidden`	Indica si se ocultó el comentario (`true`) o no (`false`).
`id`	Identificador del comentario de Instagram.
`like_count`	Cantidad de "Me gusta" en el comentario de Instagram.
`legacy_instagram_comment_id`	El identificador del comentario de Instagram que se creó para los puntos de conexión de la API de marketing en v21.0 y versiones posteriores.
`media`	Un objeto que contiene lo siguiente: `id`: identificador del contenido multimedia de Instagram en el que se hizo el comentario de Instagram. `media_product_type`: superficie de publicación del contenido multimedia de Instagram (es decir, donde aparece el contenido multimedia de Instagram) en el que se hizo el comentario de Instagram.
`parent_id`	Identificador del comentario principal de Instagram si dicho comentario se creó en otro comentario de Instagram (por ejemplo, una respuesta a otro comentario).
`replies`	Una lista de respuestas (comentarios de Instagram) que se incluyen en el comentario de Instagram.
`text`	Texto del comentario de Instagram.
`timestamp`	Una marca de tiempo con formato ISO 8601 que indica cuándo se creó el comentario de Instagram. Ejemplo: `2017-05-19T23:27:28+0000`.
`user`	Identificador del usuario de Instagram que creó el comentario de Instagram. Solo se devuelve si el usuario de la app creó el comentario de Instagram; de lo contrario, se devuelve `username` en su lugar.
`username`	Nombre del usuario de Instagram que creó el comentario de Instagram. A partir del 27 de agosto de 2024, el permiso `instagram_manage_comments` (si tu app usa el inicio de sesión con Facebook) y el permiso `instagram_business_manage_comments` (si tu app usa el inicio de sesión con Instagram) serán obligatorios para acceder al campo `username` de un usuario de Instagram que comentó en el contenido multimedia de la cuenta profesional de Instagram de otro usuario.

Perímetros

Perímetro	Descripción
`replies`	Obtiene una lista de los comentarios de Instagram en el comentario de Instagram. Crea un comentario de Instagram en un comentario de Instagram.

Respuesta

Objeto con formato JSON con los campos y perímetros predeterminados y solicitados.

{
  "<FIELD>":"<VALUE>",
  ...
}

Ejemplo de cURL

Solicitud

curl -i -X GET \
 "https://graph.instagram.com/v25.0/17881770991003328?fields=hidden%2Cmedia%2Ctimestamp&access_token=EAAOc..."

Respuesta

{
  "hidden": false,
  "media": {
    "id": "17856134461174448"
  },
  "timestamp": "2017-05-19T23:27:28+0000",
  "id": "17881770991003328"
}

Actualización

Ocultar y mostrar un comentario

POST <HOST_URL>/<IG_COMMENT_ID>?hide=<BOOLEAN>

Parámetros de la cadena de consulta

hide (obligatorio): configúralo en true para ocultar el comentario o en false para mostrarlo.

Limitaciones

Los comentarios hechos por propietarios de objetos multimedia en sus propios objetos multimedia siempre se mostrarán, aun cuando se haya fijado el valor hide=true para dichos comentarios.
No se admiten los comentarios en el contenido multimedia de Instagram de videos en vivo.

Token de acceso

Un token de acceso del usuario que es propietario del objeto de contenido multimedia que se comentó.

Ejemplo de solicitud

Ocultar un comentario:

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

Ejemplo de respuesta

{
  "success": true
}

Eliminación

Eliminar un comentario

DELETE <HOST_URL>/<IG_COMMENT_ID>

Token de acceso

El token de acceso del usuario que creó el comentario.

Limitaciones

Solo puede eliminar un comentario el propietario del objeto en el que se realizó el comentario, aun cuando el usuario que intente eliminar el comentario sea quien lo hizo.
No se admiten los comentarios en el contenido multimedia de Instagram de videos en vivo.

Ejemplo de solicitud

DELETE graph.instagram.com
  /17873440459141021

Ejemplo de respuesta

{
  "success": true
}