Plataforma de Instagram

Comentario de Instagram

Representa un comentario en un objeto de contenido multimedia de Instagram.

Creación

Esta operación no es compatible.

Lectura

GET /{ig-comment-id}?fields={fields}

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

Limitaciones

  • No se puede realizar ninguna operación sobre los comentarios detectados a través de la API de menciones a menos que sea el propietario del comentario quien realice la solicitud. En lugar de eso, 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.

Requisitos

TipoRequisito

Identificadores de acceso

Usuario

Permisos

instagram_basic
pages_read_engagement
pages_show_list


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


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

Parámetros de la cadena de consulta

ClaveMarcador de posiciónValor

access_token

{access-token}

Obligatorio. Identificador de acceso del usuario de la aplicación.

fields

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

from

Un objeto que contiene:


  • id: 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.

media

Un objeto que contiene:


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.

Perímetros

PerímetroDescripció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.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 o mostrar un comentario

POST /{ig-comment-id}?hide={hide}

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.

Permisos

Identificador de acceso de un usuario de Facebook que creó el comentario, con los permisos siguientes:

  • instagram_basic
  • instagram_manage_comments
  • pages_show_list
  • pages_read_engagement

Si el identificador es de un usuario cuyo rol de página se ha concedido mediante Business Manager, también se necesita uno de los permisos siguientes:

  • 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

Identificador de acceso de un usuario que creó el comentario, con los permisos siguientes:

  • instagram_basic
  • instagram_manage_comments

Si el identificador es de un usuario cuyo rol de página se ha concedido mediante Business Manager, también se necesita uno de los permisos siguientes:

  • ads_management
  • pages_read_engagement
  • business_management

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

Ejemplo de respuesta

{
  "success": true
}