Wichtig: Dies ist eine alte Version dieser Seite. Die neueste Version finden Sie über die Links in der linken Navigationsleiste.
Dieses Dokument enthält eine ausführliche Referenzdokumentation für das Rohprotokoll (XML und HTTP) der Blogger Data API.
Dieses Dokument enthält keine Informationen zu den Clientbibliotheken der Programmiersprachen. Referenzinformationen zu Clientbibliotheken finden Sie in den links in den programmsprachenspezifischen Abschnitten des Entwicklerleitfadens.
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 verstehen.
Blogger-Feedtypen
Blogger bietet zwei Darstellungen von Bloginhalten in Feeds: Vollfeeds und Zusammenfassungsfeeds. Ein vollständigen Feed enthält vollständige Blogbeiträge, während ein Feed mit Zusammenfassungen nur ein kurzes Snippet jedes Beitrags enthält.
Der Inhaber eines Blogs kann über die GUI-Einstellungen festlegen, ob der Blog Syndikaten und Aggregatoren einen vollständigen Feed oder einen Zusammenfassungsfeed zur Verfügung stellt.
Wenn Ihre Client-App eine nicht authentifizierte Anfrage für einen Feed sendet, erhält sie den vom Bloginhaber angegebenen Feedtyp.
Wenn deine Client-App jedoch eine authentifizierte Anfrage sendet, erhält sie 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 Standardabfrageparameter der Google Data API.
Blogger unterstützt die Parameter q (Textsuche) und author nicht.
Die Abfrageparameter updated-min und updated-max werden ignoriert, es sei denn, der Parameter orderby ist auf updated festgelegt. Mit der folgenden URL werden beispielsweise alle Blogbeiträge abgerufen, 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 zu Blogger-Elementen
Die Blogger Data API verwendet nur Standard-Atom-Elemente. Weitere Informationen finden Sie in der Spezifikation für das Atom-Synchronisierungsformat 1.0 und im Atom Publishing Protocol.
Im Rest dieses Abschnitts finden Sie einige Hinweise zur Verwendung einiger Standardelemente in Blogger.
Entwurfseinträge
Ein Blogeintrag im Entwurfsstatus wird mit dem Erweiterungselement <app:draft> gekennzeichnet, das im Atom Publishing Protocol-Dokument definiert ist. Hier 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.
Veröffentlichungs- und Aktualisierungsdaten
Der im standardmäßigen Atom-<published>-Element angegebene Zeitstempel entspricht dem „Datum des Beitrags“, das ein Nutzer in der Blogger-Benutzeroberfläche festlegen kann.
Wenn Ihr Kunde beim Erstellen eines neuen Eintrags keinen Wert für <published> angibt, setzt Blogger das Veröffentlichungsdatum des Eintrags auf die aktuelle Serverzeit. Wenn Ihr Kunde einen Eintrag bearbeitet, aber keinen <published>-Wert angibt, belässt Blogger das Veröffentlichungsdatum des Eintrags unverändert.
Wenn Ihr Kunde beim Erstellen oder Bearbeiten eines Eintrags jedoch einen Wert für das Element <published> angibt, wird das Veröffentlichungsdatum des Eintrags in Blogger auf den angegebenen Wert festgelegt. Das kann beispielsweise beim Importieren alter Einträge aus einem anderen Blogging-System hilfreich sein, wobei das ursprüngliche Erstellungsdatum beibehalten wird.
Blogger verwendet das standardmäßige Atom-Element <updated>, um anzugeben, wann ein Eintrag zuletzt geändert wurde. Der Wert <updated> kann nicht vom Client gesteuert werden. Blogger setzt das Datum der letzten Aktualisierung des Eintrags immer auf die aktuelle Serverzeit, wenn Ihr Client einen Eintrag veröffentlicht oder bearbeitet.
Sie können die Standardabfrageparameter der Google Data API published-min, published-max, updated-min und updated-max verwenden, um Einträge basierend auf ihren <published>- oder <updated>-Werten anzufordern. Hinweise zu Abfragen nach aktualisierten Datumsangaben findest du in der Referenz zu Blogger-Abfrageparametern.
Kommentare mit Beiträgen verknüpfen
Das Exportformat von Blogger enthält sowohl Beiträge als auch Kommentareinträge in einem Atom-Feeddokument.
Um zwischen den beiden Arten von Einträgen zu unterscheiden, verwendet Blogger das Element <atom:category>. Dieses Element hat einen term-Parameter, der angibt, ob es sich bei dem Eintrag um einen Beitrag oder einen Kommentar handelt.
Außerdem wird der Kommentareintrag mit dem zugehörigen Beitragseintrag über die Atom-Unterstützung für Threads verknüpft. Im folgenden Beispiel verweist das Element <thr:in-reply-to> im Kommentareintrag über die Beitragseintrags-ID im Parameter ref auf den Beitrag. 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/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>