Instagram API’sine Giriş

Instagram API'sine Giriş

2012’de Facebook tarafından yüksek profilli satın alınmasının ardından Instagram, üçüncü taraf kullanımı için iki set API’yi benimsedi. Bunlar Instagram Grafik API’si ve Instagram Temel Görüntü API’sı.

Bir kullanıcının yetkili Instagram hesabından bilgi gerektiren bir uygulama oluşturan bir geliştirici olarak, iki API seçiminiz, kullanıcıyla ilgili istediğiniz bilgilerin kapsamına bağlıdır.

Kullanıcı veya hesaplarında bir medya koleksiyonu (fotoğraflar, videolar ve albümler) hakkında yalnızca temel profil bilgilerini istiyorsanız, Temel Görüntüleme API’si yeterli olacaktır.

Ancak, Instagram İşletmeleri ve İçerik Oluşturucu hesapları hakkında daha karmaşık sosyal medya etkileşimleri verileri, ölçümleri ve içgörüler elde etmek istiyorsanız, Instagram Graph API’sine ihtiyacınız olacaktır.

Bu öğreticide, size her iki API kümesiyle neler yapabileceğinize ve nasıl başlayacağınıza dair geniş bir genel bakış sunacağım.

Sen başlamadan önce

Instagram API’sini kullanmak için önce bir OAuth uygulaması oluşturmanız ve yapılandırmanız gerekir. Uygulama Facebook geliştirici hesabınızdaki kontrol paneli. Bu işlem, API’ye yapılan her istekte kullanacağınız bir API erişim belirteci almanızla sonuçlanmalıdır.

Lütfen bir şeyleri ayarlamak için iki farklı kılavuz olduğunu unutmayın:

  • Uygulamanızla Instagram Graph API’sini çağırmak için izin istiyorsanız, şunu takip edin: bu kılavuz.
  • Bir Instagram hesabındaki (diğer adıyla Instagram Temel Görüntüleme API’si) temel profil bilgilerini okumak için izin istiyorsanız, aşağıdaki adımları izleyin: bu kılavuz yerine.

Ayrıca, belirli API’leri kullanma becerinizin, Uygulama panosunda her belirteç için ayarladığınız izinlere bağlı olabileceğini de unutmamalısınız. Bu nedenle, hangi görev için hangi iznin gerekli olduğunu görmek için öncelikle bu makaleyi okumanızı öneririm.

Uygulamanızdan erişim belirtecini kullanarak, seçtiğiniz herhangi bir HTTP istemcisiyle API’yi sorgulayabilirsiniz.

Temel Görüntülü Reklam API’sı

Instagram Basic Display API ile, uygulamanızın kullanıcılarına Instagram hesaplarında temel profil bilgilerini, fotoğrafları ve videoları alma izni vermelerini söyleyebilirsiniz. API, Business ve İçerik Oluşturucu olmayan Instagram kullanıcıları için oluşturuldu.

Kullanıcı Uç Noktası

bu Kullanıcı uç noktası Kullanıcı Kimliğine göre bir Instagram kullanıcısı hakkında temel bilgileri aramanıza olanak tanır. Bu API’yi kullanmak için isteğiniz bir Instagram Kullanıcı Erişim Simgesi içermelidir ve Instagram OAuth uygulamanızda aşağıdaki izinler etkinleştirilmelidir:

  • instagram_graph_user_profile
  • instagram_graph_user_media (bu, yalnızca kullanıcının media_count yanıt nesnesine dahil edilir)

Bu uç nokta için istek sözdizimi aşağıdaki gibidir.

  • api-version (isteğe bağlı): API sürümü, ör. v14.0 (sürümler hakkında daha fazla bilgi için belgeler). Değer bir dize olmalıdır.
  • user-id (gerekli): Hakkında bilgi almak istediğiniz kullanıcının kimliği. Değer bir dize olmalıdır.
  • fields (isteğe bağlı): API tarafından döndürülmesini istediğiniz alanların ve kenarların virgülle ayrılmış listesi. Atlanırsa, varsayılan alanlar döndürülür.
  • access_token (gerekli): API erişim belirteciniz. Değer bir dize olmalıdır.

Bu uç nokta için desteklenen alanların account_type, id, media_countve username. Aşağıdaki resim, bu alanların her birinin ne döndürdüğünü açıklar.

User_fields_imagesUser_fields_images
Kullanıcı alanları

Örneğin, işte örnek bir cURL isteği:

Ve işte örnek yanıt:

Ben Uç Noktası

bu ben uç nokta belirteci veren Instagram kullanıcısının doğrudan kendi hesabına erişmesine izin verdiği için bir kısayol bitiş noktasıdır. API bunu, önce belirteci veren Instagram kullanıcısının kimliğini belirlemek için istekte bulunan Instagram Kullanıcı Erişim Simgesini inceleyerek, ardından Kullanıcı uç noktasını sorgulamak için kimliği kullanarak yapar.

İşte istek sözdizimi:

