Questo documento fornisce la documentazione di riferimento dettagliata per il protocollo non elaborato (XML e HTTP) per l'API di dati di Blogger.
Questo documento non contiene informazioni sulle librerie client del linguaggio di programmazione. Per informazioni di riferimento sulla libreria client, consulta i link nelle sezioni specifiche del linguaggio di programmazione della guida dello sviluppatore.
Contenuti
Pubblico
Questo documento è destinato ai programmatori che desiderano scrivere applicazioni client in grado di interagire con Blogger.
Si tratta di un documento di riferimento; presuppone che tu abbia compreso i concetti presentati nella guida per gli sviluppatori e le idee generali alla base del protocollo delle API di dati Google.
Tipi di feed di Blogger
Blogger fornisce due rappresentazioni dei contenuti del blog nei feed: feed completi e feed di riepilogo. Un feed completo contiene post di 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 GUI, se il blog fornisce un feed completo o un feed di riepilogo a sindacatori e aggregatori.
Quando l'app client invia una richiesta non autenticata per un feed, il feed riceve qualsiasi tipo di feed specificato dal proprietario del blog.
Quando l'app client invia una richiesta autenticata, tuttavia, riceve sempre un feed completo, indipendentemente da ciò che il proprietario del blog ha specificato.
Guida di riferimento ai parametri di ricerca di Blogger
L'API Blogger Data supporta quasi tutti i parametri di ricerca standard dell'API Google Data.
Blogger non supporta il parametro author.
I parametri di ricerca 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 che sono stati aggiornati dal 16 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, consulta la specifica del formato di syndication Atom 1.0 e il Protocollo di pubblicazione Atom.
Il resto di questa sezione fornisce un paio di note specifiche sull'utilizzo di alcuni elementi standard da parte di Blogger.
Bozze di voci
La bozza di una voce di blog viene contrassegnata utilizzando l'elemento dell'estensione <app:draft> definito nel documento Atom Publishing Protocol. Ecco un esempio di bozza:
<entry xmlns:app='http://www.w3.org/2007/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 specificato nell'elemento standard Atom <published>
corrisponde alla"data di pubblicazione"che un utente può impostare nella GUI di Blogger.
Quando il client crea una nuova voce, se il client non specifica un valore per <published>, Blogger imposta la data di pubblicazione della voce sull'ora attuale del server. Quando il tuo client modifica una voce ma non specifica un valore <published>, Blogger lascia la sola data di pubblicazione della voce.
Tuttavia, se il client 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 operazione può essere utile per attività come l'importazione di voci precedenti da un altro sistema di blog, mantenendo le date di creazione originali.
Blogger utilizza l'elemento standard Atom <updated>
per indicare la data dell'ultima modifica di una voce. Il tuo client non può controllare il valore <updated>; Blogger imposta sempre la data dell'ultimo aggiornamento della voce all'ora attuale del server ogni volta che il client pubblica o modifica una voce.
Puoi utilizzare i parametri di ricerca standard published-min,
published-max, updated-min e
updated-max dell'API di dati di Google per richiedere le voci in base ai relativi valori di <published> o <updated>. Tuttavia, per note relative all'esecuzione di query in date aggiornate, consulta la documentazione di riferimento per i parametri di ricerca di Blogger.
Collegamento dei commenti ai post
Il formato di esportazione di Blogger contiene sia i post che le 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 riflette se la voce riguarda un post o un commento.
Inoltre, il collegamento della voce del commento a quella del post a cui appartiene viene
eseguito tramite l'uso dell'estensione Atom Threading. Nell'esempio riportato di seguito, l'elemento <thr:in-reply-to> nella voce del commento rimanda al post utilizzando l'identificatore della voce del post nel parametro ref. Si collega anche all'URL HTML del post tramite il parametro href.
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/"
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>
Riferimento allo schema dei feed di Blogger
- Feed elenco dei blog
- Feed dei post del blog
- Feed dei commenti sul blog
- Feed dei commenti ai post del blog