Wichtig: Der Support für die Google Data API 2.0 wird am 30. September 2024 eingestellt. Aktualisieren Sie Ihre Anwendungen, die auf Version 2.0 der Google Data API basieren, auf die neueste API-Version, damit sie weiterhin funktionieren. Die aktuelle Version findest du über die Links in der linken Navigationsleiste. Hinweis: Zwar werden einige GET-Anfragen (z. B. Listenbeiträge) weiterhin als Feed-URLs unterstützt, es gibt jedoch geringfügige Unterschiede in ihrem Verhalten. Weitere Informationen findest du in der Blogger-Hilfe.
Dieses Dokument enthält eine detaillierte Referenzdokumentation zum Rohprotokoll (XML und HTTP) für die Blogger Data API.
Dieses Dokument enthält keine Informationen zu den Clientbibliotheken in Programmiersprachen. Referenzinformationen zu Clientbibliotheken finden Sie unter den Links in den Abschnitten zu den einzelnen Programmiersprachen im Entwicklerhandbuch.
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 Entwicklerhandbuch aufgeführten Konzepte und die allgemeinen Konzepte des Google Data APIs-Protokolls verstehen.
Arten von Blogger-Feeds
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 jedes Posts enthält.
Der Inhaber eines Blogs kann mithilfe der GUI-Einstellungen festlegen, ob der Blog Syndikatoren und Aggregatoren einen vollständigen Feed oder einen Zusammenfassungsfeed zur Verfügung stellt.
Wenn Ihre Clientanwendung eine nicht authentifizierte Anfrage für einen Feed sendet, empfängt sie den vom Blogeigentümer angegebenen Feedtyp.
Wenn Ihre Client-App eine authentifizierte Anfrage sendet, erhält sie jedoch immer einen vollständigen Feed, unabhängig davon, was der Bloginhaber angegeben hat.
Referenz zu Blogger-Abfrageparametern
Die Blogger Data API unterstützt fast alle standardmäßigen Google Data API-Abfrageparameter.
Blogger unterstützt nicht den Parameter author.
Die Abfrageparameter updated-min und updated-max werden ignoriert, es sei denn, der Parameter orderby ist auf updated gesetzt. Die folgende URL ruft beispielsweise alle Blogposts ab, 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 Atom 1.0 und im Atom Publishing Protocol.
Der Rest dieses Abschnitts enthält einige spezifische Hinweise zur Verwendung einiger Standardelemente durch Blogger.
Entwurfseinträge
Ein Blogeintrag wird mit dem Erweiterungselement <app:draft> gekennzeichnet, das im Atom Publishing Protocol-Dokument definiert ist. Hier ist ein Beispiel für einen Entwurf:
<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 Daten
Der im Standard-Atom-Element <published> angegebene Zeitstempel entspricht dem "Post-Datum", das ein Nutzer in der Blogger-GUI festlegen kann.
Wenn Ihr Client einen neuen Eintrag erstellt und der Client keinen Wert für <published> angibt, legt Blogger das Veröffentlichungsdatum des Eintrags auf die aktuelle Serverzeit fest. Wenn Ihr Client einen Eintrag bearbeitet, aber keinen <published>-Wert angibt, bleibt das Veröffentlichungsdatum des Eintrags in Blogger unverändert.
Wenn Ihr Kunde jedoch beim Erstellen oder Bearbeiten eines Eintrags einen Wert für das Element <published> angibt, legt Blogger das Post-Datum des Eintrags auf den angegebenen Wert fest. Dies kann bei Aufgaben wie dem Importieren alter Einträge aus einem anderen Blogging-System unter Beibehaltung des ursprünglichen Erstellungsdatums nützlich sein.
Blogger verwendet das Standard-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 des Eintrags immer auf die aktuelle Serverzeit fest, wenn Ihr Client einen Eintrag postet oder bearbeitet.
Sie können die standardmäßigen Google Data API-Abfrageparameter published-min, published-max, updated-min und updated-max verwenden, um Einträge anhand ihrer <published>- oder <updated>-Werte anzufordern. Hinweise zum Abfragen von aktualisierten Datumsangaben finden Sie in der Referenz zu Blogger-Suchparametern.
Kommentare mit Beiträgen verknüpfen
Das Exportformat von Blogger enthält sowohl Posts als auch Kommentareinträge in einem Atom-Feed-Dokument.
Um zwischen den beiden Arten von Einträgen zu unterscheiden, verwendet Blogger das Element <atom:category>. Dieses Element hat den Parameter term, der angibt, ob der Eintrag für einen Beitrag oder Kommentar bestimmt ist.
Darüber hinaus wird der Kommentareintrag über die Atom-Threading-Erweiterung mit dem Beitrag verknüpft, zu dem er gehört. Im folgenden Beispiel verweist das Element <thr:in-reply-to> im Kommentareintrag auf den Beitrag. Dazu wird die Beitrags-ID im Parameter ref verwendet. Außerdem wird über den Parameter href eine Verknüpfung zur HTML-URL des Beitrags hergestellt.
<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>