Bu sayfa, Cloud Translation API ile çevrilmiştir.

Blogger JSON API: Başlarken

Önemli: JSON API 2.0 sürümüne yönelik desteği 30 Eylül 2024'te sonlandıracağız. İşlevselliğin etkinlenmemesi için JSON API'nin 2.0 sürümünü kullanan uygulamalarınızı en son API sürümüne güncelleyin. En son sürüm için sol taraftaki gezinme çubuğundaki bağlantıları kullanın.

Bu dokümanda, Blogger JSON API'yi kullanmaya nasıl başlayacağınız açıklanmaktadır.

İçindekiler

Giriş
Başlamadan önce
Blogger JSON API arka planı
Arama stili
1. REST
Veri biçimi
1. JSON

Giriş

Bu doküman, Blogger JSON API ile etkileşim kurabilen uygulamalar yazmak isteyen geliştiriciler için hazırlanmıştır.

Blogger JSON API, Blogger Veri API'sinin 2.0 sürümünü genişletir. Blogger'dan verileri XML yerine JSON biçiminde almak istiyorsanız Blogger JSON API'yi kullanın. Verileri XML biçiminde almak istiyorsanız Blogger Data API'yi kullanın.

Blogger JSON API'nin bu sürümü şu anda salt okuma modundadır. Ancak diğer özelliklerin yanı sıra okuma/yazma özelliklerini de eklemeyi planlıyoruz. Blogger Yardım Forumu'nda diğer özellikleri talep edebilirsiniz.

Başlamadan önce

Bir Google Hesabı edinin

Google Hesabınızı oluşturduğunuzdan emin olun. Geliştirme ve test amacıyla ayrı bir Google Hesabı kullanarak kendinizi yanlışlıkla veri kaybından korumanızı öneririz. Zaten bir test hesabınız varsa hazırsınız demektir. Test verilerinizi oluşturmak, düzenlemek veya görüntülemek için Blogger kullanıcı arayüzünü ziyaret edebilirsiniz.

Blogger'ı öğrenin

Blogger kavramlarına aşina değilseniz kodlamaya başlamadan önce bu dokümanı okuyun ve kullanıcı arayüzünü deneyin. Bu dokümanda Blogger, web programlama kavramları ve web veri biçimleri hakkında bilgi sahibi olduğunuz varsayılmaktadır.

İstekleri yetkilendirme ve uygulamanızı tanımlama hakkında bilgi edinin

Uygulamanız gizli veri isteğinde bulunduğunda isteğin, söz konusu verilere erişimi olan kimliği doğrulanmış bir kullanıcı tarafından yetkilendirilmesi gerekir.

Uygulamanız herkese açık veri isteğinde bulunduğunda isteğin yetkilendirilmesi gerekmez ancak API anahtarı gibi bir tanımlayıcıyla birlikte gönderilmesi gerekir.

İstekleri yetkilendirme ve API anahtarlarını kullanma hakkında bilgi edinmek için API'yi Kullanma belgesindeki İstekleri yetkilendirme ve uygulamanızı tanımlama bölümüne bakın.

Blogger JSON API arka planı

Blogger kavramları

Blogger'ın temelinde beş temel kavram vardır:

Bloglar: API'nin temel kavramı. Bloglarda yayın ve sayfa bulunur. Blog adı ve açıklaması gibi blog meta bilgilerinin bulunduğu kapsayıcıdır.
Yayınlar: Blog yayını, blog yazarının oluşturduğu ve yayınlanabilir olan öğedir. Bu bilgiler, yazarların şu anda dünyayla paylaşmak istedikleri bilgileri yansıtacak şekilde günceldir. Zaman geçtikçe blog yayını içeriğinin güncelliğini yitirdiği ve daha az alakalı hale geldiği anlaşılıyor.
Yorumlar: Yorumlar, blog yayınının yazarı dışındaki kullanıcıların yazarın yazdığı içeriklere tepki verdiği yerdir. Tuğlalardan buketlere kadar her şey.
Sayfalar: Sayfalar, biyografik bilgiler veya kullanıcıyla iletişime geçme yöntemleri gibi statik içeriklerin yer aldığı yerlerdir. Bu bilgiler genellikle zamana bağlı olmayan ve çok sık değişmeyen bilgilerdir.
Kullanıcılar: Yazar, yönetici veya okuyucu olarak Blogger ile etkileşime geçen herkes kullanıcıdır. Herkesin erişimine açık bloglarda okuyucular anonim olabilir ancak özel bloglarda okuyucuların Blogger tarafından tanımlanması gerekir.

