Marcar pessoas e adicionar uma localização a uma publicação do Instagram através da API
A API do Instagram marca pessoas com user_tags e adiciona um local com location_id, ambos definidos no media container antes de ser publicado. user_tags recebe nomes de utilizador públicos, com coordenadas x e y de 0.0 a 1.0 obrigatórias nas imagens; a Meta descreve-o para imagens, vídeos e Stories. location_id recebe o ID de uma Página com dados de localização, encontrado através da Pages Search API.
O easyCoexistence publica fotos, carrosséis, Reels e Stories com publish_instagram_post a partir do Claude, do ChatGPT ou do seu próprio código.
Intervalo das coordenadas x e y em user_tags, medido a partir das margens esquerda e superior da imagem.
Onde user_tags exige x e y: são opcionais nas Stories, e aplicam-se apenas a imagens e Stories.
location_id não é suportado nas imagens ou vídeos dentro de um carrossel, segundo a referência de média da Meta.
O valor config_issue quando o media é publicado sem as marcações de utilizador, que a Meta chama sucesso parcial.
Quando a Meta abriu a marcação de locais e de utilizadores públicos do Instagram em fotos publicadas pela API, primeiro aos parceiros beta.
Como se marcam pessoas numa publicação?
Adicione user_tags ao container. É um array de objetos, cada um com o nome de utilizador de uma conta pública do Instagram e, numa imagem, x e y: floats de 0.0 a 1.0 que indicam a distância da marcação às margens esquerda e superior. Um local vai em location_id na mesma chamada, e o container é depois publicado com media_publish como de costume.
POST /<IG_ID>/media
Content-Type: application/json
{
"image_url": "https://example.com/team.jpg",
"caption": "<CAPTION>",
"user_tags": [
{ "username": "<USERNAME>", "x": 0.42, "y": 0.61 }
],
"location_id": "<PAGE_ID>"
}Que publicações aceitam marcações de utilizador e localização?
A referência de média da Meta descreve user_tags para imagens, vídeos e Stories, com x e y a aplicarem-se apenas a imagens e Stories, e lista os parâmetros que cada container aceita. Num carrossel, o local vai no container do carrossel, já que location_id não é suportado nas imagens ou vídeos que o compõem:
Como se encontra um location_id?
Pesquise uma Página. location_id é o ID de uma Página associada a um local, e a referência da Meta aponta para a Pages Search API, GET /pages/search com q e fields=id,name,location, e depois para a verificação de que a Página escolhida tem dados de localização. Uma Página sem esses dados falha com INSTAGRAM_PLATFORM_API__INVALID_LOCATION_ID. A pesquisa corre na Graph API da Meta com o token da sua própria app da Meta: um token de utilizador ou, para informação pública de uma Página, um token de app com a funcionalidade Page Public Metadata Access.
GET /pages/search
?q=<PLACE_NAME>
&fields=id,name,location
&access_token=<ACCESS_TOKEN>O que acontece se uma marcação não ficar associada?
A publicação pode ainda ir ao ar. media_publish devolve então config_issue com o valor USER_TAGGING_FAILURE, o que significa que o media foi publicado sem as marcações de utilizador. A Meta chama a isto sucesso parcial e pede às apps que o tratem como um sinal para reconciliar, e não como um erro, já que o ID do media é válido; publicar de novo criaria uma segunda publicação.
As marcações de utilizador funcionam com o Instagram Login?
A referência de média da Meta lista user_tags e location_id para a criação de containers, sem os associar a um único login. Já a página da API do Instagram com Instagram Login diz que essa configuração não pode aceder a anúncios nem a marcações, sem dizer que marcações quer dizer. Antes de construir sobre qualquer um dos parâmetros com Instagram Login, publique um conteúdo de teste e verifique a resposta e a própria publicação.
Como se marcam pessoas através do easyCoexistence?
Ainda não é possível. publish_instagram_post cria o container por si e não aceita user_tags nem location_id, e os tokens do Instagram não são entregues para uma chamada própria. Publique a publicação com publish_instagram_post e depois acrescente as marcações e a localização na aplicação do Instagram, a partir da opção Editar da publicação.
Erros comuns
- Deixar x e y de fora numa marcação de imagem. A Meta exige-os nas imagens; só as Stories os tornam opcionais.
- Indicar coordenadas em pixels ou percentagem. x e y são floats de 0.0 a 1.0, medidos a partir das margens esquerda e superior.
- Definir location_id nos itens de um carrossel. A Meta não o suporta nas imagens ou vídeos dentro de um carrossel.
- Marcar uma conta privada. user_tags aceita apenas os nomes de utilizador de contas públicas do Instagram.
A ferramenta não aceita user_tags nem location_id, pelo que as pessoas e os locais são marcados na aplicação do Instagram, a partir da opção Editar da publicação. De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias grátis.
Perguntas frequentes
Posso marcar uma conta privada do Instagram através da API?
Não. A referência de média da Meta diz que user_tags aceita os nomes de utilizador de contas públicas do Instagram, por isso uma conta privada não pode ser marcada desta forma.
Quantas pessoas podem ser marcadas numa publicação?
A referência da Meta para user_tags não indica máximo. O limite de 20 que refere aplica-se às menções @ numa legenda.
Posso adicionar um local a uma Story através da API?
Não. A sintaxe da Meta para um container de Story lista user_tags, mas não location_id.
Posso marcar um produto em vez de uma pessoa?
As marcações de produto são uma funcionalidade separada, que a visão geral da Meta lista como suportada com o Facebook Login e o Unified Login, e não com o Instagram Login.
Continue a ler
Ligue o seu primeiro canal em dois minutos.
Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorizado 24/7
Verificado em