Ö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 için ham protokol (XML ve HTTP) ile ilgili ayrıntılı referans dokümanları sağlanmaktadır.
Bu dokümanda, programlama dili istemci kitaplıkları hakkında bilgi verilmemiştir. İ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şime geçebilecek istemci uygulamaları yazmak isteyen programcılara yöneliktir.
Bu referans dokümanı, geliştirici kılavuzunda sunulan kavramları ve Google Veri API'leri protokolünün temel fikirlerini anladığınızı varsaymaktadır.
Blogger feed türleri
Blogger, feed'lerde blog içeriğinin iki temsilini sağlar: tam feed'ler ve özet feed'ler. Tam feed'ler blog yayınlarının tamamını içerirken özet feed'ler her yayından yalnızca kısa bir snippet içerir.
Blog sahibi, blogun distribütörlere ve toplayıcılara tam feed mi yoksa özet feed mi sağlayacağını GUI ayarlarını kullanarak belirtebilir.
İstemci uygulamanız, bir feed için kimlik doğrulaması yapılmamış bir 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ği şekilden bağımsız olarak her zaman tam feed alır.
Blogger sorgu parametreleri referansı
Blogger Data API, neredeyse tüm standart Google Data API sorgu parametrelerini destekler.
Blogger, q (metin arama) ve author parametrelerini desteklemez.
orderby parametresi updated olarak ayarlanmazsa 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 yalnızca standart Atom öğelerini kullanır. Daha fazla bilgi için Atom 1.0 sendikasyon biçimi spesifikasyonuna ve Atom Yayınlama Protokolü'ne bakın.
Bu bölümün geri kalanında, Blogger'ın bazı standart öğeleri kullanımıyla ilgili birkaç not verilmiştir.
Taslak girişler
Blog girişi taslağı, Atom Yayınlama Protokolü belgesinde tanımlanan <app:draft> uzantı öğesi kullanılarak işaretlenir. Taslak giriş örneğini aşağıda görebilirsiniz:
<entry xmlns:app='http://purl.org/atom/app#'> ... <app:control> <app:draft>yes</app:draft> </app:control> </entry>
<draft> öğesi belirtilmezse giriş taslak değildir.
Yayınlanma tarihleri ve güncellenme tarihleri
Standart Atom <published> öğesinde verilen zaman damgası, kullanıcının Blogger kullanıcı arayüzünde ayarlayabileceği "yayınlanma tarihi"ne karşılık gelir.
İstemciniz yeni bir giriş oluşturduğunda <published> için bir değer belirtmezse Blogger, girişin yayınlanma tarihini mevcut sunucu saatine ayarlar. Müşteriniz bir girişi düzenlediğinde ancak <published> değeri belirtmediğinde Blogger, girişin yayınlanma tarihini olduğu gibi 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, eski girişleri başka bir blog sisteminden içe aktarma (orijinal oluşturma tarihlerini koruyarak) gibi görevler için yararlı olabilir.
Blogger, bir girişin 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ş yayınladığında veya düzenlediğinde Blogger, girişin son güncellenme tarihini her zaman mevcut sunucu saatine ayarlar.
Standart Google Data API published-min, published-max, updated-min ve updated-max sorgu parametrelerini kullanarak girişleri <published> veya <updated> değerlerine göre isteyebilirsiniz. Ancak güncellenmiş tarihlerde sorgu oluşturma hakkında notlar için Blogger sorgu parametreleri referansı başlıklı makaleyi inceleyin.
Yorumları yayınlara bağlama
Blogger dışa aktarma biçimi, hem yayınları hem de yorum girişlerini tek bir Atom feed belgesinde içerir.
Blogger, iki giriş türünü birbirinden ayırt etmek için <atom:category> öğesini kullanır. Bu öğede, girişin bir yayın mı yoksa yorum mu olduğunu belirten bir term parametresi bulunur.
Ayrıca, yorum girişinin ait olduğu yayın girişine bağlanması Atom mesaj dizisi uzantısı kullanılarak gerçekleştirilir. Aşağıdaki örnekte, yorum girişindeki <thr:in-reply-to> öğesi, ref parametresindeki gönderi girişi tanımlayıcısını kullanarak gönderiyi 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>