Ważne: 30 września 2024 r. przestaniemy obsługiwać interfejs Google Data API w wersji 2.0. Aby zapewnić niezakłócone działanie, zaktualizuj do najnowszej wersji interfejs API danych Google w aplikacjach, które korzystają z interfejsu Google Data API w wersji 2.0. Aby uzyskać dostęp do najnowszej wersji, użyj linków na pasku nawigacyjnym po lewej stronie. Uwaga: chociaż niektóre żądania GET (np. posty z listami produktów) będą nadal obsługiwane jako adresy URL kanałów, występują drobne różnice w ich działaniu. Szczegółowe informacje znajdziesz w Centrum pomocy Bloggera.
Ten dokument zawiera szczegółową dokumentację dotyczącą protokołu RAW (XML i HTTP) do interfejsu Blogger Data API.
Ten dokument nie zawiera informacji o bibliotekach klienta programowania. Informacje o bibliotece klienta znajdziesz pod poniższymi linkami w sekcji przewodnika dla programistów poświęconej danym językom programowania.
Spis treści
Odbiorcy
Ten dokument jest przeznaczony dla programistów tworzących aplikacje klienckie obsługujące Bloggera.
Ten dokument jest dokumentem referencyjnym. Zakładamy w nim, że znasz pojęcia opisane w przewodniku dla programistów oraz ogólne koncepcje protokołu interfejsów API danych Google.
Typy kanałów Bloggera
Blogger przedstawia zawartość bloga na 2 sposoby: w kanałach pełnych i z podsumowaniem. Pełny kanał zawiera pełne posty na blogu, natomiast kanał podsumowania zawiera tylko krótki fragment każdego posta.
Właściciel bloga może za pomocą ustawień graficznego interfejsu określić, czy blog ma udostępniać dystrybutorom i agregatorom pełny kanał, czy kanał podsumowujący.
Gdy aplikacja kliencka wysyła nieuwierzytelnione żądanie kanału, otrzymuje każdy typ kanału określony przez właściciela bloga.
Jednak gdy aplikacja kliencka wysyła uwierzytelnione żądanie, zawsze otrzymuje pełny kanał, niezależnie od ustawień właściciela bloga.
Odniesienie do parametrów zapytania w Bloggerze
Interfejs API danych Bloggera obsługuje prawie wszystkie standardowe parametry zapytania w interfejsie Google Data API.
Blogger nie obsługuje parametru author.
Parametry zapytania updated-min i updated-max są ignorowane, chyba że parametr orderby ma wartość updated. Na przykład ten URL umożliwia pobranie wszystkich postów na blogu, które zostały zaktualizowane w okresie od 16 marca 2008 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
Odniesienie do elementów Bloggera
Interfejs API danych Bloggera wykorzystuje tylko standardowe elementy Atom. Więcej informacji znajdziesz w specyfikacji formatu dystrybucji Atom 1.0 i w artykule Atom Publishing Protocol.
W pozostałej części tej sekcji znajdziesz kilka konkretnych uwag na temat wykorzystywania przez Bloggera elementów standardowych.
Wersje robocze wpisów
Wersja robocza wpisu na blogu jest oznaczana za pomocą elementu rozszerzenia <app:draft> zdefiniowanego w dokumencie Atom Publishing Protocol. Oto przykład wersji roboczej wpisu:
<entry xmlns:app='http://www.w3.org/2007/app'> ... <app:control> <app:draft>yes</app:draft> </app:control> </entry>
Jeśli nie określono żadnego elementu <draft>, wpis nie jest wersją roboczą.
Daty publikacji i aktualizacje
Sygnatura czasowa podana w standardowym elemencie Atom <published> odpowiada „datie publikacji”, którą użytkownik może ustawić w GUI Bloggera.
Gdy klient utworzy nowy wpis, ale nie określi on wartości <published>, Blogger ustawi datę opublikowania wpisu na bieżący czas serwera. Gdy klient edytuje wpis, ale nie określa wartości <published>, Blogger pozostawia datę posta bez zmian.
Jeśli jednak klient określi wartość elementu <published> podczas tworzenia lub edytowania wpisu, Blogger ustawi tę datę na określoną wartość. Może to być przydatne w przypadku takich zadań jak importowanie starych wpisów z innego systemu blogowania (z zachowaniem pierwotnych dat utworzenia).
Blogger używa standardowego elementu Atom <updated> do wskazania, kiedy wpis został ostatnio zmieniony. 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 aktualną godzinę serwera.
Za pomocą standardowych parametrów zapytania published-min, published-max, updated-min i updated-max interfejsu Google Data API możesz żądać wpisów na podstawie ich wartości <published> lub <updated>. Uwagi na temat zapytań dotyczących zaktualizowanych dat znajdziesz w dokumentacji parametrów zapytań Bloggera.
Łączenie komentarzy z postami
Format eksportu Bloggera obejmuje posty i komentarze w jednym dokumencie kanału Atom.
Do rozróżnienia tych 2 typów wpisów Blogger używa 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 należy, można wykonać za pomocą rozszerzenia Atom Threading. W poniższym przykładzie element <thr:in-reply-to> we wpisie komentarza wskazuje posta przy użyciu jego identyfikatora zawartego w parametrze ref. Link prowadzi też do adresu URL HTML posta za pomocą parametru href.
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/"
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 comment</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>
Odniesienie do schematu kanałów Bloggera
- Kanał z listą blogów
- Kanał postów na blogu
- Kanał komentarzy na blogu
- Kanał komentarzy do postów na blogu