Blogger JSON API veri modeli

Kaynak, benzersiz bir tanımlayıcıya sahip tek bir veri öğesidir. Blogger JSON API beş tür kaynakla çalışır:

Bloglar Kaynağı: Bir blogu temsil eder.
Yayın Kaynağı: Bir yayını temsil eder. Her Yayın Kaynağı, bir Blog Kaynağı'nın alt öğesidir.
Yorumlar Kaynağı: Belirli bir yayındaki yorumu temsil eder. Her yorum kaynağı, bir Yayınlar kaynağının alt öğesidir.
Sayfalar Kaynağı: Statik bir sayfayı temsil eder. Her Sayfalar Kaynağı, bir Bloglar Kaynağı'nın alt öğesidir.
Kullanıcılar kaynağı: Anonim olmayan bir kullanıcıyı temsil eder. Bu kimlik, bir sayfanın, yayının veya yorumun yazarını tanımlamak için kullanılır.

Bloglar kaynağının iki alt kaynak türü vardır: Sayfalar ve Yayınlar.
Yayınlar kaynağının alt kaynakları Yorumlar kaynağı olabilir. — Kaynaklar arasındaki ilişkilere genel bakış

Blogger JSON API veri modeli, koleksiyon adı verilen kaynak gruplarına dayanır:

Blog Koleksiyonu: Bir <span="apicollection">Blog Koleksiyonu, kullanıcının erişim haklarına sahip olduğu tüm Blog'lardan oluşur. Blogları kullanıcıya göre listeleyebilir veya kimliğe göre tek bir blog alabilirsiniz.</span="apicollection">
Yayınlar Koleksiyonu: Yayın Koleksiyonu, belirli bir Bloglar Kaynağı'ndaki tüm Yayın Kaynaklarından oluşur.
Yorum Koleksiyonu: Yorum Koleksiyonu, belirli bir Yayın Kaynağı'ndaki tüm Yorum Kaynaklarından oluşur.
Sayfalar Koleksiyonu: Sayfa Koleksiyonu, belirli bir Blog Kaynağı'ndaki tüm Sayfa Kaynaklarından oluşur.
Kullanıcılar Koleksiyonu: Kullanıcı Koleksiyonu, Blogger'daki tüm Kullanıcı Kaynaklarından oluşur ve bu nedenle listelenemez. Kullanıcılar, kimliğe göre veya self tanımlayıcısını kullanarak kendi Kullanıcı Kaynağı'nı (başka hiçbir kullanıcınınkini değil) alabilir.

Blogger JSON API işlemleri

Blogger JSON API'de koleksiyonlar ve kaynaklar için aşağıdaki tabloda açıklandığı gibi iki farklı yöntemi çağırabilirsiniz.

İşlem	Açıklama	REST HTTP eşlemeleri
list	Bir koleksiyondaki tüm kaynakları listeler.	`GET` koleksiyon URI'sinde.
get	Belirli bir kaynağı alır.	`GET` kaynağının URI'sinde.

Aşağıdaki tabloda, her kaynak türü tarafından desteklenen yöntemler gösterilmektedir. Gizli bloglarda tüm list ve get işlemleri kimlik doğrulamasını gerektirir.

Kaynak Türü	Desteklenen Yöntemler
	list	get
Bloglar	evet	evet
Yayınlar	evet	evet
Yorumlar	evet	evet
Sayfalar	evet	evet
Kullanıcı sayısı	hayır	evet

Arama stilleri

API'yi çağırmanın birkaç yolu vardır:

Doğrudan REST'i veya JavaScript'i kullanarak (sunucu tarafı kod gerekmez)
İstemci kitaplıklarını kullanarak

REST

REST, veri isteme ve değiştirmeye kullanışlı ve tutarlı yaklaşım sağlayan bir yazılım mimarisi stilidir.

