Importante: interromperemo il supporto per l'API di dati di Google v2.0 il 30 settembre 2024. Per garantire una funzionalità continuativa, aggiorna le applicazioni che si basano sull'API di dati di Google v2.0 alla versione più recente. Per la versione più recente, utilizza i link nella barra di navigazione a sinistra. Nota: anche se alcune richieste GET (come i post con schede) continueranno a essere supportate come URL dei feed, esistono piccole differenze nel loro comportamento. Per informazioni dettagliate, consulta la documentazione della Guida di Blogger.
Questo documento fornisce una documentazione di riferimento dettagliata per il protocollo non elaborato (XML e HTTP) per l'API Blogger Data.
Questo documento non contiene informazioni sulle librerie client dei linguaggi di programmazione. Per informazioni di riferimento sulla libreria client, consulta i link delle sezioni della guida per gli sviluppatori specifiche per i linguaggi di programmazione.
Sommario
Pubblico
Questo documento è destinato ai programmatori che desiderano scrivere applicazioni client in grado di interagire con Blogger.
È 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, tramite le impostazioni GUI, se il blog fornisce un feed completo o di riepilogo a distributori e aggregatori.
Quando l'app client invia una richiesta non autenticata per un feed, riceve ogni 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 ha specificato il proprietario del blog.
Riferimento ai parametri di query di Blogger
L'API di dati di Blogger supporta quasi tutti i parametri di query dell'API di dati di Google standard.
Blogger non supporta il parametro 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, l'URL seguente recupera tutti i post del blog che sono stati 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
La Blogger Data API utilizza solo elementi Atom standard; per ulteriori informazioni, consulta le specifiche 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'uso da parte di Blogger di alcuni elementi standard.
Voci di bozza
Una voce di bozza di blog è contrassegnata utilizzando l'elemento di estensione <app:draft> definito nel documento Atom Publishing Protocol. Ecco un esempio di voce in bozza:
<entry xmlns:app='http://www.w3.org/2007/app'> ... <app:control> <app:draft>yes</app:draft> </app:control> </entry>
Se non viene specificato nessun elemento <draft>, la voce non è una bozza.
Date di pubblicazione e date aggiornate
Il timestamp fornito nell'elemento Atom <published> standard corrisponde alla "data di pubblicazione" 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 attuale del server. Quando il cliente modifica una voce ma non specifica un valore <published>, Blogger lascia solo 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. Può essere utile per attività come l'importazione di voci vecchie da un altro sistema di blog (conservando le date di creazione originali).
Blogger utilizza l'elemento Atom <updated> standard per indicare quando è stata modificata l'ultima voce. Il client non può controllare il valore <updated>. Blogger imposta sempre la data dell'ultimo aggiornamento della voce sull'ora attuale del server ogni volta che il client pubblica o modifica una voce.
Puoi utilizzare i parametri di query standard dell'API di dati di Google published-min,
published-max, updated-min e
updated-max per richiedere voci in base ai relativi
valori <published> o <updated>. Tuttavia, per le note sulle query relative alle date aggiornate, consulta la documentazione sui parametri di query di Blogger.
Collegamento di commenti ai post
Il formato di esportazione di Blogger 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 riflette se la voce riguarda un post o un commento.
Inoltre, il collegamento della voce di commento alla voce del post a cui appartiene viene eseguito tramite l'utilizzo dell'estensione Atom Threading. Nell'esempio riportato di seguito, l'elemento <thr:in-reply-to> nella voce di commento punterà al post utilizzando l'identificatore post-voce 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/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 comment</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 per gli schemi dei feed di Blogger
- Feed elenco dei blog
- Feed dei post del blog
- Feed dei commenti del blog
- Feed dei commenti dei post del blog