Comentario de Instagram (IG)

Representa un comentario en un objeto de contenido 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 han introducido los campos siguientes:

legacy_instagram_comment_id

No se admiten los campos siguientes:

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

Esta operación no es compatible.

Lectura

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

Obtiene los campos y perímetros de un comentario de Instagram.

Limitaciones

No se puede realizar ninguna solicitud sobre los comentarios detectados mediante la API de menciones a menos que sea el propietario del comentario quien realice la solicitud. En su lugar, utiliza el nodo de comentario con menciones.
No se devuelven comentarios sobre el contenido multimedia con restricción de edad.
Los comentarios que crean los usuarios de Instagram que el usuario de la aplicación haya restringido no se devolverán a menos que se anule la restricción de los usuarios de Instagram y se aprueben los comentarios.
Los comentarios de contenido multimedia de Instagram de vídeo en directo solo se pueden leer mientras se transmite el contenido multimedia de Instagram sobre el que se realiza el comentario.

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 de comentario de Instagram.

Parámetros de la cadena de consulta

Clave	Marcador de posición	Valor
`access_token`	`<ACCESS_TOKEN>`	Obligatorio. Identificador de acceso del usuario de la aplicación.
`fields`	`<LIST_OF_FIELDS>`	Lista separada por comas de los campos de comentarios de Instagram que quieres que devuelva cada comentario de Instagram en el conjunto de resultados.

Campos

Nombre del campo	Descripción
`from`	Un objeto que contiene: `id`: identificador específico de Instagram (IGSID) del usuario de Instagram que creó el comentario de Instagram. `username`: nombre del usuario de Instagram que creó el comentario de Instagram.
`hidden`	Indica si el comentario se ha ocultado (`true`) o no (`false`).
`id`	Identificador de comentario de Instagram.
`like_count`	Número de Me gusta en el comentario de Instagram.
`legacy_instagram_comment_id`	Identificador del comentario de Instagram que se creó para los extremos de la API de marketing en la versión 21.0 y versiones anteriores.
`media`	Un objeto que contiene: `id`: identificador del contenido multimedia de Instagram sobre el que se realizó el comentario de Instagram. `media_product_type`: interfaz publicada del contenido multimedia de Instagram (es decir, ubicación donde se muestra el contenido multimedia de Instagram) sobre el que se realizó el comentario de Instagram.
`parent_id`	Identificador del comentario principal de Instagram si el comentario se creó en otro comentario de Instagram (es decir, es una respuesta a otro comentario).
`replies`	Lista de respuestas (comentarios de Instagram) del comentario de Instagram.
`text`	Texto del comentario de Instagram.
`timestamp`	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 aplicación creó el comentario de Instagram. De lo contrario, se devolverá `username`.
`username`	Nombre del usuario de Instagram que creó el comentario de Instagram. A partir del 27 de agosto de 2024, los permisos `instagram_manage_comments` (si la aplicación utiliza el inicio de sesión con Facebook) y `instagram_business_manage_comments` (si la aplicación utiliza el inicio de sesión con Instagram) serán obligatorios para acceder al campo `username` de un usuario de Instagram que haya comentado en el contenido multimedia de la cuenta profesional de Instagram de un usuario de la aplicación.

Perímetros

Perímetro	Descripción
`replies`	Obtén una lista de comentarios de Instagram sobre el comentario de Instagram. Crea un comentario de Instagram sobre un comentario de Instagram.

Respuesta

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

{
  "<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 o mostrar un comentario

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

Parámetros de la cadena de consulta

hide (obligatorio): defínelo como true para ocultar el comentario o como false para mostrarlo.

Limitaciones

Los comentarios realizados por los propietarios de objetos multimedia en sus propios objetos multimedia siempre se mostrarán, incluso si se han definido como hide=true.
No se admiten los comentarios en el contenido multimedia de Instagram de vídeo en directo.

Identificador de acceso

Un identificador de acceso del usuario al que pertenece el objeto multimedia en el que se ha hecho un comentario.

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>

Identificador de acceso

Identificador de acceso de un usuario que creó el comentario.

Limitaciones

Solo puede eliminar un comentario el propietario del objeto sobre el que se hizo el comentario, aunque el usuario que intente eliminarlo sea el mismo que lo creó.
No se admiten los comentarios en el contenido multimedia de Instagram de vídeo en directo.

Ejemplo de solicitud

DELETE graph.instagram.com
  /17873440459141021

Ejemplo de respuesta

{
  "success": true
}