REST terimi, "Representational State Transfer"in (Temsili Durum Aktarımı) kısaltmasıdır. Google API'leri bağlamında, Google tarafından saklanan verilerin temsillerini almak ve değiştirmek için HTTP fiillerini kullanma anlamına gelir.

RESTful bir sistemde, kaynaklar bir veri deposunda saklanır. Bir istemci, sunucunun belirli bir işlemi (ör. kaynak oluşturma, alma, güncelleme veya silme) gerçekleştirmesi için istek gönderir. Sunucu, işlemi gerçekleştirir ve yanıt gönderir. Bu yanıt genelde belirtilen kaynağın bir temsili biçimindedir.

Google'ın RESTful API'lerinde istemci, HTTP fiili kullanarak (ör. POST, GET, PUT veya DELETE) bir işlem belirtir. Aşağıdaki biçimde yer alan küresel olarak benzersiz bir URI ile kaynak belirtir:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

Tüm API kaynaklarının HTTP tarafından erişilebilen benzersiz URI'ları olduğu için REST, veri önbelleğe almayı etkinleştirir ve web'deki dağıtılan altyapıyla birlikte çalışmak üzere optimize edilmiştir.

HTTP 1.1 standartları dokümanlarında bulunan yöntem tanımlarını faydalı bulabilirsiniz. Bu dokümanlar GET, POST, PUT ve DELETE ile ilgili spesifikasyonları içerir.

Blogger JSON API'de REST

Desteklenen Blogger işlemleri, Blogger JSON API işlemleri bölümünde açıklandığı gibi doğrudan REST HTTP fiilleriyle eşlenir.

Blogger JSON API URI'leri için özel biçim:

https://www.googleapis.com/blogger/v2/users/userId
https://www.googleapis.com/blogger/v2/users/self
https://www.googleapis.com/blogger/v2/users/userId/blogs
https://www.googleapis.com/blogger/v2/users/self/blogs

https://www.googleapis.com/blogger/v2/blogs/blogId/posts
https://www.googleapis.com/blogger/v2/blogs/blogId/posts/postId
https://www.googleapis.com/blogger/v2/blogs/blogId/posts/postId/comments
https://www.googleapis.com/blogger/v2/blogs/blogId/posts/postId/comments/commentId
https://www.googleapis.com/blogger/v2/blogs/blogId/pages
https://www.googleapis.com/blogger/v2/blogs/blogId/pages/pageId

Kullanılan URI'lerin tam açıklaması ve API'deki her desteklenen işlemin sonuçları Blogger JSON API Referansı belgesinde özetlenmiştir.

Aşağıda, bu işlemin Blogger JSON API'de nasıl çalıştığına dair birkaç örnek verilmiştir.

Kimliği doğrulanmış kullanıcının erişim haklarına sahip olduğu blogları listeleyin:

GET https://www.googleapis.com/blogger/v2/users/self/blogs?key=YOUR-API-KEY

code.blogger.com blogundaki (3213900 kimlikli) yayınları alın:

GET https://www.googleapis.com/blogger/v2/blogs/3213900?key=YOUR-API-KEY

JavaScript'ten REST

callback sorgu parametresini ve bir geri çağırma işlevini kullanarak JavaScript'den REST kullanarak Blogger JSON API'yi çağırabilirsiniz. Bu sayede, sunucu tarafı kod yazmadan Blogger verilerini gösteren zengin uygulamalar oluşturabilirsiniz.

Aşağıdaki örnekte, YOUR-API-KEY değerini API anahtarınızla değiştirdikten sonra code.blogger.com blogundan bir yayın alınır.

<html>
  <head>
    <title>Blogger JSON API Example</title>
  </head>
  <body>
    <div id="content"></div>
    <script>
      function handleResponse(response) {
        document.getElementById("content").innerHTML += "<h1>" + response.title + "</h1>" + response.content;
      }
    </script>
    <script
    src="https://www.googleapis.com/blogger/v2/blogs/3213900/posts/8398240586497962757?callback=handleResponse&key=YOUR-API-KEY"></script>
  </body>
</html>

Veri biçimi

JSON

JSON (JavaScript Nesne Gösterimi), rastgele veri yapılarının basit bir metin temsilini sağlayan, yaygın ve dile bağlı olmayan bir veri biçimidir. Daha fazla bilgi için json.org adresini ziyaret edin.