Comentário mencionado do usuário do Instagram
Retorna dados sobre um comentário do Instagram em que um usuário foi @mencionado por outro.
Criação
Esta operação não é compatível.
Leitura
GET /{ig-user-id}?fields=mentioned_comment.comment_id
Retorna dados sobre um comentário do Instagram em que um usuário foi @mencionado por outro.
Limitações
Este ponto de extremidade retornará um erro caso os comentários tenham sido desabilitados na mídia do Instagram em que o usuário foi @mencionado.
Requisitos
| Tipo | Descrição |
|---|---|
Caso uma função administrativa tenha sido concedida ao usuário do app por meio do Gerenciador de Negócios, você precisará obter uma das seguintes permissões: | |
|
Sintaxe da solicitação
GET https://graph.facebook.com/v19.0/{ig-user-id}
?fields=mentioned_comment.comment_id({comment-id}){{fields}}
&access_token={access-token}Parâmetros da string de consulta
| Parâmetro | Valor |
|---|---|
| O token de acesso do usuário do app. |
| O ID do comentário do Instagram em que o usuário foi @mencionado. O ID será incluído na carga da notificação do Webhook. |
| Uma lista separada por vírgulas dos campos do comentário do Instagram que devem ser retornados. Se omitida, os campos padrão serão retornados. |
Campos
| Campo | Descrição |
|---|---|
| O ID do comentário do Instagram. |
| O número de vezes em que o comentário do Instagram foi curtido. |
| O ID da mídia do Instagram em que o comentário foi feito. Use a expansão de campo para obter campos adicionais sobre a entidade de mídia do Instagram retornada. |
| O texto do comentário do Instagram. |
| A data de criação do comentário do Instagram formatada de acordo com a norma ISO 8601. |
Resposta
Exemplo de solicitação
curl -X GET \
'https://graph.facebook.com/v19.0/17841405309211844?fields=mentioned_comment.comment_id(17873440459141021){timestamp,like_count,text,id}&access_token=IGQVJ...'
Exemplo de resposta
{
"mentioned_comment": {
"timestamp": "2017-05-03T16:09:08+0000",
"like_count": 185,
"text": "Shout out to @metricsaurus",
"id": "17873440459141021"
},
"id": "17841405309211844"
}Expansão de campo
É possível expandir o campo media com uma lista de campos de mídia do Instagram para obter dados adicionais sobre a publicação em que o comentário foi feito. Por exemplo:
media{id,media_url}Chamadas à versão 10.0 e anteriores até 7 de setembro de 2021: o campo like_count em uma mídia do IG retornará 0 se o proprietário da mídia tiver ocultado a contagem de curtidas.
Chamadas à versão 11.0 e posteriores e a todas as versões em 7 de setembro de 2021: caso seja feita uma consulta indireta a uma mídia do IG por meio de outro ponto de extremidade ou expansão do campo, o campo like_count será omitido das respostas de API se o dono da mídia tiver ocultado a contagem de curtidas. A consulta direta à mídia do IG (que pode ser realizada somente pelo dono da mídia) retornará o número real de curtidas, mesmo se o dono tiver ocultado a contagem.
Exemplo de solicitação de expansão de campo
curl -X GET \
'https://graph.facebook.com/v19.0/17841405309211844?fields=mentioned_comment.comment_id(17873440459141021){timestamp,like_count,text,media{id,media_url}}&access_token=IGQVJ...'
Exemplo de resposta de expansão de campo
{
"mentioned_comment": {
"timestamp": "2017-05-03T16:09:08+0000",
"like_count": 185,
"text": "Shout out to @metricsaurus",
"id": "17873440459141021",
"media": {
"id": "17895695668004550",
"media_url": "https://scont..."
}
},
"id": "17841405309211844"
}Paginação
Caso você use a expansão de campo para acessar uma borda compatível com a paginação baseada em cursor, a resposta incluirá os cursores before e after se houver múltiplas páginas de dados. No entanto, ao contrário da paginação baseada em cursor padrão, a resposta não incluirá os campos previous ou next. Assim, você precisará usar os cursores before e after para criar manualmente as listas das strings de consulta previous e next e poder navegar pelas páginas do conjunto de dados retornado.
Atualização
Esta operação não é compatível.
Exclusão
Esta operação não é compatível.