Ważne: to jest stara wersja tej strony. Aby użyć najnowszej wersji, kliknij linki na pasku nawigacyjnym po lewej stronie.
Ten dokument zawiera szczegółową dokumentację referencyjną nieprzetworzonego protokołu (XML i HTTP) interfejsu API danych Bloggera.
Ten dokument nie zawiera informacji o bibliotekach klienta służących do programowania. Szczegółowe informacje o bibliotece klienta znajdziesz w linkach w sekcji dotyczącej konkretnego języka programowania w przewodniku dla programistów.
Spis treści
Odbiorców
Ten dokument jest przeznaczony dla programistów, którzy chcą tworzyć aplikacje klienckie obsługujące interakcje z Bloggerem.
Jest to dokument referencyjny, który zakłada, że rozumiesz pojęcia przedstawione w przewodniku dla programistów i ogólne zagadnienia związane z protokołem interfejsów API danych Google.
Typy kanałów Bloggera
Blogger udostępnia w kanałach treści na 2 sposoby: za pomocą kanałów pełnych i podsumowań. Pełny kanał zawiera pełne posty na blogu, a podsumowanie – tylko krótki fragment każdego posta.
Właściciel bloga może określić przy użyciu ustawień GUI, czy syndykator oferuje kompleksowe źródło treści, czy streszczenie kanału.
Gdy aplikacja kliencka wysyła nieuwierzytelnione żądanie kanału, otrzymuje dowolny typ kanału określony przez właściciela bloga.
Kiedy aplikacja kliencka wysyła uwierzytelnione żądanie, zawsze otrzymuje pełny kanał, niezależnie od wartości określonych przez właściciela bloga.
Dokumentacja parametrów zapytań w Bloggerze
Interfejs API danych Bloggera obsługuje prawie wszystkie standardowe parametry zapytania interfejsu Google Data API.
Blogger nie obsługuje parametrów q (wyszukiwanie tekstowe) ani author.
Parametry zapytania updated-min i updated-max są ignorowane, chyba że parametr orderby jest ustawiony na updated. Na przykład ten URL pobiera wszystkie posty na blogu, które zostały zaktualizowane od 16 do 24 marca 2008:
http://www.blogger.com/feeds/blogID/posts/default?updated-min=2008-03-16T00:00:00&updated-max=2008-03-24T23:59:59&orderby=updated
Omówienie elementów Bloggera
Interfejs API danych Bloggera używa tylko standardowych elementów Atom. Więcej informacji znajdziesz w specyfikacji formatu Atom 1.0 i protokole Atom Publishing.
W pozostałej sekcji znajdziesz kilka konkretnych informacji o używaniu niektórych elementów standardowych w Bloggerze.
Wersje robocze
Wersja robocza wpisu na blogu jest oznaczona jako element rozszerzenia <app:draft> zdefiniowany 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 określono elementu <draft>, wpis nie jest wersją roboczą.
Daty publikacji i aktualizacje
Sygnatura czasowa podana w standardowym elemencie Atom <published> odpowiada dacie &daty publikacji, którą użytkownik może ustawić w GUI interfejsu Bloggera.
Gdy klient utworzy nowy wpis, a jeśli nie podasz wartości w polu <published>, Blogger ustawi datę publikacji wpisu na bieżący czas serwera. Gdy klient edytuje wpis, ale nie określa wartości <published>, Blogger pozostawia sam wpis o sobie.
Jeśli jednak klient określa wartość elementu <published> podczas tworzenia lub edytowania wpisu, Blogger ustawia datę publikacji wpisu na określoną wartość. Może to być przydatne w przypadku zadań takich jak importowanie starych wpisów z innego systemu blogów (ale zachowanie oryginalnych dat utworzenia).
Blogger używa standardowego elementu Atom <updated>, aby wskazać czas ostatniej zmiany wpisu. Twój klient nie może kontrolować wartości <updated>. Blogger zawsze ustawia bieżącą datę ostatniej aktualizacji wpisu dla bieżącego serwera, gdy klient opublikuje lub zmodyfikuje wpis.
Możesz użyć standardowych parametrów zapytania Google Data API: published-min, published-max, updated-min i updated-max, aby zażądać wpisów na podstawie wartości <published> lub <updated>. Uwagi na temat zapytań o aktualne daty znajdziesz w dokumentacji parametrów zapytań w Bloggerze.
Komentarze do postów
Format eksportu Bloggera zawiera w jednym dokumencie kanału Atom zarówno wpisy, jak i komentarze.
Aby odróżnić te 2 typy wpisów, Blogger używa elementu <atom:category>. Ten element będzie zawierać parametr term, który odzwierciedla, czy wpis dotyczy posta czy komentarza.
Co więcej, połączenie komentarza z wpisem, do którego należy, możliwe jest dzięki rozszerzeniu Atom. W poniższym przykładzie element <thr:in-reply-to> w komentarzu wskazuje identyfikator posta, korzystając z identyfikatora posta w parametrze ref. Zawiera też link do adresu URL posta w postaci parametru 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>