Kullanıcı uç noktasıyla aynı alanları destekler:

User_fields_imageUser_fields_imageUser_fields_image
Kullanıcı alanları

Kaputun altında, /me eşlenir /{user-id}ve erişim belirteci tarafından tanımlanan Kullanıcı Kimliği sorguyu tamamlamak için kullanılacaktır.

Özetle, bu uç nokta, Kullanıcı uç noktası ile aynı kapsamları gerektirir, aynı alanları destekler ve API’den gelen yanıtla benzer bir nesne döndürür.

Medya Uç Noktası

İle Medya uç noktasıbir Instagram fotoğrafı, videosu veya albümü hakkında Medya Kimliğine göre bilgi alabilirsiniz.

İşte istek sözdizimi:

Bu uç nokta için desteklenen alanlar şunlardır: caption, id, media_type, media_url, username, timestamp, permalinkve thumbnail_url. Aşağıdaki resim, bu alanların her birinin ne döndürdüğünü açıklar.

Medya alanlarıMedya alanlarıMedya alanları
Medya alanları

Bu bitiş noktasının yalnızca aşağıdakileri gerektirdiğini unutmayın: instagram_graph_user_media izin verir ve Medya Kimliğine göre tek bir nesne döndürür.

Örneğin, işte örnek bir cURL isteği:

Ve işte örnek bir yanıt:

Kenar Uç Noktaları

Kenarlar, bir Instagram kullanıcısı veya medyası hakkında ek bilgi almanızı sağlar. Yol parametresi olarak veya aşağıdakileri kullanarak bir kenar talep edebilirsiniz. fields sorgu dizesi parametresi.

Bir yol parametresi kullanmanın sözdizimi şöyledir:

Hem Kullanıcı hem de Medya uç noktaları birer kenarı destekler.

Kullanıcı Medya Kenarı

Temel profil bilgilerine ek olarak, bir kullanıcıyla ilgili medya koleksiyonunu şu adres aracılığıyla da alabilirsiniz: Kullanıcı Ortamı uç noktası. Ancak, aklınızda bulundurmanız gereken birkaç sınırlama vardır:

  • Uç nokta hikayeleri desteklemiyor.
  • Ayrıca, tanıtılan gönderilerde kullanılan medyayı da desteklemez.
  • API, en son oluşturulan medyanın maksimum 10K’sını döndürür.

Bu uç nokta için genel sözdizimi aşağıdaki gibidir.

Buna ek olarak fields ve access_tokenbu uç nokta aşağıdaki sorgu dizesi parametrelerini kabul eder:

Sorgu dizesi parametreleriSorgu dizesi parametreleriSorgu dizesi parametreleri
Sorgu dizesi parametreleri

Bu bilgi kümesiyle, uygulamanızda belirli bir zaman diliminde yayınlanan medyayı bulmak için gereken her şeye sahip olursunuz.

Bu uç nokta için desteklenen alanlar şunlardır: caption, id, media_type, media_url, username, timestamp, permalinkve thumbnail_url. Aşağıdaki resim, bu alanların her birinin ne döndürdüğünü açıklar.

Medya alanlarıMedya alanlarıMedya alanları
Medya alanları

İşte örnek bir cURL isteği:

Ve işte örnek yanıt:

Medya Çocukları Kenarı

bu Medya Çocukları uç nokta bir albümdeki görüntü ve video medya koleksiyonunu almanıza olanak tanır.

İşte istek sözdizimi:

Medya Kimliği, alt öğelerini almak istediğiniz albümü temsil eder. Bu uç nokta, Medya uç noktasıyla aynı OAuth kapsamını ve aynı alanları kullanır. Alanlar aşağıdaki resimde açıklanmıştır.

Medya alanlarıMedya alanlarıMedya alanları
Medya alanları

İşte örnek bir cURL isteği:

Ve işte bir yanıt örneği:

Instagram Grafik API’si

Instagram Graph API ile, uygulamanızın kullanıcılarına Instagram Business ve Creator hesaplarındaki verilere erişmenize izin vermelerini söyleyebilirsiniz. Bu, medyalarını alma ve yayınlama, medyalarındaki yorumları yönetme ve yanıtlama, diğer Instagram kullanıcıları tarafından @-bahsedildiği medyayı belirleme, etiketlenmiş medyayı bulma ve temel meta veri ve metrikleri alma iznini içerir.

IG Kullanıcısı

bu IG Kullanıcı uç noktası Bir Instagram İşletme Hesabı veya Instagram Oluşturucu Hesabı kullanıcısı hakkında ayrıntılı bilgi aramanıza olanak tanır.

