Criação
Esta operação não é compatível.
Leitura
GET /{ig-user-id}/tags
Retorna uma lista de objetos de mídia em que um usuário foi marcado por outro usuário no Instagram.
Limitações
Os objetos privados de mídia do Instagram não serão retornados.
Requisitos
| Tipo | Descrição |
|---|---|
Não aplicável. | |
Se o token for de um usuário que recebeu uma função administrativa por meio do Gerenciador de Negócios, uma das permissões a seguir também será necessária: | |
O usuário do app precisa ser capaz de executar as tarefas apropriadas na Página com base nas permissões solicitadas pelo app. |
Sintaxe da solicitação
GET https://graph.facebook.com/{ig-user-id}/tags
?fields={fields}
&access_token={access-token}Parâmetros da string de consulta
Inclua o parâmetro da string de consulta a seguir para ampliar a solicitação.
| Chave | Valor |
|---|---|
| O token de acesso do usuário do Instagram do usuário do app. |
| Uma lista separada por vírgulas dos campos e das bordas que devem ser incluídos na resposta. Se omitida, os campos padrão serão retornados. |
Campos
Use o parâmetro da string de consulta fields para especificar os campos que devem ser incluídos nos objetos de mídia do Instagram retornados.
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.
Bordas
Use o parâmetro da string de consulta fields para especificar as bordas que devem ser incluídas nos objetos de mídia do Instagram retornados.
Resposta
Um objeto formatado em JSON que contém objetos de mídia do Instagram.
{
"{field}":"{value}",
...
}Paginação
Esta borda é compatível com a paginação baseada em cursor. Portanto, 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 strings de consulta previous e next a fim de navegar pelas páginas do conjunto de dados retornado.
Exemplo de solicitação
GET graph.facebook.com/17841405822304914/tags
?fields=id,username
&access_token=EAADd...Exemplo de resposta
{
"data": [
{
"id": "18038...",
"username": "keldo..."
},
{
"id": "17930...",
"username": "ashla..."
},
{
"id": "17931...",
"username": "jaypo..."
}
]
}Atualização
Esta operação não é compatível.
Exclusão
Esta operação não é compatível.