Menandai orang dan menambah lokasi pada siaran Instagram melalui API
API Instagram menandai orang dengan user_tags dan menambah lokasi dengan location_id, kedua-duanya ditetapkan pada media container sebelum siaran diterbitkan. user_tags menyenaraikan nama pengguna awam, dengan koordinat x dan y dari 0.0 hingga 1.0 diperlukan pada imej; Meta menerangkannya untuk imej, video dan Stories. location_id menerima ID Page yang mempunyai data lokasi, yang dicari melalui Pages Search API.
easyCoexistence menerbitkan foto, carousel, Reels dan Stories dengan publish_instagram_post daripada Claude, ChatGPT atau kod anda sendiri.
Julat koordinat x dan y dalam user_tags, diukur dari tepi kiri dan atas imej.
Tempat user_tags memerlukan x dan y; ia pilihan pada Stories dan hanya terpakai pada imej dan Stories.
location_id tidak disokong pada imej atau video di dalam carousel, menurut rujukan media Meta.
Nilai config_issue apabila media diterbitkan tanpa tag pengguna, yang Meta panggil kejayaan separa.
Ketika Meta membuka penandaan lokasi dan akaun Instagram awam pada foto yang diterbitkan melalui API, kepada rakan beta dahulu.
Bagaimana anda menandai orang dalam siaran?
Tambah user_tags pada container. Ia ialah tatasusunan objek, setiap satu dengan nama pengguna akaun Instagram awam dan, pada imej, x dan y: nombor titik terapung dari 0.0 hingga 1.0 yang memberi jarak tag dari tepi kiri dan atas. Lokasi dimasukkan dalam location_id dalam panggilan yang sama, dan container kemudian diterbitkan dengan media_publish seperti biasa.
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>"
}Siaran mana yang menerima tag pengguna dan lokasi?
Rujukan media Meta menerangkan user_tags untuk imej, video dan Stories, dengan x dan y terpakai hanya pada imej dan Stories, serta menyenaraikan parameter yang diterima oleh setiap container. Pada carousel, lokasi diletakkan pada container carousel, kerana location_id tidak disokong pada imej atau video di dalamnya:
Bagaimana mencari location_id?
Cari Page. location_id ialah ID Page yang dikaitkan dengan lokasi, dan rujukan Meta menunjuk kepada Pages Search API, GET /pages/search dengan q dan fields=id,name,location, kemudian semak sama ada Page yang dipilih mempunyai data lokasi. Page tanpa data itu gagal dengan INSTAGRAM_PLATFORM_API__INVALID_LOCATION_ID. Carian dijalankan pada Graph API Meta menggunakan token aplikasi Meta anda sendiri: token pengguna, atau bagi maklumat Page awam, token aplikasi dengan ciri Page Public Metadata Access.
GET /pages/search
?q=<PLACE_NAME>
&fields=id,name,location
&access_token=<ACCESS_TOKEN>Apa yang berlaku jika tag tidak berjaya dipasang?
Siaran masih boleh diterbitkan. media_publish kemudian memulangkan config_issue ditetapkan kepada USER_TAGGING_FAILURE, yang bermaksud media diterbitkan tanpa tag pengguna. Meta memanggil ini kejayaan separa dan meminta aplikasi melayannya sebagai isyarat untuk menyelaraskan semula, bukan ralat, kerana ID media itu sah; menerbitkan semula akan mencipta siaran kedua.
Adakah tag pengguna berfungsi dengan Instagram Login?
Rujukan media Meta menyenaraikan user_tags dan location_id untuk penciptaan container tanpa mengikatnya kepada satu log masuk. Halaman Meta untuk Instagram API dengan Instagram Login, bagaimanapun, menyatakan persediaan itu tidak boleh mengakses iklan atau penandaan, tanpa menyatakan penandaan yang dimaksudkan. Sebelum membina atas mana-mana parameter ini dengan Instagram Login, terbitkan siaran ujian dan semak respons serta siaran itu sendiri.
Bagaimana menandai orang melalui easyCoexistence?
Anda belum boleh. publish_instagram_post mencipta container sendiri dan tidak menerima user_tags atau location_id, dan token Instagram tidak diserahkan untuk panggilan anda sendiri. Terbitkan siaran dengan publish_instagram_post, kemudian tambah tag dan lokasi dalam aplikasi Instagram, daripada pilihan Edit pada siaran itu.
Kesilapan biasa
- Tidak memasukkan x dan y pada tag imej. Meta memerlukannya pada imej; hanya Stories menjadikannya pilihan.
- Memberi koordinat dalam piksel atau peratus. x dan y ialah nombor titik terapung dari 0.0 hingga 1.0, diukur dari tepi kiri dan atas.
- Menetapkan location_id pada item carousel. Meta tidak menyokongnya pada imej atau video di dalam carousel.
- Menandai akaun peribadi. user_tags menerima nama pengguna akaun Instagram awam sahaja.
Alat itu tidak menerima user_tags atau location_id, jadi orang dan tempat ditanda dalam aplikasi Instagram, daripada pilihan Edit pada siaran itu. US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari pertama percuma.
Soalan lazim
Bolehkah saya menandai akaun Instagram peribadi melalui API?
Tidak. Rujukan media Meta menyatakan user_tags menerima nama pengguna akaun Instagram awam, jadi akaun peribadi tidak boleh ditandai dengan cara ini.
Berapa ramai orang boleh ditandai dalam satu siaran?
Rujukan Meta untuk user_tags tidak memberi had maksimum. Had 20 yang dinyatakan adalah untuk tag @ dalam kapsyen.
Bolehkah saya menambah lokasi pada Stories melalui API?
Tidak. Sintaks Meta untuk container Story menyenaraikan user_tags tetapi tidak location_id.
Bolehkah saya menandai produk dan bukannya orang?
Tag produk ialah ciri berasingan, yang menurut gambaran keseluruhan Meta disokong dengan Facebook Login dan Unified Login, bukan dengan Instagram Login.
Teruskan membaca
Sambungkan saluran pertama anda dalam masa dua minit.
Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.
- 3 hari percuma
- Batal bila-bila masa
- API rasmi sahaja
- Dipantau 24/7
Disahkan pada