Önemli: Bu, sayfanın eski bir sürümüdür. En son sürüm için sol taraftaki gezinme çubuğundaki bağlantıları kullanın.
Bu belgede, Blogger Data API'nin ham protokolüne (XML ve HTTP) dair ayrıntılı referans belgeleri 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 özel bölümlerindeki bağlantılara bakın.
İçindekiler
Kitle
Bu doküman, Blogger ile etkileşimde bulunabilecek istemci uygulamaları yazmak isteyen programcılar için hazırlanmıştır.
Referans bir belgedir. Geliştirici kılavuzunda sunulan kavramları ve Google Veri API'leri protokolünün arkasındaki genel fikirleri anladığınız varsayılır.
Blogger özet akışı türleri
Blogger, feed'lerde blog içeriği için iki gösterim sunar: tam feed'ler ve özet feed'leri. Tam feed, blog yayınlarının tamamını içerirken özet feed'i her yayının yalnızca kısa bir snippet'ini içerir.
Bir blogun sahibi, blog'un sendikasyoncılara ve toplayıcılara tam yayın mı yoksa özet akışı mı sağlayacağını GUI ayarlarını kullanarak belirtebilir.
İstemci uygulamanız bir feed için kimliği doğrulanmamış istek gönderdiğinde blog sahibinin belirttiği feed türünü alır.
Ancak istemci uygulamanız, kimliği doğrulanmış bir istek gönderdiğinde blog sahibinin belirttiğinden bağımsız olarak her zaman tam özet akışı alır.
Blogger sorgu parametreleri referansı
Blogger Data API, standart Google Data API sorgu parametrelerinin neredeyse tümünü destekler.
Blogger, q (metin arama) ve author parametrelerini desteklemez.
orderby parametresi updated olarak ayarlanmadığı sürece updated-min ve updated-max sorgu parametreleri yoksayılır. Örneğin, aşağıdaki URL 16 Mart 2008 ile 24 Mart 2008 tarihleri 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 yalnızca standart Atom öğelerini kullanır. Daha fazla bilgi için Atom 1.0 sendikasyon biçimi spesifikasyonu ve Atom Yayınlama Protokolü'ne göz atın.
Bu bölümün geri kalanında, Blogger'ın bazı standart öğeleri kullanımıyla ilgili birkaç özel not sunulmaktadır.
Taslak girişler
Taslak blog girişi, Atom Yayınlama Protokolü dokümanında tanımlanan <app:draft> uzantı öğesi kullanılarak işaretlenir. Aşağıda bir taslak giriş örneği verilmiştir:
<entry xmlns:app='http://purl.org/atom/app#'> ... <app:control> <app:draft>yes</app:draft> </app:control> </entry>
Herhangi bir <draft> öğesi belirtilmezse giriş taslak olmaz.
Yayın tarihleri ve güncelleme tarihleri
Standart Atom <published> öğesinde belirtilen 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 geçerli sunucu saatine ayarlar. İstemciniz bir girişi düzenler ancak <published> değeri belirtmediğinde Blogger, girişin yayınlanma tarihini yalnızca bırakır.
Ancak, müşteriniz bir giriş oluştururken veya düzenlerken <published> öğesi için bir değer belirtirse Blogger, girişin yayınlanma tarihini belirtilen değere ayarlar. Bu, başka bir blog sistemindeki eski girişleri 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 edemiyor. İstemciniz bir giriş gönderdiğinde veya düzenlediğinde Blogger her zaman girişin son güncelleme tarihini geçerli sunucu saatine ayarlar.
<published> veya <updated> değerlerine göre giriş isteğinde bulunmak için standart Google Data API published-min, published-max, updated-min ve updated-max sorgu parametrelerini kullanabilirsiniz. Ancak güncellenmiş tarihlerde sorgulama yapmayla ilgili notlar için Blogger sorgu parametreleri referansı sayfasına bakın.
Yorumlarla yayınlar arasında bağlantı oluşturma
Blogger dışa aktarma biçimi, tek bir Atom feed dokümanında hem yayınlar hem de yorum girişleri içerir.
Blogger, iki giriş türünü birbirinden ayırt etmek için <atom:category> öğesini kullanır. Bu öğenin, girişin bir yayına mı yoksa bir yoruma mı yönelik olduğunu gösteren bir term parametresi bulunur.
Ayrıca, yorum girişinin ait olduğu yayın girişine bağlanması Atom Threading Extension yoluyla sağlanır. Aşağıdaki örnekte yorum girişindeki <thr:in-reply-to> öğesi, ref parametresindeki yayın girişi tanımlayıcısını kullanarak yayını işaret eder. Ayrıca, href parametresi aracılığıyla yayının HTML URL'sine bağlantı verir.
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
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>