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 sulle librerie client per i linguaggi di programmazione. Per informazioni di riferimento sulle librerie client, consulta i link nelle sezioni specifiche per linguaggio di programmazione della guida per gli sviluppatori.
Sommario
Pubblico
Questo documento è rivolto ai programmatori che vogliono scrivere applicazioni client in grado di interagire con Blogger.
Si tratta di un documento di riferimento che presuppone che tu comprenda i concetti presentati nella guida per gli sviluppatori e le idee generali alla base del protocollo delle API di dati di Google.
Tipi di feed di Blogger
Blogger fornisce 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 qualunque tipo di feed specificato dal proprietario del blog.
Tuttavia, quando l'app client invia una richiesta autenticata, riceve sempre un feed completo, indipendentemente da ciò che ha specificato il proprietario del blog.
Riferimento ai parametri di query di Blogger
L'API Blogger Data supporta quasi tutti i parametri di query dell'API di dati di Google standard.
Blogger non supporta i parametri q (ricerca di testo) e
author.
I 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 Blogger Data utilizza solo elementi Atom standard. Per ulteriori informazioni, consulta la specifica del formato di syndication Atom 1.0 e il Atom Publishing Protocol.
Il resto di questa sezione fornisce alcune note specifiche sull'uso di alcuni elementi standard da parte di Blogger.
Voci in bozza
Una bozza di un post del blog viene contrassegnata utilizzando l'elemento di estensione <app:draft>
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 di aggiornamento
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 l'elemento <published> durante la creazione o la modifica di una voce, Blogger imposta la data di pubblicazione della voce sul valore specificato. Questa opzione può essere utile per attività come l'importazione di vecchie voci da un altro sistema di blogging (mantenendo le date di creazione originali).
Blogger utilizza l'elemento Atom <updated> standard per indicare quando una voce è stata modificata l'ultima volta. Il client non può controllare il valore <updated>. Blogger imposta sempre la data dell'ultimo aggiornamento della voce sull'ora corrente del server ogni volta che il client pubblica o modifica una voce.
Puoi utilizzare i parametri di query published-min,
published-max, updated-min e
updated-max dell'API Google Data standard per richiedere voci in base ai relativi valori
<published> o <updated>. Tuttavia, per le note sulle query sulle date aggiornate, consulta la documentazione di riferimento dei parametri di query di Blogger.
Collegare i commenti ai post
Il formato di esportazione di Blogger contiene sia i post che le voci dei commenti 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, il collegamento della voce del commento alla voce del post a cui appartiene avviene tramite l'utilizzo dell'estensione Thread di Atom. 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>