Wichtig: Dies ist eine alte Version dieser Seite. Die aktuelle Version erhalten Sie über die Links in der Navigationsleiste auf der linken Seite.
Dieses Dokument enthält eine detaillierte Referenzdokumentation für das Rohprotokoll (XML und HTTP) für die Blogger Data API.
Dieses Dokument enthält keine Informationen zu den Clientbibliotheken für Programmiersprachen. Referenzinformationen zur Clientbibliothek finden Sie unter den Links in den Abschnitten zu den einzelnen Programmiersprachen im Entwicklerhandbuch.
Inhalt
Zielgruppe
Dieses Dokument richtet sich an Programmierer, die Client-Anwendungen schreiben möchten, die mit Blogger interagieren können.
Es handelt sich um ein Referenzdokument. Es wird davon ausgegangen, dass Sie die im Entwicklerhandbuch vorgestellten Konzepte und die allgemeinen Konzepte hinter dem Google Data APIs-Protokoll verstehen.
Blogger-Feedtypen
Blogger bietet zwei Darstellungen von Bloginhalten in Feeds: vollständige Feeds und Zusammenfassungsfeeds. Ein vollständiger Feed enthält vollständige Blogposts, während ein Zusammenfassungsfeed nur einen kurzen Ausschnitt pro Post enthält.
Der Inhaber eines Blogs kann mithilfe der GUI-Einstellungen festlegen, ob der Blog einen vollständigen Feed oder einen Zusammenfassungsfeed für Syndikatoren und Aggregatoren bereitstellt.
Wenn Ihre Client-App eine nicht authentifizierte Anfrage für einen Feed sendet, empfängt sie den Feedtyp, den der Bloginhaber angegeben hat.
Wenn Ihre Clientanwendung jedoch eine authentifizierte Anfrage sendet, erhält sie unabhängig von den Angaben des Bloginhabers immer einen vollständigen Feed.
Referenz zu Abfrageparametern für Blogger
Die Blogger Data API unterstützt fast alle standardmäßigen Google Data API-Abfrageparameter.
Blogger unterstützt die Parameter q (Textsuche) und author nicht.
Die Abfrageparameter updated-min und updated-max werden ignoriert, sofern der Parameter orderby nicht auf updated festgelegt ist. Mit der folgenden URL werden beispielsweise alle Blogposts abgerufen, die zwischen dem 16. März 2008 und dem 24. März 2008 aktualisiert wurden:
http://www.blogger.com/feeds/blogID/posts/default?updated-min=2008-03-16T00:00:00&updated-max=2008-03-24T23:59:59&orderby=updated
Referenz zu Blogger-Elementen
Die Blogger Data API verwendet ausschließlich Atom-Standardelemente. Weitere Informationen findest du in der Syndikationsformatspezifikation für Atom 1.0 und im Atom Publishing Protocol.
Der Rest dieses Abschnitts enthält einige spezifische Hinweise zur Verwendung einiger Standardelemente in Blogger.
Entwurfseinträge
Ein Blogeintragsentwurf wird mit dem Erweiterungselement <app:draft> markiert, das im Atom Publishing Protocol-Dokument definiert ist. Hier ist ein Beispiel für einen Entwurfseintrag:
<entry xmlns:app='http://purl.org/atom/app#'> ... <app:control> <app:draft>yes</app:draft> </app:control> </entry>
Wenn kein <draft>-Element angegeben ist, ist der Eintrag kein Entwurf.
Erscheinungsdaten und aktualisierte Daten
Der im Standard-Atom-Element <published> angegebene Zeitstempel entspricht dem "Post date", das ein Nutzer auf der Blogger-GUI festlegen kann.
Wenn Ihr Client einen neuen Eintrag erstellt und der Client keinen Wert für <published> angibt, legt Blogger das Post-Datum des Eintrags auf die aktuelle Serverzeit fest. Wenn Ihr Client einen Eintrag bearbeitet, aber keinen <published>-Wert angibt, behält Blogger das Post-Datum des Eintrags bei.
Wenn Ihr Kunde jedoch beim Erstellen oder Bearbeiten eines Eintrags einen Wert für das Element <published> angibt, setzt Blogger das Post-Datum des Eintrags auf den angegebenen Wert. Dies kann für Aufgaben wie das Importieren alter Einträge aus einem anderen Blogging-System unter Beibehaltung der ursprünglichen Erstellungsdatum hilfreich sein.
Blogger verwendet das Standard-Atom-Element <updated>, um anzugeben, wann ein Eintrag zuletzt geändert wurde. Ihr Client kann den <updated>-Wert nicht steuern. Blogger legt das Datum der letzten Aktualisierung des Eintrags immer auf die aktuelle Serverzeit fest, wenn Ihr Kunde einen Eintrag postet oder bearbeitet.
Sie können die standardmäßigen published-min-, published-max-, updated-min- und updated-max-Abfrageparameter der Google Data API verwenden, um Einträge anhand ihrer <published>- oder <updated>-Werte anzufordern. Hinweise zur Abfrage von aktualisierten Datumsangaben finden Sie in der Referenz zu Blogger-Abfrageparametern.
Kommentare mit Beiträgen verknüpfen
Das Blogger-Exportformat enthält sowohl Posts als auch Kommentareinträge in einem Atom-Feeddokument.
Um zwischen den beiden Eintragstypen zu unterscheiden, verwendet Blogger das Element <atom:category>. Dieses Element hat einen term-Parameter, der angibt, ob der Eintrag für einen Beitrag oder einen Kommentar bestimmt ist.
Außerdem kann der Kommentareintrag mit dem Beitragseintrag, zu dem er gehört, über die Atom Threading Extension verknüpft werden. Im folgenden Beispiel verweist das Element <thr:in-reply-to> im Kommentareintrag mithilfe der ID des Beitrags im Parameter ref auf den Beitrag. Außerdem wird über den Parameter href eine Verknüpfung mit der HTML-URL des Beitrags hergestellt.
<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>