Importante: questa è una versione obsoleta della pagina. Per la versione più recente, utilizza i link nella barra di navigazione a sinistra.
Questo documento fornisce una 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 dei linguaggi di programmazione. Per informazioni di riferimento sulla libreria client, consulta i link nelle sezioni della guida per gli sviluppatori specifiche per i linguaggi di programmazione.
Contenuti
Pubblico
Questo documento è destinato ai programmatori che desiderano scrivere applicazioni client in grado di interagire con Blogger.
È 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 di 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 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 GUI, se il blog deve fornire un feed completo o un feed di riepilogo a syndicatori e aggregatori.
Quando l'app client invia una richiesta non autenticata per un feed, riceve qualsiasi tipo di feed specificato dal proprietario del blog.
Tuttavia, quando l'app client invia una richiesta autenticata, riceve sempre 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 tutti i parametri di query standard dell'API di dati di Google.
Blogger non supporta i parametri q
(ricerca testuale) 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
Informazioni sugli 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 l'Atom Publishing Protocol.
Il resto di questa sezione fornisce un paio di note specifiche sull'utilizzo di alcuni elementi standard da parte di Blogger.
Voci in versione bozza
Una bozza di voce di 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 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 il client non specifica un valore per <published>
, Blogger imposta la data di pubblicazione della voce sull'ora del server corrente. Quando il cliente modifica una voce ma non specifica un valore <published>
, Blogger lascia solo la 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. Questo può essere utile per attività come l'importazione di voci vecchie da un altro sistema di blogging (con la conservazione delle date di creazione originali).
Blogger utilizza l'elemento Atom <updated>
standard per
indicare la data dell'ultima modifica di una 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 rispettivi
valori <published>
o <updated>
. Tuttavia,
per le note sull'esecuzione di query sulle date aggiornate, consulta
Riferimento ai parametri di query di Blogger.
Collegamento di commenti ai post
Il formato di esportazione di Blogger contiene sia post che voci di commenti in un unico documento di 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 alla voce del post a cui appartiene viene
realizzato mediante l'utilizzo dell'estensione Atom Threading. Nell'esempio seguente, l'elemento <thr:in-reply-to>
nella voce del commento punterà 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>