Giriş yapınÜcretsiz denemeyi başlatın
easyCoexistence Resmi API'ler

Instagram API ile kişileri etiketleme ve gönderiye konum ekleme

Instagram API'si, yayımlanmadan önce medya konteynerinde ayarlanan user_tags ile kişileri etiketler ve location_id ile bir yer ekler. user_tags, herkese açık kullanıcı adlarını listeler; görsellerde x ve y koordinatları (0.0 ile 1.0 arası) zorunludur. Meta bunu görseller, videolar ve hikayeler için tanımlar. location_id, konum verisi olan bir Sayfanın kimliğini alır; bu kimlik Pages Search API ile bulunur.

easyCoexistence, fotoğrafları, karuselleri, Reels'i ve hikayeleri Claude, ChatGPT ya da kendi kodunuzdan publish_instagram_post ile yayımlar.

0.0 to 1.0

user_tags içindeki x ve y koordinatlarının aralığı; değerler görselin sol ve üst kenarlarından ölçülür.

Images

user_tags'ın x ve y'yi zorunlu kıldığı yerler; hikayelerde isteğe bağlıdırlar ve yalnızca görsellerde ile hikayelerde geçerlidirler.

Carousels

location_id, Meta'nın medya referansına göre karusel içindeki görsellerde ya da videolarda desteklenmez.

USER_TAGGING_FAILURE

Medya etiketleri olmadan yayımlandığında görülen config_issue değeri; Meta bunu kısmi başarı olarak adlandırır.

13 Mar 2018

Meta'nın API ile yayımlanan fotoğraflarda konum ve herkese açık Instagram kullanıcısı etiketlemesini önce beta ortaklarına açtığı zaman.

Gönderide kişileri nasıl etiketlersiniz?

Konteynere user_tags ekleyin. Bu, herkese açık bir Instagram hesabının kullanıcı adını ve görselde x ile y değerlerini içeren nesnelerden oluşan bir dizidir; x ve y, etiketin sol ve üst kenara uzaklığını 0.0 ile 1.0 arasında veren ondalıklı sayılardır. Konum aynı çağrıda location_id'ye yazılır; ardından konteyner her zamanki gibi media_publish ile yayımlanır.

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

Hangi gönderiler kullanıcı etiketi ve konum alır?

Meta'nın medya referansı, user_tags'ı görseller, videolar ve hikayeler için tanımlar; x ve y yalnızca görsellerde ve hikayelerde geçerlidir ve her konteynerin hangi parametreleri aldığını listeler. Karuselde konum karusel konteynerine eklenir, çünkü location_id içindeki görsellerde ya da videolarda desteklenmez:

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

location_id'yi nasıl bulursunuz?

Bir Sayfa arayın. location_id, bir konumla ilişkili Sayfanın kimliğidir; Meta'nın referansı Pages Search API'ye, yani q ve fields=id,name,location içeren GET /pages/search çağrısına işaret eder, ardından seçilen Sayfada konum verisi olup olmadığını kontrol etmenizi önerir. Konum verisi olmayan bir Sayfa INSTAGRAM_PLATFORM_API__INVALID_LOCATION_ID hatasıyla başarısız olur. Arama, Meta'nın Graph API'sinde kendi Meta uygulamanızın token'ıyla çalışır: kullanıcı token'ı, ya da herkese açık Sayfa bilgisi için Page Public Metadata Access özelliğine sahip bir uygulama token'ı.

Searching for a Page with a location
GET /pages/search
  ?q=<PLACE_NAME>
  &fields=id,name,location
  &access_token=<ACCESS_TOKEN>

Bir etiket eklenemezse ne olur?

Gönderi yine de yayımlanabilir. media_publish, medyanın kullanıcı etiketleri olmadan yayımlandığı anlamına gelen USER_TAGGING_FAILURE değerine ayarlı config_issue döndürür. Meta bunu kısmi başarı olarak adlandırır ve uygulamalardan bunu bir hata yerine uzlaştırma sinyali olarak ele almalarını ister, çünkü medya kimliği geçerlidir; yeniden yayımlamak ikinci bir gönderi oluşturur.

Kullanıcı etiketleri Instagram Login ile çalışır mı?

Meta'nın medya referansı user_tags ve location_id'yi konteyner oluşturma için listeler, ancak bunları tek bir girişe bağlamaz. Ancak Instagram Login ile Instagram API sayfası, bu kurulumun reklamlara ya da etiketlemeye erişemediğini söyler; hangi etiketlemeyi kastettiğini belirtmez. Instagram Login ile bu parametrelerden birine dayanmadan önce bir test gönderisi yayımlayın ve yanıtı ve gönderinin kendisini kontrol edin.

easyCoexistence üzerinden kişileri nasıl etiketlersiniz?

Henüz yapamazsınız. publish_instagram_post konteyneri kendisi oluşturur ve user_tags ya da location_id kabul etmez; ayrıca Instagram token'ları kendi çağrınız için verilmez. Gönderiyi publish_instagram_post ile yayımlayın, ardından etiketleri ve konumu Instagram uygulamasında, gönderinin Düzenle seçeneğinden ekleyin.

Yaygın hatalar

  • x ve y'yi görsel etiketinden çıkarmak. Meta bunları görsellerde zorunlu kılar; yalnızca hikayelerde isteğe bağlıdırlar.
  • Koordinatları piksel ya da yüzde olarak vermek. x ve y, sol ve üst kenarlardan ölçülen 0.0 ile 1.0 arasında ondalıklı sayılardır.
  • Karusel öğelerine location_id koymak. Meta, karusel içindeki görsellerde ya da videolarda bunu desteklemez.
  • Özel bir hesabı etiketlemek. user_tags, herkese açık Instagram hesaplarının kullanıcı adlarını alır.
Bunu EasyCoexistence'la yapmak

Araç user_tags ya da location_id kabul etmez, bu yüzden kişiler ve yerler Instagram uygulamasında, gönderinin Düzenle seçeneğinden etiketlenir. Bağlantı başına aylık US$ 9 ile US$ 0.75 arasında, bağlantı ekledikçe düşer; ilk 3 gün ücretsizdir.

Sık sorulan sorular

Instagram API ile özel bir Instagram hesabını etiketleyebilir miyim?

Hayır. Meta'nın medya referansına göre user_tags, herkese açık Instagram hesaplarının kullanıcı adlarını alır; bu yüzden özel bir hesap bu yolla etiketlenemez.

Bir gönderide en fazla kaç kişi etiketlenebilir?

Meta'nın user_tags referansı bir üst sınır vermez. Belirttiği 20 sınırı, açıklamadaki @ etiketleri içindir.

API ile bir hikayeye konum ekleyebilir miyim?

Hayır. Meta'nın hikaye konteyneri sözdizimi user_tags'ı listeler, ancak location_id'yi listelemez.

Bir kişi yerine ürün etiketleyebilir miyim?

Ürün etiketleri ayrı bir özelliktir; Meta'nın genel bakışı bunları Facebook Login ve Unified Login ile desteklenen, Instagram Login ile desteklenmeyen özellikler olarak listeler.

Okumaya devam edin

İlk kanalınızı iki dakikada bağlayın.

Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.

  • 3 gün ücretsiz
  • İstediğiniz zaman iptal
  • Yalnızca resmi API'ler
  • 7/24 izleniyor

Doğrulama tarihi