Wichtig: Dies ist eine alte Version dieser Seite. Die neueste Version finden Sie über die Links in der linken Navigationsleiste.
Mit der Blogger Data API können Client-Anwendungen Blogger-Inhalte aufrufen und aktualisieren. in Form von Google Data API-Feeds.
Ihre Client-Anwendung kann mithilfe der Blogger Data API einen neuen Blog erstellen. Posts bearbeiten oder löschen und Blogposts abfragen, die mit der Suchanfrage übereinstimmen. Kriterien erfüllen.
Zusätzlich zu einigen Hintergrundinformationen zu den Funktionen von Blogger Data API enthält, enthält dieses Dokument Beispiele für grundlegende Data API-Interaktionen mithilfe von XML- und HTTP-Rohdaten. Wenn Sie nach dem Lesen dieses Dokuments mehr über die Interaktion mit der API über unsere Clientbibliotheken erfahren möchten, lesen Sie die sprachspezifischen Abschnitte dieses Entwicklerhandbuchs.
Inhalt
Zielgruppe
Dieses Dokument richtet sich an Programmierer, Anwendungen, die über XML und HTTP mit Blogger interagieren können.
In diesem Dokument wird davon ausgegangen, dass Sie mit den allgemeinen Konzepten des Google Data APIs-Protokolls vertraut sind.
Wenn Sie ein UNIX-System verwenden und die Beispiele in diesem
ohne Code schreiben zu müssen, finden Sie die
Befehlszeilendienstprogramme von UNIX
curl
oder wget
nützlich; finden Sie in der
Seiten für diese Dienstprogramme.
Referenzinformationen zur Blogger Data API finden Sie im Leitfaden zu Protokollen.
Erste Schritte
Erstellen eines Blogger-Kontos
Sie können sich für ein Blogger-Konto zu Testzwecken. Blogger verwendet Google-Konten. Wenn Sie also bereits ein Google-Konto haben, sind Sie startklar.
Beim Blogger-Dienst authentifizieren
Mit der Blogger Data API können Sie sowohl auf öffentliche als auch auf private Feeds zugreifen. Für öffentliche Feeds ist keine Authentifizierung erforderlich, sie sind jedoch nur lesbar. Wenn du Blogs ändern möchtest, muss sich dein Client authentifizieren, bevor er private Feeds anfordert. Die Authentifizierung kann mit einem der beiden folgenden Ansätze erfolgen: AuthSub-Proxy-Authentifizierung oder ClientLogin-Nutzername/Passwort-Authentifizierung.
Weitere Informationen zur Authentifizierung mit Google Data APIs finden Sie in der Authentifizierungsdokumentation.
Bei den meisten Beispielen in den nachfolgenden Abschnitten dieses Dokuments wird davon ausgegangen, mit der entsprechenden Authentifizierung.
AuthSub-Proxy-Authentifizierung
Die AuthSub-Proxy-Authentifizierung wird von Webanwendungen verwendet, die ihre Nutzer bei Google-Konten zu authentifizieren. Der Website-Betreiber und der Clientcode haben keinen Zugriff auf den Nutzernamen und das Passwort des Blogger-Nutzers. Stattdessen erhält der Client spezielle AuthSub-Tokens, mit denen er im Namen eines bestimmten Nutzers handeln kann. Weitere Informationen finden Sie in der AuthSub-Dokumentation.
Wenn ein Nutzer Ihre Anwendung zum ersten Mal besucht, wurde er noch nicht authentifiziert. In diesem Fall müssen Sie einige Informationen und einen Link anzeigen, über den der Nutzer zu einer Google-Seite weitergeleitet wird, um Ihre Anfrage auf Zugriff auf seine Blogs zu authentifizieren.
Die folgenden Abfrageparameter sind in der AuthSubRequest-URL enthalten:
- Weiter
- Die URL der Seite, auf die Google den Nutzer nach der Authentifizierung weiterleiten soll.
- Bereich
- Gibt an, dass die Anwendung ein Token für den Zugriff auf Blogger-Feeds anfordert. Der zu verwendende Bereichsstring ist
http://www.blogger.com/feeds/
(natürlich URL-codiert). - sicher
- Gibt an, ob der Client ein sicheres Token anfordert.
- Sitzung
- Gibt an, ob das zurückgegebene Token gegen ein wiederverwendbares Sitzungstoken eingetauscht werden kann.
Die AuthSubRequest-URL könnte wie folgt aussehen:
https://www.google.com/accounts/AuthSubRequest?scope=http%3A%2F%2Fwww.blogger.com%2Ffeeds%2F&session=1&secure=0&next=http%3A%2F%2Fwww.example.com%2Fwelcome.html
Der Nutzer folgt dem Link zur Google-Website und authentifiziert sich in seinem Google-Konto.
Nach der Authentifizierung des Nutzers leitet das AuthSub-System ihn an die URL weiter.
den Sie im Abfrageparameter next
der AuthSubRequest angegeben haben
URL Das AuthSub-System hängt dieser URL ein Authentifizierungstoken als Wert des Abfrageparameters token
an. Beispiel:
http://www.example.com/welcome.html?token=yourAuthToken
Dieser Tokenwert stellt ein AuthSub-Einweg-Token dar. Da in diesem Beispiel session=1
angegeben wurde, kann dieses Token gegen ein AuthSub-Sitzungstoken eingetauscht werden. Dazu wird der Dienst AuthSubSessionToken
mit dem Einmaltoken in einem Autorisierungsheader aufgerufen:
GET /accounts/AuthSubSessionToken HTTP/1.1 Content-Type: application/x-www-form-urlencoded Authorization: AuthSub token="yourAuthToken" User-Agent: Java/1.5.0_06 Host: www.google.com Accept: text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2 Connection: keep-alive
Die Antwort des AuthSubSessionToken-Dienstes enthält einen Token
-Header
die das Sitzungstoken und einen Expiration
-Header enthält,
gibt an, wie lange das Token gültig ist.
Ihre Anwendung kann dann den Wert des Sitzungstokens im
Authorization
-Header nachfolgender Interaktionen mit Blogger.
Hier ist ein Beispiel für eine HTTP-Anfrage mit einem nicht sicheren Token, die Sie an Blogger senden könnten:
GET /feeds/blogID/blogs/posts/defaults HTTP/1.1 Content-Type: application/x-www-form-urlencoded Authorization: AuthSub token="yourSessionToken" User-Agent: Java/1.5.0_06 Host: www.blogger.com Accept: text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2 Connection: keep-alive
ClientLogin-Authentifizierung mit Nutzername/Passwort
Verwenden Sie die ClientLogin-Authentifizierung, wenn es sich bei Ihrem Client um einen eigenständigen, für einen einzelnen Nutzer installierten Client handelt (z. B. eine Desktopanwendung). So fordern Sie eine
Authentifizierungstoken mithilfe des ClientLogin-Mechanismus ein, POST
an die folgende URL senden:
https://www.google.com/accounts/ClientLogin
Der POST
-Text sollte eine Reihe von Abfrageparametern enthalten, die wie Parameter aussehen, die über ein HTML-Formular übergeben werden, und den Inhaltstyp application/x-www-form-urlencoded
verwenden. Diese Parameter sind:
- E-Mail-Adresse des Nutzers
- Passwd
- Das Passwort des Nutzers.
- Dienst
- Der Name des Blogger-Dienstes lautet
blogger
. Eine Liste anderer Dienstnamen finden Sie in der Liste der Dienstnamen. - accountType
- Dieser Wert sollte bei Verwendung der Blogger API immer auf
GOOGLE
festgelegt sein. Wenn Sie diesen Parameter nicht festlegen, wird der Zugriff für Nutzer verhindert, die auch ein G Suite-Konto haben. - source
- Damit wird Ihre Clientanwendung gekennzeichnet. Muss das Format companyName-applicationName-versionID haben. In den Beispielen wird der Name
exampleCo-exampleApp-1
verwendet.
Weitere Informationen zu den Parametern finden Sie im Dokument Authentifizierung für installierte Anwendungen.
Schlägt die Authentifizierungsanfrage fehl, gibt der Server eine HTTP-
403 Forbidden
-Statuscode.
Ist dies erfolgreich, gibt der Server den HTTP-Status 200 OK
zurück.
sowie drei lange alphanumerische Codes im Text der Antwort: SID, LSID,
und Auth. Der Auth-Wert ist das Autorisierungstoken, das Sie an Blogger senden.
mit jeder nachfolgenden Anfrage zu verknüpfen.
Bewahren Sie daher eine Kopie dieses Werts auf. Sie können
die SID- und LSID-Werte ignorieren.
Da alle Anfragen an private Feeds eine Authentifizierung erfordern, müssen Sie Authorization-Header bei allen nachfolgenden Interaktionen mit Blogger unter Verwendung des folgendes Format:
Authorization: GoogleLogin auth=yourAuthToken
Dabei ist yourAuthToken
der Auth-String, der vom
ClientLogin-Anfrage.
Weitere Informationen zur ClientLogin-Authentifizierung, einschließlich Beispiel -Anfragen und -Antworten, siehe Authentifizierung für installierte Dokumentation zu Anwendungen.
Hinweis: Verwenden Sie für alle Anfragen in einem in einer bestimmten Sitzung; erhalten Sie nicht für jede Blogger-Anfrage ein neues Token.
Hinweis: Wie auf der Seite „ClientLogin“
kann die Authentifizierungsanfrage fehlschlagen und ein CAPTCHA anfordern.
Herausforderung. Wenn Google die CAPTCHA-Abfrage ausführen und verarbeiten soll,
den Nutzer an
https://www.google.com/accounts/DisplayUnlockCaptcha?service=blogger
(anstatt der CAPTCHA-URL, die im ClientLogin angegeben wird,
Dokumentation.
Liste mit Blogs abrufen
Das Blogger Data API bietet einen Feed, in dem die Blogs für eine bestimmte user; wird dieser Feed als „Metafeed“ bezeichnet.
Senden Sie eine HTTP-GET
-Anfrage an die folgende URL, um die Liste der Blogs abzurufen:
http://www.blogger.com/feeds/userID/blogs
Hinweis: Sie können auch default
anstelle der Nutzer-ID angeben. In diesem Fall gibt Blogger die Liste der Blogs für den Nutzer zurück, dessen Anmeldedaten mit der Anfrage gesendet wurden.
Ein Eintrag im Metafeed könnte wie folgt aussehen:
<entry> <id>tag:blogger.com,1999:blog-blogID.post-postID</id> <published>2006-08-02T18:44:43.089-07:00</published> <updated>2006-11-08T18:10:23.020-08:00</updated> <title type='text'>Lizzy's Diary</title> <summary type='html'>Being the journal of Elizabeth Bennet</summary> <link rel='alternate' type='text/html' href='http://blogName.blogspot.com/'> </link> <link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='http://blogName.blogspot.com/feeds/posts/default'> </link> <link rel='http://schemas.google.com/g/2005#post' type='application/atom+xml' href='http://www.blogger.com/feeds/blogID/posts/default'> </link> <link rel='self' type='application/atom+xml' href='http://www.blogger.com/feeds/userID/blogs/blogID'> </link> <link rel='edit' type='application/atom+xml' href='http://www.blogger.com/feeds/userID/blogs/blogID'> </link> <author> <name>Elizabeth Bennet</name> <email>noreply@blogger.com</email> <uri>http://www.blogger.com/profile/profileID</uri> </author> </entry>
Informationen zur Bedeutung der einzelnen Elemente erhalten Sie in den Google- Data API Protocol Reference (Referenzdokument für das Data API-Protokoll) oder im Atom-Dokument“ 1.0-Spezifikation.
Wenn Ihre Anfrage aus irgendeinem Grund fehlschlägt, gibt Blogger möglicherweise einen anderen Status zurück Code. Weitere Informationen zu HTTP-Statuscodes finden Sie auch im Dokument Google Data APIs Protocol Reference (Referenz zum Google Data APIs-Protokoll).
Beiträge werden erstellt
Mit der Blogger Data API können Sie neue Blog-Einträge erstellen und veröffentlichen, sowie Entwürfe von Einträgen zu erstellen.
Blogposts veröffentlichen
Nach der Authentifizierung können Sie neue Blogbeiträge veröffentlichen.
Erstellen Sie zuerst eine XML-Darstellung des zu veröffentlichenden Beitrags. Diese XML-Datei muss in Form eines Atom-<entry>
-Elements vorliegen. Das könnte so aussehen:
<entry xmlns='http://www.w3.org/2005/Atom'> <title type='text'>Marriage!</title> <content type='xhtml'> <div xmlns="http://www.w3.org/1999/xhtml"> <p>Mr. Darcy has <em>proposed marriage</em> to me!</p> <p>He is the last man on earth I would ever desire to marry.</p> <p>Whatever shall I do?</p> </div> </content> <category scheme="http://www.blogger.com/atom/ns#" term="marriage" /> <category scheme="http://www.blogger.com/atom/ns#" term="Mr. Darcy" /> </entry>
Hinweis: Das Festlegen eines benutzerdefinierten Autors für Beiträge ist wird derzeit nicht unterstützt. Alle neuen Beiträge werden so angezeigt, als wären sie von den aktuell authentifizierten Nutzer.
Wenn Sie diesen Eintrag veröffentlichen möchten, senden Sie ihn wie unten beschrieben an die Post-URL des Blogs. Erstens:
platzieren Sie Ihr Atom-Element <entry>
im Textkörper eines neuen
POST
-Anfrage mit dem Inhalt „application/atom+xml
“
Typ. Suche dann im Metafeed nach der Beitrags-URL des Blogs. Sie findest sie im <link>
-Element, in dem das rel
-Attribut auf #post
endet. Die URL des Blogposts wird als href
-Attribut dieses Elements angegeben. Sie hat folgendes Format:
http://www.blogger.com/feeds/blogID/posts/default
Hinweis: Diese URL ist mit der URL im
<link rel="service.post">
-Tag im
<head>
der visuell lesbaren Version des
-Blog.
Blogger erstellt einen Blogpost mit dem von Ihnen gesendeten Eintrag und gibt dann einen HTTP-201 CREATED
-Statuscode sowie eine Kopie des neuen Beitrags in Form eines <entry>
-Elements zurück. Der zurückgegebene Eintrag ist derselbe, den Sie gesendet haben, enthält aber auch verschiedene von Blogger hinzugefügte Elemente, z. B. ein <id>
-Element.
Wenn Ihre Anfrage aus irgendeinem Grund fehlschlägt, gibt Blogger möglicherweise einen anderen Status zurück Code. Informationen zu den Statuscodes finden Sie im Artikel Google-Daten Referenzdokument zum API-Protokoll.
Entwurf eines Blogposts wird erstellt
Entwurfsposts werden auf die gleiche Weise wie öffentliche Beiträge erstellt. Dem Eintrag wird jedoch ein <app:control>
-Element hinzugefügt, das angibt, dass der Beitrag (noch) nicht veröffentlicht werden soll.
Dieses <app:control>
-Element sollte nur
<app:draft>
-Element als untergeordnetes Element:
<app:control xmlns:app='http://purl.org/atom/app#'> <app:draft>yes</app:draft> </app:control>
Bei den im <app:draft>
-Element enthaltenen Daten muss es sich um Folgendes handeln:
yes eingeben, damit der Beitrag als Entwurf erkannt wird.
Sie können einen vorhandenen Blogpost-Entwurf in einen veröffentlichten Post umwandeln, indem Sie den Entwurf abrufen, die Daten des Elements <app:draft>
auf den String no festlegen und den Post dann aktualisieren. Beiträge abrufen und aktualisieren
werden in den nächsten beiden
Abschnitten behandelt.
Hinweis: Weitere Informationen zum Atom-
Veröffentlichungsprotokoll, einschließlich <app:control>
und
<app:draft>
-Namespaces, siehe RFC 5023.
Beiträge abrufen
In den folgenden Abschnitten wird beschrieben, wie Sie eine Liste von Blogposts abrufen. und ohne Suchparameter.
Sie können einen öffentlichen Blogger-Feed ohne Authentifizierung abfragen. Daher sehen Sie brauchen Sie den Autorisierungsparameter nicht festzulegen, wenn Sie Blog-Posts von öffentlich zugänglichen Blog.
Alle Blogposts werden abgerufen
Um die Beiträge des Nutzers abzurufen, sende eine HTTP-GET
-Anfrage an den
Feed-URL des Blogs an. Blogger gibt dann einen Feed zurück, der den entsprechenden Blog enthält.
Einträge. Um beispielsweise eine Liste mit Blogposts für liz@gmail.com zu erhalten, senden Sie den
HTTP-Anfrage an Blogger (mit dem entsprechenden Wert anstelle
blogID
:
GET http://www.blogger.com/feeds/blogID/posts/default
Blogger gibt dann den HTTP-Statuscode 200 OK
und einen Standard-
Atom 1.0-Feed mit den Blogposts
Im folgenden Beispiel wird ein Feed für einen Blog mit nur einem Beitrag gezeigt. Beachten Sie, dass wir dieses Beispiel leicht bearbeitet haben, damit es für Menschen leichter lesbar ist. Ein echter Blogger-Feed enthält insbesondere tatsächliche IDs und URLs.
<feed xmlns='http://www.w3.org/2005/Atom'> <id>tag:blogger.com,1999:blog-blogID</id> <updated>2006-11-08T18:10:23.020-08:00</updated> <title type='text'>Lizzy's Diary</title> <link rel='alternate' type='text/html' href='http://blogName.blogspot.com/index.html'> </link> <link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='http://blogName.blogspot.com/feeds/posts/default'> </link> <link rel='self' type='application/atom+xml' href='http://blogName.blogspot.com/feeds/posts/default'> </link> <author> <name>Elizabeth Bennet</name> <email>noreply@blogger.com</email> <uri>http://www.blogger.com/profile/profileID</uri> </author> <generator version='7.00' uri='http://www2.blogger.com'>Blogger</generator> <entry> <id>tag:blogger.com,1999:blog-blogID.post-postID</id> <published>2006-11-08T18:10:00.000-08:00</published> <updated>2006-11-08T18:10:14.954-08:00</updated> <title type='text'>Quite disagreeable</title> <content type='html'><p>I met Mr. Bingley's friend Mr. Darcy this evening. I found him quite disagreeable.</p></content> <link rel='alternate' type='text/html' href='http://blogName.blogspot.com/2006/11/quite-disagreeable.html'> </link> <link rel='self' type='application/atom+xml' href='http://blogName.blogspot.com/feeds/posts/default/postID'> </link> <link rel='edit' type='application/atom+xml' href='http://www.blogger.com/feeds/blogID/posts/default/postID'> </link> <author> <name>Elizabeth Bennet</name> <email>noreply@blogger.com</email> <uri>http://www.blogger.com/profile/profileID</uri> </author> </entry> </feed>
Beiträge mithilfe von Suchparametern abrufen
Mit der Blogger Data API können Sie eine Reihe von Einträgen anfordern, die bestimmten Kriterien entsprechen. So können Sie beispielsweise Blogbeiträge anfordern, die in einem bestimmten Zeitraum veröffentlicht oder aktualisiert wurden.
Wenn Sie beispielsweise eine Zeitraumabfrage senden möchten, fügen Sie den Parameter published-min
hinzu.
und published-max
an die Anfrage-URL an. Wenn Sie alle Blogeinträge abrufen möchten, die zwischen dem 16. März 2008 und dem 24. März 2008 erstellt wurden, senden Sie eine HTTP-Anfrage an die Feed-URL des Blogs:
GET http://www.blogger.com/feeds/blogID/posts/default?published-min=2008-03-16T00:00:00&published-max=2008-03-24T23:59:59
Wenn du diese GET
-Anfrage sendest, gibt Blogger eine HTTP-
200 OK
-Statuscode und einem Feed mit Blogposts, die zuvor
die im angegebenen Zeitraum erstellt wurden.
Mit den Parametern updated-min
und updated-max
können Sie auch alle Blogbeiträge abrufen, die in einem bestimmten Zeitraum aktualisiert wurden. Beachten Sie jedoch, dass diese Parameter ignoriert werden, es sei denn, der Parameter orderby
ist ebenfalls auf updated
gesetzt.
Die Blogger Data API unterstützt die folgenden Abfrageparameter:
- alt
- Der Typ des zurückzugebenden Feeds, z. B.
atom
(Standard) oderrss
. - /category
- Gibt Kategorien (auch als Labels bezeichnet) an, um die Feedergebnisse zu filtern. Beispielsweise gibt
http://www.blogger.com/feeds/blogID/posts/default/-/Fritz/Laurie
Einträge mit den beiden LabelsFritz
undLaurie
zurück. - max-results
- Die maximale Anzahl der zurückzugebenden Einträge.
- Orderby
- Die Reihenfolge, in der Einträge zurückgegeben werden sollen, z. B.
lastmodified
(Standardeinstellung),starttime
oderupdated
. - Publish-Min., Publish-Max.
- Die Grenzen der Veröffentlichungsdaten des Eintrags.
- start-index
- Der 1-basierte Index des ersten abzurufenden Ergebnisses (für die Seitenordnung).
- updated-min, updated-max
- Die Grenzen für die Datumsangaben der Eintragsaktualisierungen. Diese Suchparameter werden ignoriert, sofern der Parameter
orderby
nicht aufupdated
festgelegt ist.
Weitere Informationen zu Abfrageparametern findest du im Referenzleitfaden für die Blogger Data API und im Referenzleitfaden für Google Data APIs.
Beiträge aktualisieren
Um einen vorhandenen Blogpost zu aktualisieren, rufen Sie zuerst den Eintrag ab, den Sie
aktualisieren, ändern Sie sie und senden dann eine PUT
-Anfrage mit
den aktualisierten Eintrag im Nachrichtentext
an die Bearbeitungs-URL des Beitrags an. Achten Sie darauf, dass der
<id>
-Wert in dem Eintrag, mit dem Sie PUT
genau übereinstimmen
Den <id>
des vorhandenen Eintrags.
Die Bearbeitungs-URL wird im folgenden Eintrag hervorgehoben:
<entry> <id>tag:blogger.com,1999:blog-blogID.post-postID</id> <published>2006-11-08T18:10:00.000-08:00</published> <updated>2006-11-08T18:10:14.954-08:00</updated> <title type='text'>Quite disagreeable</title> <content type='html'><p>I met Mr. Bingley's friend Mr. Darcy this evening. I found him quite disagreeable.</p></content> <link rel='alternate' type='text/html' href='http://blogName.blogspot.com/2006/11/quite-disagreeable.html'> </link> <link rel='self' type='application/atom+xml' href='http://blogName.blogspot.com/feeds/posts/default/postID'> </link> <link rel='edit' type='application/atom+xml' href='http://www.blogger.com/feeds/blogID/posts/default/postID'> </link> <category scheme="http://www.blogger.com/atom/ns#" term="Mr. Bingley" /> <category scheme="http://www.blogger.com/atom/ns#" term="Mr. Darcy" /> <author> <name>Elizabeth Bennet</name> <email>noreply@blogger.com</email> <uri>http://www.blogger.com/profile/profileID</uri> </author> </entry>
WICHTIG: Um die Aufwärtskompatibilität sicherzustellen,
dass bei PUT
aktualisierten Einträgen alle
Die XML-Datei, die beim Abrufen des Eintrags aus Blogger vorhanden war. Andernfalls
wenn wir neue Elemente implementieren und <new-awesome-feature>
-Elemente im Feed enthält, gibt Ihr Kunde sie nicht zurück und die Nutzer
aus. Die Google
Data API-Clientbibliotheken verarbeiten dies alle korrekt. Wenn Sie
einer der fertigen Bibliotheken.
Hinweis: Wenn Sie die Autorendaten ändern, die mit Posts werden derzeit nicht unterstützt.
Tipp zur Fehlerbehebung: Einige Firewalls blockieren HTTP-PUT
-Nachrichten. Um dies zu umgehen, können Sie
X-HTTP-Method-Override: PUT
-Header in einer POST
-Anfrage.
Weitere Informationen finden Sie im Dokument Grundlagen des Google Data API-Protokolls.
Beiträge werden gelöscht
Wenn du einen Beitrag löschen möchtest, sende eine DELETE
-Anfrage an die Bearbeitungs-URL des Beitrags.
Dies ist dieselbe URL, die zum Aktualisieren von Beiträgen verwendet wird.
Tipp zur Fehlerbehebung: Einige Firewalls blockieren HTTP.
DELETE
Nachrichten. Um dies zu umgehen, können Sie einen X-HTTP-Method-Override: DELETE
-Header in eine POST
-Anfrage einfügen. Einzelheiten finden Sie unter Google Data API
Dokument zu den Protokollgrundlagen.
Kommentare
Mit der Blogger Data API können Sie Kommentare erstellen, abrufen und löschen. Das Aktualisieren von Kommentaren wird nicht unterstützt und ist auch nicht im Web verfügbar .
Kommentare erstellen
Um einen Kommentar zu posten, erstelle ein Atom-<entry>
-Element wie das
Folgendes:
<entry xmlns='http://www.w3.org/2005/Atom'> <title type="text">This is my first comment</title> <content type="html">This is my first comment</content> </entry>
Platziere dein Atom-Element <entry>
, um diesen Kommentar zu veröffentlichen
im Text einer neuen POST
-Anfrage mithilfe der Methode
Inhaltstyp application/atom+xml
. Sende dann die POST
an die entsprechende Blogger-URL senden:
POST http://www.blogger.com/feeds/blogID/postID/comments/default
Hinweis: Derzeit können Sie nur Kommentare in einem Blog posten, dessen Inhaber der authentifizierte Nutzer ist.
Hinweis: Das Festlegen eines benutzerdefinierten Autors für Kommentare ist wird derzeit nicht unterstützt. Alle neuen Kommentare werden so angezeigt, als wären sie vom aktuell authentifizierten Nutzer erstellt worden.
Kommentare abrufen
Sie können die Kommentare für einen bestimmten Post abrufen, indem Sie eine
GET
an die Kommentarfeed-URL dieses Beitrags:
GET http://www.blogger.com/feeds/blogID/postID/comments/default
Sie können auch die Kommentare zu allen Posts über den Kommentarfeed des Blogs abrufen. URL:
GET http://www.blogger.com/feeds/blogID/comments/default
Diese Anfragen geben einen Kommentarfeed zurück, der so aussieht:
<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"> <id>tag:blogger.com,1999:blog-blogID.post-postID.comment-commentID</id> <updated>2007-04-04T21:56:29.803-07:00</updated> <title type="text">My Blog : Time to relax</title> <link rel="alternate" type="text/html" href="http://blogName.blogspot.com/2007/04/first-post.html"/> <link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="http://blogName.blogspot.com/feeds/postID/comments/default"/> <link rel="self" type="application/atom+xml" href="http://blogName.blogspot.com/feeds/postID/comments/default"/> <author> <name>Blog Author name</name> </author> <generator version="7.00" uri="http://www2.blogger.com">Blogger</generator> <openSearch:totalResults>1</openSearch:totalResults> <openSearch:startIndex>1</openSearch:startIndex> <entry> <id>tag:blogger.com,1999:blog-blogID.post-commentID</id> <published>2007-04-04T21:56:00.000-07:00</published> <updated>2007-04-04T21:56:29.803-07:00</updated> <title type="text">This is my first comment</title> <content type="html">This is my first comment</content> <link rel="alternate" type="text/html" href="http://blogName.blogspot.com/2007/04/first-post.html#commentID"/> <link rel="self" type="application/atom+xml" href="http://blogName.blogspot.com/feeds/postID/comments/default/commentID"/> <link rel="edit" type="application/atom+xml" href="http://www.blogger.com/feeds/blogID/postID/comments/default/commentID"/> <thr:in-reply-to href="http://blogName.blogspot.com/2007/04/first-post.html" ref="tag:blogger.com,1999:blog-blogID.post-postID" source="http://www.blogger.com/feeds/posts/default/blogID" type="text/html"/> <author> <name>Blog Author name</name> <email>blog_author@gmail.com</email> <uri>http://www.blogger.com/profile/userID</uri> </author> <thr:in-reply-to xmlns:thr='http://purl.org/syndication/thread/1.0' href='http://blogName.blogspot.com/2007/04/first-post.html' ref='tag:blogger.com,1999:blog-blogID.post-postID' source='http://blogName.blogspot.com/feeds/posts/default/postID' type='text/html' /> </entry> </feed>
Kommentare werden gelöscht
Wenn du einen Kommentar löschen möchtest, sende eine DELETE
-Anfrage zur Änderung des Kommentars
URL Diese URL wird im Kommentarfeed oben hervorgehoben.
Exportformat
Mit Blogger können Nutzer ihre Blogs mit einer Blogger-Exportdatei exportieren und importieren. Diese Exportdatei enthält alle Posts und Kommentare für einen Blog. Das Format der Exportdatei ist genau das Atom-Format, das in den Abschnitten zum Abrufen von Beiträgen und Kommentaren beschrieben wird. Diese Exportdatei enthält die Inhalte des Beitragsfeeds und die Inhalte des Kommentarfeeds zusammen in einem Dokument zusammen.
Um Blogdaten mit dem Exportformat zu exportieren oder zu importieren, besuchen Sie die Seite Einstellungen für den Blog. Um die Exportdatei für eine Blog mit der Data API verwenden, verwenden Sie die folgende URL:
GET http://www.blogger.com/feeds/blogID/archive
Um die Exportdatei zu importieren, erstellen Sie eine POST
-Anfrage an den
folgenden URL mit dem Inhalt der Exportdatei als Anfragedaten und
application/atom+xml
als Inhaltstyp:
POST http://www.blogger.com/feeds/blogID/archive/full
Keine der oben genannten URLs unterstützt Abfrageparameter. Beide Anfragen müssen enthalten ebenfalls authentication-Informationen und Blog-Administratoren können den Blog mithilfe dieser Feeds importieren/exportieren. URLs.
Hinweis: Wenn Sie Ihren eigenen Blogger erstellen Exportdatei gibt es derzeit eine Einschränkung bezüglich der Reihenfolge der Posts. und Kommentare hinzufügen. In der Blogger-Exportdatei werden zuerst alle Beiträge und dann alle Kommentare aufgeführt. Es ist erlaubt, Beiträge und Kommentare zu vermischen, solange der Kommentar nach dem Beitrag gepostet wird, auf den er sich bezieht.
Weitere Informationen dazu, wie Blogger das Atom-Format im Export verwendet -Datei enthält, siehe die Protokolldatei Leitfaden.