Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

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.

0.0 to 1.0

Intervalo das coordenadas x e y em user_tags, medido a partir das margens esquerda e superior da imagem.

Images

Onde user_tags exige x e y: são opcionais nas Stories, e aplicam-se apenas a imagens e Stories.

Carousels

location_id não é suportado nas imagens ou vídeos dentro de um carrossel, segundo a referência de média da Meta.

USER_TAGGING_FAILURE

O valor config_issue quando o media é publicado sem as marcações de utilizador, que a Meta chama sucesso parcial.

13 Mar 2018

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.

An image container with a user tag and a location
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:

Imageuser_tags with x and y, and location_id
Reeluser_tags by username, and location_id
Storyuser_tags, with x and y optional; no location_id in its syntax
Carousel containerlocation_id, and no user_tags in its syntax
Carousel itemsNo location_id

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.

Searching for a Page with a location
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.
Fazer isto com a EasyCoexistence

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