MasukMulai uji coba gratis
easyCoexistence API resmi

Menandai orang dan menambahkan lokasi ke postingan Instagram lewat API

API Instagram menandai orang dengan user_tags dan menambahkan tempat dengan location_id, keduanya diatur pada media container sebelum dipublikasikan. user_tags berisi username publik, dengan koordinat x dan y dari 0.0 sampai 1.0 yang wajib pada gambar; Meta menjelaskannya untuk gambar, video, dan Stories. location_id menerima ID dari sebuah Page yang memiliki data lokasi, yang ditemukan melalui Pages Search API.

easyCoexistence mempublikasikan foto, carousel, Reels, dan Stories dengan publish_instagram_post dari Claude, ChatGPT, atau kode Anda sendiri.

0.0 to 1.0

Rentang koordinat x dan y di user_tags, diukur dari tepi kiri dan atas gambar.

Images

Kapan user_tags mewajibkan x dan y; keduanya opsional pada Stories dan hanya berlaku untuk gambar dan Stories.

Carousels

location_id tidak didukung pada gambar atau video di dalam carousel, menurut referensi media Meta.

USER_TAGGING_FAILURE

Nilai config_issue ketika media terbit tanpa user tag-nya, yang oleh Meta disebut keberhasilan sebagian.

13 Mar 2018

Kapan Meta membuka penandaan lokasi dan akun Instagram publik pada foto yang dipublikasikan lewat API, pertama untuk mitra beta.

Bagaimana cara menandai orang dalam postingan?

Tambahkan user_tags ke container. Isinya berupa array objek, masing-masing dengan username akun Instagram publik dan, pada gambar, x dan y: float dari 0.0 sampai 1.0 yang menunjukkan jarak tanda dari tepi kiri dan atas. Lokasi dimasukkan ke location_id pada panggilan yang sama, lalu container dipublikasikan dengan media_publish seperti biasa.

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

Postingan mana yang menerima user tag dan lokasi?

Referensi media Meta menjelaskan user_tags untuk gambar, video, dan Stories, dengan x dan y hanya berlaku untuk gambar dan Stories, serta mencantumkan parameter yang diterima tiap container. Pada carousel, lokasi ditaruh di container carousel, karena location_id tidak didukung pada gambar atau video di dalamnya:

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

Bagaimana cara menemukan location_id?

Cari sebuah Page. location_id adalah ID Page yang terkait dengan lokasi, dan referensi Meta mengarah ke Pages Search API, GET /pages/search dengan q dan fields=id,name,location, lalu memeriksa apakah Page yang dipilih memiliki data lokasi. Page tanpa data itu gagal dengan INSTAGRAM_PLATFORM_API__INVALID_LOCATION_ID. Pencarian berjalan di Graph API Meta dengan token dari aplikasi Meta milik Anda sendiri: token pengguna, atau untuk informasi Page publik, token aplikasi dengan fitur 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>

Apa yang terjadi jika sebuah tanda tidak terpasang?

Postingan tetap bisa tayang. media_publish lalu mengembalikan config_issue dengan nilai USER_TAGGING_FAILURE, artinya media terbit tanpa user tag-nya. Meta menyebutnya keberhasilan sebagian dan meminta aplikasi memperlakukannya sebagai sinyal untuk menyelaraskan data, bukan sebagai kesalahan, karena media ID tetap valid; mempublikasikan ulang akan membuat postingan kedua.

Apakah user tag berfungsi dengan Instagram Login?

Referensi media Meta mencantumkan user_tags dan location_id untuk pembuatan container tanpa mengikatnya pada satu jenis login. Namun halaman Instagram API dengan Instagram Login menyebut bahwa pengaturan itu tidak dapat mengakses iklan atau penandaan, tanpa menjelaskan penandaan yang dimaksud. Sebelum membangun di atas salah satu parameter itu dengan Instagram Login, publikasikan postingan uji dan periksa responsnya serta postingannya sendiri.

Bagaimana cara menandai orang lewat easyCoexistence?

Belum bisa. publish_instagram_post membuat container sendiri dan tidak menerima user_tags atau location_id, dan token Instagram tidak diberikan untuk panggilan Anda sendiri. Publikasikan postingan dengan publish_instagram_post, lalu tambahkan tag dan lokasi di aplikasi Instagram, dari opsi Edit pada postingan.

Kesalahan umum

  • Tidak mengisi x dan y pada tanda gambar. Meta mewajibkannya pada gambar; hanya Stories yang membuatnya opsional.
  • Memberi koordinat dalam piksel atau persen. x dan y adalah float dari 0.0 sampai 1.0, diukur dari tepi kiri dan atas.
  • Mengatur location_id pada item carousel. Meta tidak mendukungnya pada gambar atau video di dalam carousel.
  • Menandai akun privat. user_tags hanya menerima username akun Instagram publik.
Melakukan ini dengan EasyCoexistence

Alat itu tidak menerima user_tags atau location_id, jadi orang dan tempat ditandai di aplikasi Instagram, dari opsi Edit pada postingan. US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring penambahan koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Bisakah saya menandai akun Instagram privat lewat API?

Tidak. Referensi media Meta menyebut user_tags hanya menerima username akun Instagram publik, jadi akun privat tidak bisa ditandai dengan cara ini.

Berapa banyak orang yang bisa ditandai dalam satu postingan?

Referensi user_tags dari Meta tidak mencantumkan batas maksimum. Batas 20 yang disebutkan berlaku untuk tag @ di dalam caption.

Bisakah saya menambahkan lokasi ke Story lewat API?

Tidak. Sintaks Meta untuk container Story mencantumkan user_tags tetapi tidak location_id.

Bisakah saya menandai produk, bukan orang?

Tag produk adalah fitur terpisah, yang menurut ikhtisar Meta didukung dengan Facebook Login dan Unified Login, bukan dengan Instagram Login.

Lanjut membaca

Hubungkan saluran pertama Anda dalam dua menit.

Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.

  • Gratis 3 hari
  • Batalkan kapan saja
  • Hanya API resmi
  • Dipantau 24/7

Diverifikasi pada