Plataforma do Instagram

Comentário do Instagram

Representa um comentário em uma mídia do Instagram.

Criação

Esta operação não é compatível.

Leitura

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

Essa operação obtém campos e bordas em um comentário do Instagram.

Limitações

  • Não é possível realizar solicitações em comentários descobertos por meio da API de Menções, a menos que o dono do comentário tenha feito a solicitação. Em vez disso, use o nó de comentário mencionado.
  • Comentários em mídias com restrição de idade não serão retornados.
  • Comentários criados por usuários do Instagram restringidos pelo usuário do aplicativo não serão retornados. Para que haja retorno, os usuários devem ser irrestritos, e os comentários, aprovados.
  • Só será possível ler os comentários em mídias de vídeo ao vivo do Instagram durante a transmissão.

Requisitos

TipoRequisito

Tokens de acesso

Usuário

Permissões

instagram_basic
pages_read_engagement
pages_show_list


Caso o Gerenciador de Negócios tenha sido usado para conceder uma função ao usuário do aplicativo na Página conectada ao usuário direcionado do Instagram, você também precisará de uma das seguintes permissões:


ads_management
business_management

Sintaxe da solicitação

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

Parâmetros de caminho

Espaço reservadoValor

{api-version}

A versão da API.

{ig-comment-id}

Obrigatório. A identificação do comentário do Instagram.

Parâmetros da string de consulta

ChaveEspaço reservadoValor

access_token

{access-token}

Obrigatório. O token de acesso do usuário do aplicativo.

fields

{fields}

Uma lista separada por vírgulas dos campos que você quer retornar para cada comentário do Instagram no conjunto de resultados.

Campos

Nome do campoDescrição

from

Um objeto contendo:


hidden

Indica se o comentário foi ocultado (true) ou não (false).

id

A identificação do comentário do Instagram.

like_count

O número de curtidas do comentário do Instagram.

media

Um objeto contendo o seguinte:


  • id – a identificação da mídia do Instagram na qual o comentário foi feito.
  • media_product_type – a superfície de publicação da mídia do Instagram na qual o comentário foi feito (ou seja, o local onde a mídia do Instagram aparece).

parent_id

A identificação do comentário principal do Instagram caso o comentário tenha sido criado a partir de outro (ou seja, uma resposta a um comentário).

replies

Uma lista das respostas (comentários) ao comentário do Instagram.

text

O texto do comentário do Instagram.

timestamp

Um registro de data e hora formatado conforme a norma ISO 8601 que indica quando o comentário do Instagram foi criado.


Exemplo: 2017-05-19T23:27:28+0000.

user

O número de identificação do usuário do Instagram que criou o comentário. Dado retornado somente se o usuário do aplicativo tiver criado o comentário do Instagram. Caso contrário, retornaremos username.

username

O nome de usuário do criador do comentário do Instagram.

Bordas

BordaDescrição

replies

Obtenha uma lista dos comentários em um comentário do Instagram. Crie um comentário em um comentário do Instagram.

Resposta

Um objeto formatado por JSON contendo os campos e as bordas solicitadas e padrão.

{
  "{field}":"{value}",
  ...
}

Exemplo de cURL

Solicitação

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

Resposta

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

Atualização

Como ocultar/reexibir um comentário

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

Parâmetros da string de consulta

  • {hide} (obrigatório): defina como true para ocultar ou false para exibir o comentário.

Limitações

  • Os comentários feitos por donos de objetos de mídia nos próprios objetos serão exibidos, mesmo que os comentários sejam definidos como hide=true.
  • Os comentários em mídias de vídeo ao vivo do Instagram não são compatíveis.

Permissões

Um token de acesso do usuário do Facebook que criou o comentário usando as permissões a seguir:

  • instagram_basic
  • instagram_manage_comments
  • pages_show_list
  • pages_read_engagement

Se o token for de um usuário cuja função na Página foi concedida por meio do Gerenciador de Negócios, uma das seguintes permissões também será necessária:

  • ads_management
  • pages_read_engagement
  • business_management

Exemplo de solicitação

Como ocultar um comentário:

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

Exemplo de resposta

{
  "success": true
}

Exclusão

Como excluir um comentário:

DELETE /{ig-comment-id}

Permissões

Um token de acesso do usuário que criou o comentário usando as permissões a seguir:

  • instagram_basic
  • instagram_manage_comments

Se o token for de um usuário cuja função na Página foi concedida por meio do Gerenciador de Negócios, uma das seguintes permissões também será necessária:

  • ads_management
  • pages_read_engagement
  • business_management

Limitações

  • Um comentário só poderá ser excluído pelo dono do objeto em que ele foi feito, mesmo que o usuário tentando fazer a exclusão seja o próprio autor do comentário.
  • Os comentários em mídias de vídeo ao vivo do Instagram não são compatíveis.

Exemplo de solicitação

DELETE graph.facebook.com
  /17873440459141021

Exemplo de resposta

{
  "success": true
}