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 Programmiersprachen-Clientbibliotheken. Referenzinformationen zu Clientbibliotheken finden Sie in den Links aus den Abschnitten zu den Programmiersprachen im Entwicklerleitfaden.
Inhalt
Zielgruppe
Dieses Dokument richtet sich an Programmierer, die Clientanwendungen schreiben möchten, die mit Blogger interagieren können.
Es ist ein Referenzdokument. Es wird davon ausgegangen, dass Sie die im Entwicklerleitfaden vorgestellten Konzepte und die allgemeinen Ideen hinter dem Google Data APIs-Protokoll kennen.
Blogger-Feedtypen
Blogger bietet zwei Darstellungen von Bloginhalten in Feeds: vollständige Feeds und Übersichtsfeeds. Ein vollständiger Feed enthält vollständige Blogposts, während ein zusammenfassender Feed nur einen kurzen Ausschnitt jedes Posts enthält.
Der Inhaber eines Blogs kann in den GUI-Einstellungen angeben, ob er den Syndikationen und Aggregatoren einen vollständigen Feed oder einen Zusammenfassungsfeed zur Verfügung stellen soll.
Wenn deine Client-App eine nicht authentifizierte Anfrage für einen Feed sendet, erhält sie den Feedtyp, der vom Bloginhaber angegeben wurde.
Wenn Ihre Client-App jedoch eine authentifizierte Anfrage sendet, erhält sie immer einen vollständigen Feed, unabhängig davon, was der Bloginhaber angegeben hat.
Referenz für Blogger-Abfrageparameter
Die Blogger Data API unterstützt fast alle standardmäßigen Google Data API-Abfrageparameter.
Blogger unterstützt den Parameter author nicht.
Die Abfrageparameter updated-min und updated-max werden ignoriert, sofern der Parameter orderby nicht auf updated festgelegt ist. Die folgende URL ruft beispielsweise alle Blogposts ab, die vom 16. März 2008 bis zum 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 für Blogger-Elemente
Die Blogger Data API verwendet nur standardmäßige Atom-Elemente. Weitere Informationen findest du in den Spezifikationen zur Syndikationsformat Atom 1.0 und im Atom Publishing Protocol.
Der Rest dieses Abschnitts enthält einige spezifische Hinweise zur Verwendung einiger Standardelemente von Blogger.
Entwurfseinträge
Ein Blogentwurf wird mit dem Erweiterungselement <app:draft> markiert, das im Dokument zum Atom Publishing Protocol definiert ist. Hier ein Beispiel für einen Entwurfseintrag:
<entry xmlns:app='http://www.w3.org/2007/app'> ... <app:control> <app:draft>yes</app:draft> </app:control> </entry>
Wenn kein <draft>-Element angegeben ist, ist der Eintrag kein Entwurf.
Veröffentlichungsdaten und aktualisierte Datumsangaben
Der im Atom-Standardelement <published> angegebene Zeitstempel entspricht dem POST-Datum, das ein Nutzer in der Blogger-Benutzeroberfläche festlegen kann.
Wenn Ihr Client einen neuen Eintrag erstellt und der Client keinen Wert für <published> angibt, legt Blogger das Beitragsdatum des Eintrags auf die aktuelle Serverzeit fest. Wenn dein Client einen Eintrag bearbeitet, aber keinen <published>-Wert angibt, lässt Blogger das Veröffentlichungsdatum des Eintrags unverändert.
Wenn dein Client jedoch beim Erstellen oder Bearbeiten eines Eintrags einen Wert für das Element <published> angibt, legt Blogger das Beitragsdatum des Eintrags auf den angegebenen Wert fest. Dies kann für Aufgaben wie das Importieren alter Einträge aus einem anderen Blogsystem unter Beibehaltung der ursprünglichen Erstellungsdatumstermine nützlich sein.
Blogger verwendet das standardmäßige Atom-Element <updated>, um anzugeben, wann ein Eintrag zuletzt geändert wurde. Ihr Client kann den Wert <updated> nicht steuern. Blogger legt das Datum der letzten Aktualisierung immer auf die aktuelle Serverzeit fest, wenn Ihr Client einen Eintrag postet oder bearbeitet.
Sie können die Standard-Abfrageparameter published-min, published-max, updated-min und updated-max der Google Data API verwenden, um Einträge auf der Grundlage ihrer <published>- oder <updated>-Werte anzufordern. Hinweise zu Abfragen an aktualisierten Daten finden Sie in der Referenz zu Blogger-Abfrageparametern.
Kommentare mit Beiträgen verknüpfen
Das Exportformat von Blogger enthält sowohl Posts als auch Kommentareinträge in einem Atom-Feed-Dokument.
Damit zwischen den beiden Arten von Einträgen unterschieden werden kann, verwendet Blogger das Element <atom:category>. Dieses Element hat den Parameter term, der angibt, ob der Eintrag für einen Beitrag oder einen Kommentar gilt.
Die Verknüpfung des Kommentareintrags mit dem Beitragseintrag wird außerdem mithilfe der Atom-Threading-Erweiterung abgeschlossen. Im folgenden Beispiel verweist das Element <thr:in-reply-to> im Kommentareintrag auf den Beitrag. Dazu wird die Parameter des Beitragseintrags im Parameter ref verwendet. Außerdem wird über den Parameter href auf die HTML-URL des Beitrags verwiesen.
<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 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>