Bu dokümanda, Blogger Data API için ham protokol (XML ve HTTP) ile ilgili ayrıntılı referans dokümanlar sunulmaktadır.
Bu belge, programlama dili istemci kitaplıkları hakkında bilgi içermez. İstemci kitaplığı referans bilgileri için geliştirici kılavuzunun programlama diline özgü bölümlerindeki bağlantılara göz atın.
İçindekiler
Kitle
Bu belge, Blogger ile etkileşimde bulunabilecek istemci uygulamaları yazmak isteyen programcılar için hazırlanmıştır.
Bu başvuru kılavuzudur. Geliştirici kılavuzunda sunulan kavramları ve Google Veri API'leri protokolünün ardındaki genel fikirleri anladığınızı varsayar.
Blogger feed türleri
Blogger, feed'lerde blog içeriğinin iki temsilini sağlar: tam feed'ler ve özet feed'leri. Tam yayın tam blog yayınlarını içerirken özet feed'i de her yayının yalnızca kısa bir snippet'ini içerir.
Blog sahibi, GUI ayarlarını kullanarak blogun, sendikasyon veya toplayıcılara özet akışı ya da tam özet akışı sağlayıp sağlamadığını belirleyebilir.
İstemci uygulamanız bir özet akışı için kimliği doğrulanmamış bir istek gönderdiğinde, blog sahibinin belirttiği özet akışı türünü alır.
Bununla birlikte, istemci uygulamanız kimliği doğrulanmış bir istek gönderdiğinde, blog sahibinin belirttiğinden bağımsız olarak her zaman tam bir feed alır.
Blogger sorgu parametreleri referansı
Blogger Data API, neredeyse tüm standart Google Data API sorgu parametrelerini destekler.
Blogger, author parametresini desteklemiyor.
orderby parametresi updated olarak ayarlanmadıkça updated-min ve updated-max sorgu parametreleri yoksayılır. Örneğin, aşağıdaki URL, 16 Mart 2008 ile 24 Mart 2008 arasında güncellenen tüm blog yayınlarını alır:
http://www.blogger.com/feeds/blogID/posts/default?updated-min=2008-03-16T00:00:00&updated-max=2008-03-24T23:59:59&orderby=updated
Blogger öğeleri referansı
Blogger Data API'sı yalnızca standart Atom öğelerini kullanır. Daha fazla bilgi için Atom 1.0 sendikasyon biçimi spesifikasyonu ve Atom Yayıncılık Protokolü'ne bakın.
Bu bölümün geri kalanında Blogger'ın bazı standart öğelerin kullanımı hakkında birkaç özel not verilmiştir.
Taslak girişler
Taslak blog girişi, Atom Yayıncılık Protokolü dokümanında tanımlanan <app:draft> uzantı öğesi kullanılarak işaretlenir. Taslak girişe bir örnek:
<entry xmlns:app='http://www.w3.org/2007/app'> ... <app:control> <app:draft>yes</app:draft> </app:control> </entry>
<draft> öğesi belirtilmezse giriş bir taslak değildir.
Yayın tarihleri ve güncelleme tarihleri
Standart Atom <published> öğesinde verilen zaman damgası, kullanıcının Blogger GUI'de ayarlayabileceği"yayın tarihi"ne karşılık gelir.
İstemciniz yeni bir giriş oluşturduğunda, istemci <published> için bir değer belirtmezse Blogger, girişin yayınlanma tarihini mevcut sunucu saatine ayarlar. İstemciniz bir girişi düzenlediği halde <published> değeri belirtmediğinde giriş girişinin yayın tarihi tek başına kalır.
Bununla birlikte, müşteriniz bir girişi oluştururken veya düzenlerken <published> öğesi için bir değer belirtirse Blogger, girişin yayın tarihini belirtilen değere ayarlar. Bu, eski girişleri başka bir blog sisteminden içe aktarma (orijinal oluşturma tarihlerini korurken) gibi görevler için yararlı olabilir.
Blogger, bir girişin en son ne zaman değiştirildiğini belirtmek için standart Atom <updated> öğesini kullanır. İstemciniz <updated> değerini kontrol edemez. İstemciniz bir girişi yayınladığında veya düzenlediğinde Blogger her zaman girişin son güncellenme tarihini geçerli sunucu saatine ayarlar.
<published> veya <updated> değerlerine göre giriş istemek için standart Google Data API published-min,
published-max, updated-min ve
updated-max sorgu parametrelerini kullanabilirsiniz. Ancak, güncellenmiş tarihlerde sorgu oluşturmayla ilgili notlar için Blogger sorgu parametreleri referansı sayfasını inceleyin.
Yayınlara yorum bağlama
Blogger dışa aktarma biçimi, tek bir Atom feed dokümanında hem yayınları hem yorum girişlerini içerir.
Blogger, iki giriş türünü birbirinden ayırt etmek için <atom:category> öğesini kullanır. Bu öğe, girişin bir yayın için mi yoksa bir yorum için mi olduğunu yansıtan term parametresine sahip olur.
Dahası, yorum girişini ait olduğu yayın girişine bağlamak, Atom Mesaj Dizisi Uzantısı kullanılarak gerçekleştirilir. Aşağıdaki örnekte, ref girişindeki yayın girişi tanımlayıcısı kullanılarak yorum girişinde <thr:in-reply-to> öğesi, yayına işaret edecektir. Ayrıca, href parametresi aracılığıyla yayının HTML URL'sine bağlanır.
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/"
xmlns:thr="http://purl.org/syndication/thread/1.0">
...
<-- A blog post entry -->
<entry>
<id>tag:blogger.com,1999:blog-blogID.post-postID</id>
<content type="html">This is my first post</content>
<link rel="alternate" type="text/html"
href="http://blogName.blogspot.com/2007/04/first-post.html">
</link>
<category scheme="http://schemas.google.com/g/2005#kind"
term="http://schemas.google.com/blogger/2008/kind#post"/>
...
</entry>
<-- A comment to the blog post entry -->
<entry>
<id>tag:blogger.com,1999:blog-blogID.post-postID.comment-commentID</id>
<content type="html">This is my first commment</content>
<category scheme="http://schemas.google.com/g/2005#kind"
term="http://schemas.google.com/blogger/2008/kind#comment"/>
<thr:in-reply-to href="http://blogName.blogspot.com/2007/04/first-post.html"
ref="tag:blogger.com,1999:blog-blogID.post-postID"
type="text/html"/>
...
</entry>
</feed>