Ważne: to jest starsza wersja tej strony. Aby pobrać najnowszą wersję, użyj linków w pasku nawigacyjnym po lewej stronie.
Ten dokument zawiera szczegółową dokumentację referencyjną protokołu nieprzetworzonego (XML i HTTP) interfejsu Blogger Data API.
Ten dokument nie zawiera informacji o bibliotekach klienta języka programowania. Informacje referencyjne dotyczące biblioteki klienta znajdziesz w linkach w odpowiednich sekcjach przewodnika dla programistów dotyczących języków programowania.
Spis treści
Odbiorcy
Ten dokument jest przeznaczony dla programistów, którzy chcą pisać aplikacje klienckie, które mogą wchodzić w interakcje z Bloggerem.
Jest to dokument referencyjny, który zakłada, że rozumiesz pojęcia omówione w przewodniku dla deweloperów oraz ogólne założenia protokołu interfejsów Google Data API.
Typy kanałów Bloggera
Blogger udostępnia 2 rodzaje treści bloga w plikach danych: pełne pliki danych i pliki danych z podsumowaniem. Pełny plik zawiera pełne posty na blogu, a plik z podsumowaniem zawiera tylko krótki fragment każdego posta.
Właściciel bloga może określić w ustawieniach interfejsu graficznego, czy blog dostarcza do dostawców i agregatorów pełny plik danych czy plik danych z podsumowaniem.
Gdy aplikacja kliencka wysyła żądanie niezaufanego pliku danych, otrzymuje plik danych tego typu, który został określony przez właściciela bloga.
Gdy jednak aplikacja kliencka wysyła uwierzytelnione żądanie, zawsze otrzymuje pełny plik danych, niezależnie od tego, co określił właściciel bloga.
Parametry zapytań Bloggera
Interfejs Blogger Data API obsługuje prawie wszystkie standardowe parametry zapytań interfejsu Data API.
Blogger nie obsługuje parametrów q (wyszukiwanie tekstowe) i author.
Parametry zapytania updated-min i updated-max są ignorowane, chyba że parametr orderby ma wartość updated. Na przykład ten adres URL umożliwia pobranie wszystkich postów na blogu, które zostały zaktualizowane w okresie od 16 marca do 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
Odwołania do elementów Bloggera
Interfejs Blogger Data API używa tylko standardowych elementów Atom. Więcej informacji znajdziesz w specyfikacji formatu syndication 1.0 Atom i protokole Atom Publishing Protocol.
W pozostałej części tej sekcji znajdziesz kilka uwag dotyczących korzystania z niektórych elementów standardowych w Bloggerze.
Wersje robocze
Projekt wpisu na blogu jest oznaczony za pomocą elementu rozszerzenia <app:draft> zdefiniowanego w dokumencie Atom Publishing Protocol. Oto przykład wpisu w wersji roboczej:
<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 aktualizacji.
Znak czasu podany w standardowym elemencie Atom <published> odpowiada „dacie publikacji”, którą użytkownik może ustawić w interfejsie graficznym Bloggera.
Gdy klient utworzy nowy wpis, a nie poda wartości parametru <published>, Blogger ustawi datę publikacji wpisu na bieżący czas serwera. Jeśli klient zmodyfikuje wpis, ale nie poda wartości parametru <published>, Blogger nie zmieni daty opublikowania wpisu.
Jeśli jednak podczas tworzenia lub edytowania wpisu klient poda wartość elementu <published>, Blogger ustawi datę opublikowania wpisu na tę wartość. Może to być przydatne do zadań takich jak importowanie starych wpisów z innego systemu blogowego (przy zachowaniu pierwotnych dat utworzenia).
Blogger używa standardowego elementu Atom <updated>, aby wskazać, kiedy wpis został ostatnio zmieniony. Twój klient nie może kontrolować wartości parametru <updated>. Gdy klient publikuje lub edytuje wpis, Blogger zawsze ustawia datę ostatniej modyfikacji wpisu na bieżący czas serwera.
Aby wysyłać zapytania o rekordy na podstawie ich wartości <published> lub <updated>, możesz użyć standardowych parametrów zapytań interfejsu Google Data API published-min, published-max, updated-min i updated-max. Informacje o zapytaniach dotyczących zaktualizowanych dat znajdziesz jednak w przewodniku po parametrach zapytań w Bloggerze.
Łączenie komentarzy z postami
Format eksportu Bloggera zawiera zarówno wpisy, jak i komentarze w jednym dokumencie kanału Atom.
Aby rozróżnić te dwa typy wpisów, Blogger wykorzystuje element <atom:category>. Ten element będzie zawierać parametr term, który wskazuje, czy wpis dotyczy posta, czy komentarza.
Ponadto powiązanie wpisu z komentarzem z postem, do którego należy, odbywa się za pomocą rozszerzenia Atom Threading Extension. W przykładzie poniżej element <thr:in-reply-to> w rekordzie komentarza będzie wskazywać wpis za pomocą identyfikatora wpisu w parametrze ref. Zawiera też link do adresu URL posta w formacie HTML za pomocą 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>