Importante: questa è una versione precedente di questa pagina. Per la versione più recente, utilizza i link nella barra di navigazione a sinistra.
Questo documento fornisce la documentazione di riferimento dettagliata per il protocollo non elaborato (XML e HTTP) dell'API Blogger Data.
Questo documento non contiene informazioni sul linguaggio di programmazione librerie client. Per informazioni di riferimento sulle librerie client, controlla i link da sezioni della guida per gli sviluppatori specifiche per i linguaggi di programmazione.
Sommario
Pubblico
Questo documento è rivolto ai programmatori che vogliono scrivere applicazioni client in grado di interagire con Blogger.
È un documento di riferimento; si presuppone che tu comprenda i concetti presentati nella guida per gli sviluppatori. le idee generali alla base delle API di dati di Google protocollo.
Tipi di feed di Blogger
Blogger offre due rappresentazioni dei contenuti dei blog nei feed: feed completi e feed di riepilogo. Un feed completo contiene post del blog completi, mentre un feed di riepilogo contiene solo un breve snippet di ogni post.
Il proprietario di un blog può specificare, utilizzando le impostazioni della GUI, se il blog fornisce un feed completo o un feed di riepilogo a syndication e aggregatori.
Quando l'app client invia una richiesta non autenticata per un feed, riceve a qualsiasi tipo di feed specificato dal proprietario del blog.
Tuttavia, quando l'app client invia una richiesta autenticata, riceve un feed completo, indipendentemente da quanto specificato dal proprietario del blog.
Riferimento ai parametri di query di Blogger
L'API di dati di Blogger supporta quasi tutte le soluzioni Google Parametri di query dell'API di dati.
Blogger non supporta i parametri q (ricerca di testo) e
author.
Parametri di query updated-min e updated-max
vengono ignorati a meno che il parametro orderby non sia impostato su
updated. Ad esempio, il seguente URL recupera tutti i post del blog aggiornati dal 16 marzo 2008 al 24 marzo 2008:
http://www.blogger.com/feeds/blogID/posts/default?updated-min=2008-03-16T00:00:00&updated-max=2008-03-24T23:59:59&orderby=updated
Riferimento agli elementi di Blogger
L'API di dati di Blogger utilizza solo elementi Atom standard. per ulteriori informazioni, vedi la sezione Atom specifiche del formato di syndication 1.0 e Atom Publishing Protocol.
Il resto di questa sezione fornisce un paio di note specifiche sull'argomento l'utilizzo di alcuni elementi standard.
Voci in versione bozza
Una bozza di post del blog è contrassegnata con <app:draft>
elemento di estensione definito nel documento Atom Publishing Protocol. Ecco un
esempio di bozza di voce:
<entry xmlns:app='http://purl.org/atom/app#'> ... <app:control> <app:draft>yes</app:draft> </app:control> </entry>
Se non viene specificato alcun elemento <draft>, la voce non è una bozza.
Date di pubblicazione e date aggiornate
Il timestamp fornito nell'elemento <published>
Atom standard corrisponde alla "data del post" che un utente può impostare nella GUI di Blogger.
Quando il client crea una nuova voce, se non specifica un valore per <published>, Blogger imposta la data di pubblicazione della voce sull'ora corrente del server. Quando il cliente modifica una voce, ma non specifica un valore <published>, Blogger lascia invariata la data di pubblicazione della voce.
Tuttavia, se il cliente specifica un valore per
<published> elemento durante la creazione o la modifica di una voce, poi
Blogger imposta la data di post della voce sul valore specificato. Può essere utile
per attività come l'importazione di voci vecchie da un altro sistema di blogging (pur mantenendo
le date di creazione originali).
Blogger utilizza l'elemento Atom <updated> standard per
indicano la data dell'ultima modifica di una voce. Il tuo cliente non può controllare
Valore <updated>; Blogger imposta sempre l'ultimo aggiornamento della voce
alla data e all'ora corrente del server ogni volta che il cliente pubblica o modifica
.
Puoi utilizzare l'API di dati standard di Google published-min,
published-max, updated-min e
updated-max parametri di query per richiedere voci in base ai
Valori di <published> o <updated>. Tuttavia,
per note su come eseguire query sulle date aggiornate, vedi Blogger
riferimento ai parametri di query.
Collegare i commenti ai post
L'esportazione di Blogger
formato contiene sia post che voci di commento in un unico documento del feed Atom.
Per distinguere i due tipi di voci, Blogger utilizza l'elemento<atom:category>. Questo elemento avrà un parametro term che indica se la voce riguarda un post o un commento.
Inoltre, collegare la voce del commento alla voce del post a cui appartiene
ottenuti tramite l'uso dell'estensione Atom Threading. Nell'esempio riportato di seguito, l'elemento <thr:in-reply-to> nella voce del commento farà riferimento al post utilizzando l'identificatore della voce del post nel parametro ref. Inoltre, rimanda all'URL HTML del post tramite il parametro
href.
<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>