IG Kullanıcı API’sini kullanmak için, isteğe bir Instagram Kullanıcı Erişim Simgesi eklemeniz ve Instagram OAuth Uygulamanızda aşağıdaki OAuth kapsamlarını etkinleştirmeniz gerekir:

  • instagram_basic
  • page_read_engagement
  • page_show_list
  • ads_management veya business_management (Uygulama kullanıcısına Business Manager aracılığıyla Sayfada bir rol verildiyse)
  • katalog_yönetim (eğer talep etmeyi düşünüyorsanız shopping_product_tag_eligibility ürün etiketleme alanı)
  • instagram_shopping_tag_products (yukarıdakiyle aynı)

API ayrıca, hakkında bilgi almayı düşündüğünüz uygulama kullanıcısı için aşağıdakileri de gerektirir (Not: Bu, yalnızca shopping_product_tag_eligibility alan):

  • IG Kullanıcısının Instagram Mağazasının sahibi olan İşletme yöneticisinde yönetici rolü
  • ürünleri içeren bir ürün kataloğuna sahip onaylı bir Instagram Mağazası
GereksinimlerGereksinimlerGereksinimler
Gereksinimler

Bunun için genel sözdizimi aşağıdaki gibidir.

  • api-version (isteğe bağlı): API sürümü, ör. v14. Değer bir dize olmalıdır.
  • user-id (gerekli): Hakkında bilgi almak istediğiniz kullanıcının IG Kullanıcı Kimliği. Değer bir dize olmalıdır.
  • fields (isteğe bağlı): API tarafından döndürülmesini istediğiniz alanların ve kenarların virgülle ayrılmış listesi. Atlanırsa, varsayılan alanlar döndürülür.
  • access_token (gerekli): API erişim belirteciniz. Değer bir dize olmalıdır.

Bu uç nokta için desteklenen alanlar şunlardır: biography, id, followers_count, ig_id, follows_count, media_count, name, profile_picture_url, shopping_product_tag_eligibility, usernameve website. Aşağıdaki resim, bu alanların her birinin ne döndürdüğünü açıklar.

IG Kullanıcı alanlarıIG Kullanıcı alanlarıIG Kullanıcı alanları
IG Kullanıcı alanları

Örneğin, dokümanlardan gelen örnek bir cURL isteği:

Ve işte örnek yanıt:

Ayrıca, IG Kullanıcı uç noktası, uygulamanın İşletme veya Oluşturucu hesabı hakkında ek bilgi almasına olanak tanıyan çeşitli kenarları destekler. Bu kenarlar aşağıdaki resimde açıklanmıştır.

IG Kullanıcı KenarlarıIG Kullanıcı KenarlarıIG Kullanıcı Kenarları

Bu verilerden herhangi birini almak için, ilgili Edge’i IG Kullanıcısı uç noktasına ek bir yol parametresi olarak eklemeniz yeterlidir. Örneğin, aşağıdaki uç nokta, bir IG Kullanıcısında bir medya koleksiyonu alır:

Instagram Graph API’deki Diğer Uç Noktalar

Business ve Creator hesaplarıyla çalışmak için kalan API’ler şunlardır:

  • IG Medya: Bu, Instagram medya kimliğine göre bir Instagram fotoğrafı, videosu veya albümü hakkında bilgi almanızı sağlar.
  • IG Hashtag’i: Bu, belirli bir Instagram hashtag’i hakkında bilgi almanızı sağlar.
  • IG Hashtag Arama: Bu kök kenar, Instagram hashtag kimlikleri almanızı sağlar.
  • IG Konteyner: Bu, bir ortam kapsayıcısının yayınlama durumu hakkında bilgi almanızı sağlar. Bir Instagram gönderisini yayınlamak için bir medya kapsayıcısı kullanılır.
  • IG Yorumları: Bu, bir medyadaki yorumları Instagram yorum kimliğine göre almanızı sağlar. API’den döndürülen bilgiler, yoruma verilen yanıtları, beğeni sayısını ve yorum metnini içerir.

Bu API uç noktalarının her birinin Instagram uygulamanızda farklı OAuth kapsam izinleri gerektirebileceğini, farklı alan ve kenar kombinasyonlarını destekleyebileceğini veya kullanımına belirli sınırlamalar getirebileceğini unutmayın. Bu nedenle, mutlaka okuyun eksiksiz belgeler açıklık için.

Instagram API Hangi Platformları Destekliyor?

Instagram API’sine REST uç noktalarını kullanarak herhangi bir platform veya programlama dili ile erişebilirsiniz.

Çoğu programlama dili, API istekleri yapmak için yerleşik bir HTTP İstemci API’si veya bir üçüncü taraf kitaplığı ile birlikte gelir. Örnekler aksiyolar (Düğüm.js), Ağ::HTTP (Yakut), istekler (Python) ve fısıltıhttp/guzzle (PHP).

Sıradaki ne?

Umarım Instagram API’sini kullanmaya başlamak ilginizi çeker. Başlamak için bir Facebook geliştirici hesabı oluşturmanız yeterlidir; Başlarken kılavuzu API jetonunuzu nasıl alacağınıza ilişkin talimatlar için ve API’yi sorgulamaya başlayın!

Bir cevap yazın

E-posta hesabınız yayımlanmayacak.