Ważne: to jest starsza wersja tej strony. Aby uzyskać najnowszą wersję, użyj linków na pasku nawigacyjnym po lewej stronie.
Ten dokument zawiera szczegółową dokumentację referencyjną protokołu RAW (XML i HTTP) dla interfejsu API danych Bloggera.
Ten dokument nie zawiera informacji o języku programowania bibliotek klienckich. Informacje o bibliotekach klienta znajdziesz w linkach w odpowiednich sekcjach przewodnika dla deweloperów dotyczących języków programowania.
Spis treści
Odbiorcy
Ten dokument jest przeznaczony dla programistów, którzy chcą pisać które mogą wchodzić w interakcję z Bloggerem.
Jest to dokument referencyjny, który zakłada, że rozumiesz pojęcia opisane 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 w kanałach dwie wersje treści bloga: pełne kanały i plików 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 za pomocą ustawień GUI określić, czy blog pełny plik danych lub plik z podsumowaniem dla syndykatorów i agregatorów.
Gdy aplikacja kliencka wysyła żądanie niezautentifikowane dotyczące pliku danych, otrzymuje typ pliku danych 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.
Informacje o parametrach zapytań Bloggera
Interfejs Blogger Data API obsługuje prawie wszystkie standardowe parametry zapytań interfejsu Data API.
Blogger nie obsługuje funkcji q (wyszukiwania 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 pozwala pobrać wszystkie
posty zaktualizowane od 16 marca 2008 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
Odwołania do elementów Bloggera
Interfejs API danych Bloggera korzysta tylko ze standardowych elementów Atom. , zapoznaj się z aplikacją Atom Specyfikacja formatu dystrybucji 1.0 i Atom Publishing Protocol.
Pozostała część tej sekcji zawiera kilka konkretnych uwag na temat niektóre elementy standardowe.
Wersje robocze wpisów
Projekt wpisu na blogu jest oznaczony za pomocą elementu rozszerzenia <app:draft> zdefiniowanego w dokumencie protokołu publikowania Atom. 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 żadnego elementu <draft>, wpis nie jest
wersji roboczej.
daty publikacji i aktualizacji.
Sygnatura czasowa podana w standardowym formacie Atom <published>
element odpowiada „dacie publikacji” którą użytkownik może ustawić w
Blogger GUI.
Gdy klient utworzy nowy wpis, a nie określi wartości
dla <published>, to Blogger ustawi datę posta na
aktualnej godziny serwera. Jeśli klient zmodyfikuje wpis, ale nie poda wartości parametru <published>, Blogger nie zmieni daty publikacji wpisu.
Jeśli jednak podczas tworzenia lub edytowania wpisu klient poda wartość elementu <published>, Blogger ustawi datę opublikowania wpisu na tę wartość. To może być przydatne
w przypadku zadań takich jak importowanie starych wpisów z innego systemu blogowego (przy jednoczesnym zachowaniu
pierwotnej daty utworzenia).
Blogger używa standardowego elementu Atom <updated>, aby wskazać, kiedy wpis został ostatnio zmieniony. Twój klient nie może kontrolować
<updated> wartość; Blogger zawsze ustawia ostatnią aktualizację wpisu
za każdym razem, gdy klient publikuje lub edytuje
wpisu.
Możesz użyć standardowego interfejsu Google Data API published-min,
published-max, updated-min i
updated-max parametrów zapytania, które wysyłają żądania wpisów na podstawie ich
<published> lub <updated> wartości. Informacje o zapytaniach dotyczących zaktualizowanych dat znajdziesz jednak w przewodniku po parametrach zapytań w Bloggerze.
Łączenie komentarzy do postów
Narzędzie do eksportowaniaBloggera
format zawiera zarówno posty, jak i wpisy komentarzy 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. Link prowadzi również do adresu URL w formacie HTML posta za pośrednictwem tagu
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>