Ważne: to jest stara wersja tej strony. Aby uzyskać najnowszą wersję, użyj linków na pasku nawigacyjnym po lewej stronie.
Ten dokument zawiera szczegółową dokumentację referencyjną dotyczącą protokołu RAW (XML i HTTP) do interfejsu API danych Bloggera.
Ten dokument nie zawiera informacji o bibliotekach klienta dla języka programowania. Linki do informacji o bibliotece klienta znajdziesz w sekcjach przewodnika dla programistów, które dotyczą konkretnego języka programowania.
Spis treści
Odbiorcy
Ten dokument jest przeznaczony dla programistów, którzy chcą pisać aplikacje klienckie obsługujące Bloggera.
Jest to dokument referencyjny. Zakładamy w nim, że znasz pojęcia przedstawione w przewodniku dla programistów i ogólnie masz wiedzę o protokole interfejsów API danych Google.
Typy kanałów Bloggera
Blogger udostępnia dwie wersje treści bloga w kanałach: pełne i podsumowania. Pełny kanał zawiera pełne posty na blogu, a kanał podsumowania zawiera tylko krótki fragment każdego posta.
Za pomocą ustawień GUI właściciel bloga może określić, czy blog ma dostarczać pełny kanał czy kanał podsumowania do syndykatorów i agregatorów.
Gdy aplikacja kliencka wysyła nieuwierzytelnione żądanie kanału, otrzymuje typ kanału określony przez właściciela bloga.
Gdy jednak Twoja aplikacja kliencka wysyła uwierzytelnione żądanie, zawsze otrzymuje pełny kanał niezależnie od tego, co określił właściciel bloga.
Informacje o parametrach zapytań Bloggera
Interfejs API danych Bloggera obsługuje prawie wszystkie standardowe parametry zapytań interfejsu Google Data API.
Blogger nie obsługuje parametrów q (wyszukiwanie tekstu) ani author.
Parametry zapytania updated-min i updated-max są ignorowane, chyba że parametr orderby ma wartość updated. Na przykład ten adres URL zawiera wszystkie posty na blogu, które zostały zaktualizowane między 16 marca 2008 r. a 24 marca 2008 roku:
http://www.blogger.com/feeds/blogID/posts/default?updated-min=2008-03-16T00:00:00&updated-max=2008-03-24T23:59:59&orderby=updated
Informacje o elementach Bloggera
Interfejs API danych Bloggera używa tylko standardowych elementów Atom. Więcej informacji znajdziesz w specyfikacji formatu dystrybucji Atom 1.0 i Atom Publishing Protocol.
Pozostała część tej sekcji zawiera kilka konkretnych uwag na temat użycia niektórych elementów standardowych w Bloggerze.
Wersje robocze wpisów
Wersja robocza wpisu na blogu jest oznaczona za pomocą elementu rozszerzenia <app:draft> zdefiniowanego w dokumencie Atom Publishing Protocol. Oto przykład wersji roboczej wpisu:
<entry xmlns:app='http://purl.org/atom/app#'> ... <app:control> <app:draft>yes</app:draft> </app:control> </entry>
Jeśli nie podasz żadnego elementu <draft>, wpis nie jest wersją roboczą.
Daty publikacji i aktualizacji
Sygnatura czasowa podana w standardowym elemencie <published> Atom odpowiada „daty publikacji”, którą użytkownik może ustawić w GUI Bloggera.
Gdy klient utworzy nowy wpis, a nie ustawi wartości <published>, Blogger ustawia datę publikacji tego wpisu na bieżący czas serwera. Jeśli klient edytuje wpis, ale nie określi wartości <published>, Blogger pozostawi datę publikacji tego wpisu bez zmian.
Jeśli jednak Twój klient podczas tworzenia lub edytowania wpisu określi wartość elementu <published>, Blogger ustawi datę publikacji tego wpisu na określoną wartość. Może to być przydatne w przypadku zadań takich jak importowanie starych wpisów z innego systemu blogowego (z zachowaniem pierwotnej daty utworzenia).
Blogger używa standardowego elementu Atom <updated> do wskazywania ostatniej zmiany wpisu. Twój klient nie może kontrolować wartości <updated>. Za każdym razem, gdy klient publikuje lub edytuje wpis, Blogger zawsze ustawia datę ostatniej aktualizacji wpisu na aktualny czas serwera.
Możesz użyć standardowych parametrów zapytania published-min, published-max, updated-min i updated-max interfejsu Google Data API, aby zażądać wpisów na podstawie ich wartości <published> lub <updated>. Jednak uwagi o zapytaniach dotyczących zaktualizowanych dat znajdziesz w dokumentacji parametrów zapytań w Bloggerze.
Łączenie komentarzy do postów
Format eksportu Bloggera zawiera zarówno posty, jak i komentarze w jednym dokumencie kanału Atom.
Aby rozróżnić te 2 typy wpisów, Blogger korzysta z elementu <atom:category>. Ten element będzie miał parametr term, który określa, czy wpis dotyczy posta czy komentarza.
Poza tym powiązanie komentarza z wpisem, do którego się on należy, można wykonać za pomocą rozszerzenia Atom Threading. W poniższym przykładzie element <thr:in-reply-to> we wpisie komentarza będzie wskazywał posta za pomocą identyfikatora wpisu w parametrze ref. Zawiera też link do adresu URL HTML posta w parametrze href.
<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>