AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

Personen markieren und einen Standort zu einem Instagram-Beitrag über die API hinzufügen

Die Instagram-API markiert Personen mit user_tags und fügt einen Ort mit location_id hinzu. Beides wird am Media-Container gesetzt, bevor er veröffentlicht wird. user_tags nimmt öffentliche Benutzernamen entgegen, und bei Bildern sind x- und y-Koordinaten von 0.0 bis 1.0 Pflicht. Meta beschreibt das für Bilder, Videos und Stories. location_id erwartet die ID einer Seite mit Standortdaten, die über die Pages Search API gefunden wird.

easyCoexistence veröffentlicht Fotos, Karussells, Reels und Stories mit publish_instagram_post aus Claude, ChatGPT oder Ihrem eigenen Code.

0.0 to 1.0

Wertebereich der x- und y-Koordinaten in user_tags, gemessen vom linken und oberen Bildrand.

Images

Wo user_tags x und y verlangt: Bei Stories sind sie optional, und sie gelten nur für Bilder und Stories.

Carousels

location_id wird bei den Bildern oder Videos innerhalb eines Karussells nicht unterstützt, laut Metas Medienreferenz.

USER_TAGGING_FAILURE

Der Wert config_issue, wenn Medien ohne ihre Benutzer-Tags veröffentlicht werden, was Meta als teilweisen Erfolg bezeichnet.

13 Mar 2018

Wann Meta das Markieren von Standorten und öffentlichen Instagram-Benutzern in über die API veröffentlichten Fotos zuerst für Beta-Partner geöffnet hat.

Wie markiert man Personen in einem Beitrag?

Fügen Sie user_tags zum Container hinzu. Das ist ein Array aus Objekten, jeweils mit dem Benutzernamen eines öffentlichen Instagram-Kontos und bei einem Bild mit x und y: Fließkommazahlen von 0.0 bis 1.0, die den Abstand der Markierung vom linken und oberen Rand angeben. Ein Standort wird im selben Aufruf in location_id angegeben. Danach wird der Container wie gewohnt mit media_publish veröffentlicht.

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>"
}

Welche Beiträge unterstützen Benutzer-Tags und einen Standort?

Metas Medienreferenz beschreibt user_tags für Bilder, Videos und Stories. x und y gelten nur für Bilder und Stories. Dort steht auch, welche Parameter jeder Container akzeptiert. Bei einem Karussell wird der Standort auf den Karussell-Container gesetzt, da location_id bei den darin enthaltenen Bildern oder Videos nicht unterstützt wird:

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

Wie findet man eine location_id?

Suchen Sie nach einer Seite. location_id ist die ID einer Seite, die einem Standort zugeordnet ist. Metas Referenz verweist auf die Pages Search API, GET /pages/search mit q und fields=id,name,location, und darauf, zu prüfen, ob die gewählte Seite Standortdaten hat. Eine Seite ohne solche Daten schlägt mit INSTAGRAM_PLATFORM_API__INVALID_LOCATION_ID fehl. Die Suche läuft über die Graph API von Meta mit dem Token Ihrer eigenen Meta-App: ein Benutzer-Token oder, für öffentliche Seiteninformationen, ein App-Token mit dem Feature 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>

Was passiert, wenn eine Markierung nicht angehängt wird?

Der Beitrag kann trotzdem live gehen. media_publish gibt dann config_issue mit dem Wert USER_TAGGING_FAILURE zurück, was bedeutet, dass das Medium ohne seine Benutzer-Tags veröffentlicht wurde. Meta nennt das einen teilweisen Erfolg und rät Apps, es als Anlass zum Abgleichen zu behandeln statt als Fehler, da die Medien-ID gültig ist. Erneutes Veröffentlichen würde einen zweiten Beitrag erzeugen.

Funktionieren Benutzer-Tags mit Instagram Login?

Metas Medienreferenz führt user_tags und location_id für die Erstellung von Containern auf, ohne sie an einen bestimmten Login zu binden. Ihre Seite zur Instagram API mit Instagram Login besagt allerdings, dass diese Einrichtung nicht auf Anzeigen oder Markierungen zugreifen kann, ohne zu sagen, welche Markierungen gemeint sind. Bevor Sie einen dieser Parameter mit Instagram Login verwenden, veröffentlichen Sie einen Testbeitrag und prüfen Sie die Antwort sowie den Beitrag selbst.

Wie markiert man Personen über easyCoexistence?

Noch nicht möglich. publish_instagram_post erstellt den Container selbst und nimmt keine user_tags oder location_id entgegen, und Instagram-Tokens werden für einen eigenen Aufruf nicht herausgegeben. Veröffentlichen Sie den Beitrag mit publish_instagram_post und fügen Sie die Tags und den Ort danach in der Instagram-App hinzu, über die Option Bearbeiten des Beitrags.

Häufige Fehler

  • x und y bei einer Bild-Markierung weglassen. Meta verlangt sie bei Bildern; nur bei Stories sind sie optional.
  • Koordinaten in Pixeln oder Prozent angeben. x und y sind Fließkommazahlen von 0.0 bis 1.0, gemessen vom linken und oberen Rand.
  • location_id bei Karussell-Elementen setzen. Meta unterstützt sie nicht bei den Bildern oder Videos innerhalb eines Karussells.
  • Ein privates Konto markieren. user_tags nimmt die Benutzernamen öffentlicher Instagram-Konten entgegen.
Mit EasyCoexistence

Das Tool nimmt keine user_tags oder location_id entgegen, daher werden Personen und Orte in der Instagram-App markiert, über die Option Bearbeiten des Beitrags. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit einer kostenlosen Testphase von 3 Tagen.

Häufig gestellte Fragen

Kann ich über die API ein privates Instagram-Konto markieren?

Nein. Metas Medienreferenz besagt, dass user_tags die Benutzernamen öffentlicher Instagram-Konten entgegennimmt. Ein privates Konto lässt sich so nicht markieren.

Wie viele Personen lassen sich in einem Beitrag markieren?

Metas Referenz für user_tags nennt kein Maximum. Das Limit von 20, das sie angibt, gilt für @-Erwähnungen in einer Bildunterschrift.

Kann ich über die API einer Story einen Standort hinzufügen?

Nein. Metas Syntax für einen Story-Container führt user_tags auf, aber nicht location_id.

Kann ich statt einer Person ein Produkt markieren?

Produkt-Markierungen sind eine eigene Funktion. Meta führt sie in seiner Übersicht mit Facebook Login und Unified Login als unterstützt auf, nicht mit Instagram Login.

Weiterlesen

Verbinden Sie Ihren ersten Kanal in zwei Minuten.

Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.

  • 3 Tage kostenlos
  • Jederzeit kündbar
  • Nur offizielle APIs
  • Überwacht rund um die Uhr (24/7)

Verifiziert am