Ö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 belge, ham protokol için ayrıntılı referans belgeleri sunar (XML ve HTTP) kullanın.
Bu belgede programlama dili hakkında bilgi yer almıyor kullanabilirsiniz. İstemci kitaplığı referans bilgileri için aşağıdaki bağlantılara bakın: geliştirici kılavuzunun programlama diline özgü bölümlerinden yararlanabilirsiniz.
İçindekiler
Kitle
Bu belge, istemci üzerinde çalışma yapmak isteyen programcılara yöneliktir. Blogger ile etkileşimde bulunabilecek uygulamalar.
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.
Bir blog'un sahibi, GUI ayarlarını kullanarak, blog'un blog'un tam feed veya özet feed'i ile birlikte kullanabilirsiniz.
İstemci uygulamanız, 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ğinden bağımsız olarak tam yayın alır.
Blogger sorgu parametreleri referansı
Blogger Data API, Google Haritalar'daki standart Google Data API sorgu parametreleri.
Blogger q (metin arama) ve
author parametre
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 bkz. Atom 1.0 sendikasyon biçimi spesifikasyonu ve Atom Yayınlama Protokolü.
Bu bölümün geri kalanında, Blogger'ın bazı standart öğelerin kullanımı.
Taslak girişler
Blog girişi taslağı, Atom Yayınlama Protokolü belgesinde tanımlanan <app:draft> uzantı öğesi kullanılarak işaretlenir. Bir
örnek bir giriş göreceksiniz:
<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ın tarihleri ve güncelleme tarihleri
Standart Atom <published>'de verilen zaman damgası
öğesi, "yayın tarihi"ne karşılık gelir kullanıcının
Blogger GUI'si.
Müşteriniz yeni bir giriş oluşturduğunda (müşteri bir değer belirtmezse)
<published> için, Blogger girişin yayınlanma tarihini
güncel sunucu zamanı. Müşteriniz bir girişi düzenlediğinde ancak
<published> değeri, Blogger girişin yayınlanma tarihinden ayrılır
yaşayabilirsiniz.
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. Faydalı olabilir
başka bir blog sistemindeki eski girişleri içe aktarmak gibi görevler için
orijinal oluşturma tarihleri).
Blogger,<updated>
bir girişin en son ne zaman değiştirildiğini belirtir. İ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 Veri API'sını published-min kullanabilirsiniz:
published-max, updated-min ve
Anahtar kelimelere göre giriş istemek için updated-max sorgu parametresi
<published> veya <updated> değerleri. Ancak,
güncellenen tarihlerde sorgulamayla ilgili notlar için bkz. Blogger
sorgu parametreleri referansı.
Yorumlarla yayınlar arasında bağlantı oluşturma
Blogger'ın 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 bir
Girişin bir yayına mı yoksa bir yayına yönelik mi olduğunu yansıtan term parametresi
yorum'a dokunun.
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, yorumdaki <thr:in-reply-to> öğesi
kaydı,
ref parametresinden yararlanın. 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>