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 detaillierte Referenzdokumentation für das Rohprotokoll. (XML und HTTP) für die Blogger Data API.
Dieses Dokument enthält keine Informationen zur Programmiersprache Clientbibliotheken. Referenzinformationen zur Clientbibliothek finden Sie unter den Links der Programmiersprachen-spezifischen Abschnitten 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 Entwicklerleitfaden vorgestellten Konzepte und die allgemeinen Ideen hinter dem Google Data APIs-Protokoll verstehen.
Blogger-Feedtypen
Blogger bietet zwei Darstellungen von Blog-Inhalten in Feeds: vollständige Feeds 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 mithilfe der GUI-Einstellungen festlegen, ob der Blog ein einem vollständigen Feed oder einem Zusammenfassungsfeed.
Wenn Ihre Client-App eine nicht authentifizierte Anfrage für einen Feed sendet, empfängt sie den Feedtyp, den der Blogeigentümer angegeben hat.
Wenn Ihre Client-App jedoch eine authentifizierte Anfrage sendet, erhält einen vollständigen Feed, unabhängig von den Angaben des Blogeigentümers.
Referenz zu Abfrageparametern für Blogger
Das Blogger Data API unterstützt fast alle standardmäßigen Google- Data API-Suchparameter
Blogger unterstützt nicht die q (Textsuche) und
author-Parameter.
Die Abfrageparameter updated-min und updated-max
werden ignoriert, sofern der Parameter orderby nicht auf
updated. Mit der folgenden URL werden beispielsweise alle
Posts, 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
Das Blogger Data API verwendet ausschließlich standardmäßige Atom-Elemente. finden Sie weitere Informationen sehen Sie sich die Atom Syndikationsformat 1.0 und das 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 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-<published> angegebene Zeitstempel
-Element entspricht dem "Beitragsdatum" die Nutzende im
Blogger-GUI.
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 Client einen Eintrag bearbeitet, aber keinen Wert angibt
<published> gibt, behält Blogger das Post-Datum des Eintrags bei.
allein.
Wenn Ihr Client jedoch einen Wert für das Attribut
<published>-Element beim Erstellen oder Bearbeiten eines Eintrags, dann
Blogger legt das Post-Datum des Eintrags auf den angegebenen Wert fest. 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
um anzuzeigen, 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 standardmäßige Google Data API published-min,
published-max, updated-min und
updated-max-Abfrageparameter verwenden, um Einträge basierend auf
<published>- oder <updated>-Werte. Sie können jedoch
Hinweise zur Abfrage aktualisierter Daten finden Sie unter Blogger
Referenz zu 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 die
<atom:category>-Element. Dieses Element hat ein
term-Parameter, der angibt, ob der Eintrag für einen Beitrag oder einen
Kommentar.
Außerdem wird der Kommentareintrag mit dem zugehörigen Beitragseintrag über die Atom-Unterstützung für Threads verknüpft. Im
Beispiel unten, das <thr:in-reply-to>-Element im Kommentar
verweist mithilfe der Beitrags-ID des Beitrags im
ref-Parameter. 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>