Ihmisten merkitseminen ja sijainnin lisääminen Instagram-julkaisuun API:n kautta
Instagramin API merkitsee ihmisiä user_tags-kentällä ja lisää paikan location_id-kentällä. Molemmat asetetaan mediakonttiin ennen sen julkaisemista. user_tags sisältää julkisten käyttäjätunnusten listan, ja kuvissa vaaditaan x- ja y-koordinaatit välillä 0.0–1.0. Meta kuvaa kentän kuville, videoille ja Stories-julkaisuille. location_id ottaa sellaisen Page-sivun tunnuksen, jolla on sijaintitietoja, ja tunnus löytyy Pages Search API:n kautta.
easyCoexistence julkaisee valokuvia, karuselleja, Reelsejä ja Stories-julkaisuja publish_instagram_post-työkalulla Claudesta, ChatGPT:stä tai omasta koodistasi.
x- ja y-koordinaattien alue user_tags-kentässä, mitattuna kuvan vasemmasta ja yläreunasta.
Missä user_tags vaatii x- ja y-arvot: Stories-julkaisuissa ne ovat valinnaisia, ja kenttä koskee vain kuvia ja Stories-julkaisuja.
location_id ei ole tuettu karusellin kuvissa tai videoissa, kertoo Metan media-viite.
config_issue-arvo, kun media julkaistaan ilman käyttäjämerkintöjään, jota Meta kutsuu osittaiseksi onnistumiseksi.
Milloin Meta avasi paikkojen ja julkisten Instagram-käyttäjien merkitsemisen API:n kautta julkaistuihin valokuviin, aluksi beta-kumppaneille.
Miten merkitset ihmisiä julkaisussa?
Lisää user_tags mediakonttiin. Se on taulukko objekteja, joista kukin sisältää julkisen Instagram-tilin käyttäjätunnuksen ja kuvassa x- ja y-arvon: liukulukuja 0.0–1.0, jotka kertovat merkinnän etäisyyden vasemmasta ja yläreunasta. Sijainti menee location_id-kenttään samaan kutsuun, ja mediakontti julkaistaan sen jälkeen media_publish-kutsulla normaalisti.
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>"
}Mihin julkaisuihin käyttäjämerkinnät ja sijainti sopivat?
Metan media-viite kuvaa user_tags-kentän kuville, videoille ja Stories-julkaisuille. x- ja y-arvot koskevat vain kuvia ja Stories-julkaisuja, ja viite listaa parametrit, joita kukin mediakontti ottaa. Karusellissa sijainti asetetaan karusellikonttiin, koska location_id ei ole tuettu karuselliin kuuluvissa kuvissa tai videoissa:
Miten location_id löydetään?
Etsi Page. location_id on sijaintitietoja sisältävän Page-sivun tunnus, ja Metan viite neuvoo käyttämään Pages Search API:a eli GET /pages/search -kutsua kentillä q ja fields=id,name,location. Sen jälkeen tarkistetaan, että valitulla Page-sivulla on sijaintitietoja. Ilman niitä Page epäonnistuu virheellä INSTAGRAM_PLATFORM_API__INVALID_LOCATION_ID. Haku käyttää Metan Graph API:a omalla Meta-sovelluksellasi luodulla tokenilla: käyttäjätokenilla tai julkisten Page-tietojen osalta sovellustokenilla, jolla on Page Public Metadata Access -ominaisuus.
GET /pages/search
?q=<PLACE_NAME>
&fields=id,name,location
&access_token=<ACCESS_TOKEN>Mitä tapahtuu, jos merkintä ei kiinnity?
Julkaisu voi silti mennä julkiseksi. media_publish palauttaa silloin config_issue-arvon USER_TAGGING_FAILURE, mikä tarkoittaa, että media julkaistiin ilman käyttäjämerkintöjään. Meta kutsuu tätä osittaiseksi onnistumiseksi ja pyytää sovelluksia käsittelemään sen täsmäyttämisen signaalina eikä virheenä, koska media-tunnus on kelvollinen. Uudelleen julkaiseminen loisi toisen julkaisun.
Toimivatko käyttäjämerkinnät Instagram Loginin kanssa?
Metan media-viite listaa user_tags- ja location_id-kentät mediakontin luomiseen sitomatta niitä yhteen kirjautumistapaan. Metan Instagram Login -sivu kuitenkin sanoo, ettei kyseinen asetus pääse käsiksi mainoksiin eikä merkintöihin, mainitsematta, mitä merkinnöillä tarkoitetaan. Ennen kuin rakennat jompaakumpaa parametria Instagram Loginin varaan, julkaise testijulkaisu ja tarkista vastaus sekä itse julkaisu.
Miten merkitset ihmisiä easyCoexistencen kautta?
Ei vielä. publish_instagram_post luo mediakontin itse eikä ota user_tags- eikä location_id-kenttiä, eikä Instagram-tokeneita luovuteta omaa kutsuasi varten. Julkaise julkaisu publish_instagram_post-työkalulla ja lisää sitten merkinnät ja sijainti Instagram-sovelluksessa julkaisun Muokkaa-valinnasta.
Yleiset virheet
- x- tai y-arvon jättäminen pois kuvamerkinnästä. Meta vaatii ne kuville; vain Stories-julkaisuissa ne ovat valinnaisia.
- Koordinaattien antaminen pikseleinä tai prosentteina. x ja y ovat liukulukuja 0.0–1.0, mitattuna vasemmasta ja yläreunasta.
- location_id-kentän asettaminen karusellin kohteisiin. Meta ei tue sitä karusellin kuvissa tai videoissa.
- Yksityisen tilin merkitseminen. user_tags ottaa julkisten Instagram-tilien käyttäjätunnukset.
Työkalu ei ota user_tags- eikä location_id-kenttiä, joten henkilöt ja paikat merkitään Instagram-sovelluksessa julkaisun Muokkaa-valinnasta. US$ 9:stä US$ 0.75:een yhteydeltä kuukaudessa, laskien yhteyksien määrän kasvaessa, ja ensimmäiset 3 päivää ovat ilmaista kokeilua.
Usein kysytyt kysymykset
Voiko yksityisen Instagram-tilin merkitä API:n kautta?
Ei. Metan media-viite sanoo, että user_tags ottaa julkisten Instagram-tilien käyttäjätunnukset, joten yksityistä tiliä ei voi merkitä näin.
Kuinka monta henkilöä voi merkitä yhteen julkaisuun?
Metan user_tags-viite ei anna enimmäismäärää. Sen mainitsema raja 20 koskee @-merkintöjä kuvatekstissä.
Voinko lisätä sijainnin Stories-julkaisuun API:n kautta?
Ei. Metan Stories-mediakontin syntaksi listaa user_tags-kentän, mutta ei location_id-kenttää.
Voinko merkitä tuotteen henkilön sijasta?
Tuotemerkinnät ovat erillinen ominaisuus, jonka Metan yleiskatsaus listaa tuettuna Facebook Loginilla ja Unified Loginilla, ei Instagram Loginilla.
Lue lisää
Yhdistä ensimmäinen kanavasi kahdessa minuutissa.
Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.
- 3 päivää ilmaiseksi
- Peruuta milloin tahansa
- Vain viralliset API:t
- Valvottu 24/7
Vahvistettu