Plataforma de Instagram

Comentario de Instagram

Representa un comentario en un contenido multimedia de Instagram.

Creación

No se admite esta operación.

Lectura

GET /{ig-comment-id}?fields={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 Mentions, a menos que el propietario del comentario sea quien realice la solicitud. Como alternativa, usa el nodo de 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.

Requisitos

TipoRequisito

Tokens de acceso

Usuario

Permisos

instagram_basic
pages_read_engagement
pages_show_list


Si se usó el administrador comercial para otorgar un rol al usuario de la app en la página conectada al usuario de Instagram al que se hace referencia, también necesitarás alguno de los siguientes elementos:


ads_management
business_management

Sintaxis de la solicitud

GET https://graph.facebook.com/{api-version}/{ig-comment-id}
  ?fields={fields}
  &access_token={access-token}

Parámetros de ruta

Marcador de posiciónValor

{api-version}

Versión de la API.

{ig-comment-id}

Obligatorio. Identificador del comentario de Instagram.

Parámetros de la cadena de consulta

ClaveMarcador de posiciónValor

access_token

{access-token}

Obligatorio. Token de acceso del usuario de la app.

fields

{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 campoDescripción

from

Un objeto que contiene:


  • id: el IGSID del usuario de Instagram que creó el comentario de Instagram.
  • username: el nombre del usuario de Instagram que creó el comentario de Instagram.

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.

media

Un objeto que contiene:


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.

Perímetros

PerímetroDescripció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.facebook.com/v19.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 /{ig-comment-id}?hide={hide}

Parámetros de la cadena de consulta

  • {hide} (obligatorio): fíjalo 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.

Permisos

El token de acceso de un usuario de Facebook que creó el objeto multimedia, con los siguientes permisos:

  • instagram_basic
  • instagram_manage_comments
  • pages_show_list
  • pages_read_engagement

Si el token es de un usuario al que se le asignó un rol de página mediante el administrador comercial, también se requiere uno de los siguientes permisos:

  • ads_management
  • pages_read_engagement
  • business_management

Ejemplo de solicitud

Ocultar un comentario:

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

Ejemplo de respuesta

{
  "success": true
}

Eliminación

Eliminar un comentario

DELETE /{ig-comment-id}

Permisos

El token de acceso del usuario que creó el comentario, con los siguientes permisos:

  • instagram_basic
  • instagram_manage_comments

Si el token es de un usuario al que se le asignó un rol de página mediante el administrador comercial, también se requiere uno de los siguientes permisos:

  • ads_management
  • pages_read_engagement
  • business_management

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.facebook.com
  /17873440459141021

Ejemplo de respuesta

{
  "success": true
}