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.
L'API Blogger Data consente alle applicazioni client di visualizzare e aggiornare i contenuti di Blogger sotto forma di feed API di dati di Google.
L'applicazione client può utilizzare l'API Blogger Data per creare nuovi post di blog, modificare o eliminare post di blog esistenti e cercare post del blog che corrispondono a criteri specifici.
Oltre a fornire alcune informazioni sulle funzionalità dell'API Blogger Data, questo documento fornisce esempi di interazioni di base dell'API di dati utilizzando XML non elaborati e HTTPS. Dopo aver letto questo documento, puoi ottenere ulteriori informazioni sull'interazione con l'API mediante le nostre librerie client leggendo le sezioni specifiche dei linguaggi di programmazione di questa guida per gli sviluppatori.
Sommario
Pubblico
Questo documento è destinato ai programmatori che desiderano scrivere applicazioni client in grado di interagire con Blogger utilizzando XML e HTTPS.
Questo documento presuppone che tu comprenda le idee generali alla base del protocollo delle API di dati di Google.
Se utilizzi un sistema UNIX e vuoi provare gli esempi riportati in questo documento senza scrivere alcun codice, potresti trovare utili le utilità a riga di comando UNIX curl
o wget
. Per ulteriori informazioni, consulta le pagine manuali di queste utilità.
Per informazioni di riferimento sull'API Blogger Data, consulta la Guida di riferimento al protocollo.
Per iniziare
Creazione di un account Blogger
Ti consigliamo di creare un account Blogger a scopo di test. Blogger utilizza Account Google, quindi se ne hai già uno, non devi fare altro.
Autorizzazione delle richieste
Quando l'applicazione richiede dati utente non pubblici, deve includere un token di autorizzazione. Il token, inoltre, identifica l'applicazione per Google.
Informazioni sui protocolli di autorizzazione
Consigliamo di utilizzare OAuth 2.0 per autorizzare le richieste.
L'API Blogger GData supporta anche opzioni di autorizzazione meno recenti, ad esempio OAuth 1.0, AuthSub o ClientLogin. Tuttavia, nella maggior parte dei casi, sconsigliamo di utilizzare queste altre opzioni. Se la tua applicazione utilizza già queste opzioni, ti consigliamo di eseguire la migrazione a OAuth 2.0, se possibile.
Se la tua applicazione presenta determinati requisiti di autorizzazione insoliti, ad esempio l'accesso contemporaneamente alla richiesta dell'accesso ai dati (ibrido) o la delega dell'autorità a livello di dominio (2LO), al momento non è possibile utilizzare i token OAuth 2.0. In questi casi, dovrai utilizzare i token OAuth 1.0.
Autorizzazione delle richieste con OAuth 2.0
Le richieste all'API GData di Blogger per dati utente non pubblici devono essere autorizzate da un utente autenticato.
I dettagli della procedura di autorizzazione, o "flusso", per OAuth 2.0 variano in base al tipo di applicazione che stai scrivendo. La seguente procedura generale si applica a tutti i tipi di applicazione:
- Quando crei la tua applicazione, la registri su Google. Google fornisce quindi le informazioni che ti saranno necessarie in un secondo momento, ad esempio un ID client e un client secret.
- Quando la tua applicazione ha bisogno di accedere ai dati utente, chiede a Google un particolare ambito di accesso.
- Google mostra all'utente una finestra di dialogo OAuth, in cui chiede di autorizzare l'applicazione a richiedere alcuni dei suoi dati.
- Se l'utente approva, Google fornisce alla tua applicazione un token di accesso di breve durata.
- L'applicazione richiede i dati utente, allegando il token di accesso alla richiesta.
- Se Google stabilisce che la richiesta e il token sono validi, restituisce i dati richiesti.
Alcuni flussi includono passaggi aggiuntivi, come l'utilizzo di token di aggiornamento per acquisire nuovi token di accesso. Per informazioni dettagliate sui flussi per vari tipi di applicazioni, consulta la documentazione relativa al protocollo OAuth 2.0 di Google.
Ecco le informazioni relative all'ambito OAuth 2.0 per l'API GData di Blogger:
https://www.blogger.com/feeds/
Per richiedere l'accesso utilizzando OAuth 2.0, la tua applicazione richiede le informazioni sull'ambito e le informazioni fornite da Google durante la registrazione dell'applicazione (ad esempio l'ID client e/o il client secret).
Suggerimento: le librerie client delle API di Google possono gestire parte del processo di autorizzazione per te. Sono disponibili per una varietà di linguaggi di programmazione; consulta la pagina Librerie ed esempi per ulteriori dettagli.
Specificare una versione
Per ogni richiesta che invii utilizzando l'API di dati di Blogger deve specificare la versione 2 dell'API.
Per specificare un numero di versione, utilizza l'intestazione HTTP GData-Version
:
GData-Version: 2
In alternativa, se non riesci a impostare le intestazioni HTTP, puoi specificare v=2
come parametro di ricerca nell'URL. Tuttavia, l'intestazione HTTP è preferibile,
ove possibile.
Nota: le librerie client forniscono automaticamente le intestazioni di versione appropriate, quindi non utilizzare il parametro di query v=2
quando usi una libreria client.
Recupero di un elenco di blog
L'API di dati di Blogger fornisce un feed che elenca i blog per un determinato utente; tale feed è noto come "metafeed".
Invia un'istruzione GET
HTTP al seguente URL per recuperare l'elenco dei blog:
https://www.blogger.com/feeds/profileID/blogs
Dove l'ID profilo è il numero nell'URL della pagina del profilo dell'utente.
Nota: puoi anche sostituire default
per l'ID utente, che indica a Blogger di restituire l'elenco dei blog per l'utente le cui credenziali accompagnano la richiesta.
Una voce nel metafeed potrebbe avere il seguente aspetto:
<entry gd:etag='W/"D08FQn8-eip7ImA9WxZbFEw."'> <id>tag:blogger.com,1999:user-userNumber.blog-blogID</id> <published>2006-08-02T18:44:43.089-07:00</published> <updated>2008-04-17T00:03:33.152-07:00</updated> <title>Lizzy's Diary</title> <summary type='html'>Being the journal of Elizabeth Bennet</summary> <link rel='self' type='application/atom+xml' href='http://www.blogger.com/feeds/profileID/blogs/blogID' /> <link rel='alternate' type='text/html' href='http://blogName.blogspot.com/' /> <link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='http://blogName.blogspot.com/feeds/posts/default' /> <link rel='http://schemas.google.com/g/2005#post' type='application/atom+xml' href='http://www.blogger.com/feeds/blogID/posts/default' /> ... <author> <name>Elizabeth Bennet</name> <uri>http://www.blogger.com/profile/profileID</uri> <email>noreply@blogger.com</email> </author> </entry>
Per informazioni sul significato di ciascuno di questi elementi, consulta il documento Google Data API Protocol Reference o la specifica Atom 1.0.
Se per qualche motivo la tua richiesta non va a buon fine, Blogger potrebbe restituire un codice di stato diverso. Ulteriori informazioni sui codici di stato HTTP sono disponibili anche nel documento Google Data API Protocol Reference.
Creare post
L'API Blogger Data ti consente di creare e pubblicare nuove voci di blog e di creare bozze di voci.
Pubblicare un post del blog
Dopo l'autenticazione, puoi pubblicare nuove voci del blog.
Per prima cosa, crea una rappresentazione XML del post da pubblicare. Questo XML deve essere sotto forma di un elemento <entry>
Atom, che potrebbe avere il seguente aspetto:
<entry xmlns='http://www.w3.org/2005/Atom'> <title type='text'>Marriage!</title> <content type='xhtml'> <div xmlns="http://www.w3.org/1999/xhtml"> <p>Mr. Darcy has <em>proposed marriage</em> to me!</p> <p>He is the last man on earth I would ever desire to marry.</p> <p>Whatever shall I do?</p> </div> </content> <category scheme="http://www.blogger.com/atom/ns#" term="marriage" /> <category scheme="http://www.blogger.com/atom/ns#" term="Mr. Darcy" /> </entry>
Nota: l'impostazione di un autore personalizzato per i post al momento non è supportata. Tutti i nuovi post appariranno come se fossero stati creati dall'utente attualmente autenticato.
Per pubblicare la voce, inviala all'URL del post del blog come segue. Innanzitutto,
inserisci l'elemento Atom <entry>
nel corpo di una nuova richiesta
POST
, utilizzando il tipo di
contenuti application/atom+xml
. Quindi trova l'URL del post del blog nel metafeed individuando l'elemento <link>
dove l'attributo rel
termina con #post
. L'URL del post del blog viene fornito come attributo href
di questo elemento, che ha questo formato:
https://www.blogger.com/feeds/blogID/posts/default
Nota: questo URL è uguale a quello nel tag <link rel="service.post">
che compare nella sezione <head>
della versione leggibile del blog.
Blogger crea un post del blog utilizzando la voce che hai inviato, quindi restituisce un codice di stato HTTP 201 CREATED
, insieme a una copia del nuovo post sotto forma di elemento <entry>
. La voce restituita è la stessa
che hai inviato, ma contiene anche vari elementi aggiunti da Blogger, ad esempio un
elemento <id>
.
Se per qualche motivo la tua richiesta non va a buon fine, Blogger potrebbe restituire un codice di stato diverso. Per informazioni sui codici di stato, consulta il documento di riferimento del protocollo dell'API Google Data.
Creare una bozza di post del blog
Le bozze dei post vengono create come i post pubblici, ma con l'aggiunta di un elemento <app:control>
alla voce indica che il post non deve (ancora) essere pubblicato.
Questo elemento <app:control>
deve contenere un singolo
elemento <app:draft>
come elemento secondario:
<app:control xmlns:app='http://www.w3.org/2007/app'> <app:draft>yes</app:draft> </app:control>
I dati contenuti nell'elemento <app:draft>
devono essere la
stringa yes affinché il post venga riconosciuto come bozza.
Per trasformare una bozza di post del blog esistente in un post pubblicato, recupera la bozza del post, imposta i dati dell'elemento <app:draft>
sulla stringa no e aggiorna il post. Il recupero e l'aggiornamento dei post
sono trattati nelle prossime due sezioni.
Nota: per ulteriori informazioni sul protocollo di pubblicazione Atom, inclusi gli spazi dei nomi <app:control>
e <app:draft>
, consulta RFC 5023.
Recupero di post
Le seguenti sezioni descrivono come recuperare un elenco di post di blog, con e senza parametri di ricerca.
Puoi eseguire query su un feed pubblico di Blogger senza autenticazione. Di conseguenza, non devi impostare il parametro di autorizzazione quando recuperi i post di un blog da un blog pubblico.
Recupero di tutti i post del blog
Per recuperare i post dell'utente, invia una richiesta GET
HTTP all'URL del feed del blog. Blogger restituisce quindi un feed
contenente le voci del blog appropriate. Ad esempio, per ricevere un elenco di post del blog per liz@gmail.com, invia la seguente richiesta HTTP a Blogger (ovviamente con il valore appropriato al posto di blogID
):
GET https://www.blogger.com/feeds/blogID/posts/default
Blogger restituisce quindi un codice di stato HTTP 200 OK
e un feed Atom 1.0 standard contenente i post del blog.
Di seguito è riportato un esempio di feed per un blog con un solo post. Tieni presente che abbiamo leggermente modificato questo esempio per renderlo un po' più leggibile per gli utenti. In particolare, un vero feed di Blogger contiene ID e URL effettivi.
<?xml version='1.0' encoding='utf-8'?> <?xml-stylesheet href="http://www.blogger.com/styles/atom.css" type="text/css"?> <feed xmlns='http://www.w3.org/2005/Atom' xmlns:gd='http://schemas.google.com/g/2005' gd:etag='W/"D08FQn8-eip7ImA9WxZbFEw."'> <id>tag:blogger.com,1999:blog-blogID</id> <updated>2008-04-17T00:03:33.152-07:00</updated> <title>Lizzy's Diary</title> <subtitle type='html'></subtitle> <link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='http://blogName.blogspot.com/feeds/posts/default' /> <link rel='self' type='application/atom+xml' href='http://www.blogger.com/feeds/blogID/posts/default' /> <link rel='alternate' type='text/html' href='http://blogName.blogspot.com/' /> <author> <name>Elizabeth Bennet</name> <uri>http://www.blogger.com/profile/profileID</uri> <email>noreply@blogger.com</email> </author> <generator version='7.00' uri='http://www2.blogger.com'>Blogger</generator> <entry gd:etag='W/"D0YHRn84eip7ImA9WxZUFk8."'> <id>tag:blogger.com,1999:blog-blogID.post-postID</id> <published>2008-04-07T20:25:00.005-07:00</published> <updated>2008-04-07T20:25:37.132-07:00</updated> <title>Quite disagreeable</title> <content type='html'><p>I met Mr. Bingley's friend Mr. Darcy this evening. I found him quite disagreeable.</p></content> <link rel='edit' type='application/atom+xml' href='http://www.blogger.com/feeds/blogID/posts/default/postID' /> <link rel='self' type='application/atom+xml' href='http://www.blogger.com/feeds/blogID/posts/default/postID' /> <link rel='alternate' type='text/html' href='http://blogName.blogspot.com/2008/04/quite-disagreeable.html' /> <author> <name>Elizabeth Bennet</name> <uri>http://www.blogger.com/profile/profileID</uri> <email>noreply@blogger.com</email> </author> </entry> </feed>
Recupero di un nuovo post del blog
Se vuoi recuperare un post recuperato in precedenza, puoi migliorare l'efficienza indicando a Blogger di inviare il post solo se è cambiato dall'ultima volta che lo hai recuperato.
Per eseguire questo tipo di recupero condizionale, invia una richiesta GET
HTTP che includa un'intestazione If-None-Match
HTTP. Nell'intestazione, specifica l'ETag della voce, che puoi trovare nell'attributo gd:etag
dell'elemento <entry>
.
Ad esempio:
If-None-Match: W/"D08FQn8-eil7ImA9WxZbFEw."
Quando Blogger riceve questa richiesta, controlla se la voce richiesta ha lo stesso ETag dell'ETag specificato. Se gli ETag corrispondono, la voce non è cambiata e Blogger restituisce un codice di stato Not
Modified
HTTP 304.
Se gli ETag non corrispondono, significa che la voce è stata modificata dall'ultima volta in cui l'hai richiesta e Blogger la restituisce.
Per ulteriori informazioni sugli ETag, consulta la guida di riferimento delle API di dati di Google.
Recupero dei post utilizzando i parametri di query
L'API Blogger Data ti consente di richiedere un insieme di voci che corrispondono a criteri specificati, come richiedere post del blog pubblicati o aggiornati in un determinato intervallo di date.
Ad esempio, per inviare una query sull'intervallo di date, aggiungi i parametri published-min
e published-max
all'URL della richiesta. Per ottenere tutte le voci di blog create tra il 16 marzo 2008 e il 24 marzo 2008, invia una richiesta HTTP all'URL del feed del blog:
GET https://www.blogger.com/feeds/blogID/posts/default?published-min=2008-03-16T00:00:00&published-max=2008-03-24T23:59:59
Quando invii la richiesta GET
, Blogger restituisce un codice di stato HTTP 200 OK
e un feed contenente eventuali post del blog creati nell'intervallo di date specificato.
È possibile utilizzare i parametri updated-min
e updated-max
anche per aggiornare tutte le voci del blog entro un determinato intervallo. Tuttavia, tieni presente che questi parametri vengono ignorati a meno che il parametro orderby
non sia impostato anche su updated
.
L'API di dati di Blogger supporta i seguenti parametri di query:
- alt
- Il tipo di feed da restituire, ad esempio
atom
(il valore predefinito) orss
. - /category
- Specifica le categorie (note anche come etichette) per filtrare i risultati del feed. Ad esempio,
https://www.blogger.com/feeds/blogID/posts/default/-/Fritz/Laurie
restituisce voci con entrambe le etichetteFritz
eLaurie
. - max-results
- Il numero massimo di voci da restituire.
- ordina
- L'ordine in cui restituire le voci, come
lastmodified
(valore predefinito),starttime
oupdated
. - min pubblicati, max pubblicati
- I limiti relativi alle date di pubblicazione delle voci.
- start-index
- L'indice in base 1 del primo risultato da recuperare (per il paging).
- aggiornato-min, aggiornato-max
- I limiti relativi alle date di aggiornamento delle voci. Questi parametri di query vengono ignorati a meno che il parametro
orderby
non sia impostato suupdated
. - percorso
- Il percorso del permalink di un post. Ad esempio, per un post il cui URL è http://buzz.blogger.com/2011/08/bloggers-fresh-new-look.html, il percorso del permalink è
/2011/08/bloggers-fresh-new-look.html
. - q
- Stringa di query di testo completa. In questo modo puoi cercare in un blog i post che corrispondono a una query.
Per ulteriori informazioni sui parametri di query, consulta la guida di riferimento dell'API di dati di Blogger e la guida di riferimento delle API di dati di Google.
Aggiornamento dei post
Per aggiornare un post del blog esistente, recupera prima la voce che vuoi aggiornare, poi modificala e infine invii una richiesta PUT
, con la voce aggiornata nel corpo del messaggio, all'URL di modifica del post. Assicurati che il
valore <id>
nella voce PUT
corrisponda esattamente
al <id>
della voce esistente.
L'URL di modifica è evidenziato nella seguente voce:
<entry gd:etag='W/"CUYDSXo8fSp7ImA9WB9UFkU."'> <id>tag:blogger.com,1999:blog-blogID.post-postID</id> <published>2006-11-08T18:10:00.000-08:00</published> <updated>2006-11-08T18:10:14.954-08:00</updated> <title type='text'>Quite disagreeable</title> <content type='html'><p>I met Mr. Bingley's friend Mr. Darcy this evening. I found him quite disagreeable.</p></content> <link rel='alternate' type='text/html' href='http://blogName.blogspot.com/2006/11/quite-disagreeable.html'> </link> <link rel='self' type='application/atom+xml' href='http://blogName.blogspot.com/feeds/posts/default/postID'> </link> <link rel='edit' type='application/atom+xml' href='http://www.blogger.com/feeds/blogID/posts/default/postID'> </link> <category scheme="http://www.blogger.com/atom/ns#" term="Mr. Bingley" /> <category scheme="http://www.blogger.com/atom/ns#" term="Mr. Darcy" /> <author> <name>Elizabeth Bennet</name> <email>noreply@blogger.com</email> <uri>http://www.blogger.com/profile/profileID</uri> </author> </entry>
IMPORTANTE: per garantire la compatibilità in avanti, quando PUT
una voce aggiornata viene conservata tutto il codice XML che era presente quando hai recuperato la voce da Blogger. In caso contrario,
quando implementiamo nuovi elementi e includiamo gli elementi <new-awesome-feature>
nel feed, il tuo cliente non li restituisce e gli utenti non li perdono. Le librerie client dell'API di dati di Google gestiscono tutte questo problema in modo corretto, pertanto se utilizzi una delle librerie che hai configurato tutte le librerie.
Nota: la modifica dei dati dell'autore associati ai post non è attualmente supportata.
Suggerimento per la risoluzione dei problemi: alcuni firewall bloccano i messaggi HTTP PUT
. Per risolvere il problema, puoi includere un'intestazione X-HTTP-Method-Override: PUT
in una richiesta POST
.
Per maggiori dettagli, consulta il documento Nozioni di base sul protocollo dell'API di dati di Google.
Eliminazione dei post
Per eliminare un post, invia una richiesta DELETE
all'URL di modifica del post.
Si tratta dello stesso URL utilizzato per aggiornare i post.
Suggerimento per la risoluzione dei problemi: alcuni firewall bloccano i messaggi HTTP DELETE
. Per risolvere il problema, puoi includere un'intestazione X-HTTP-Method-Override: DELETE
in una richiesta POST
. Per maggiori dettagli, consulta il documento Nozioni di base sul protocollo dell'API di dati di Google.
Commenti
L'API Blogger Data consente di creare, recuperare ed eliminare i commenti. L'aggiornamento dei commenti non è supportato (non è disponibile nell'interfaccia web).
Creazione di commenti
Per pubblicare un commento, crea un elemento <entry>
Atom come il seguente:
<entry xmlns='http://www.w3.org/2005/Atom'> <title type="text">This is my first comment</title> <content type="html">This is my first comment</content> </entry>
Per pubblicare questo commento, inserisci l'elemento <entry>
Atom
nel corpo di una nuova richiesta POST
, utilizzando il
tipo di contenuti application/atom+xml
. Dopodiché invia la richiesta POST
all'URL di Blogger appropriato:
POST https://www.blogger.com/feeds/blogID/postID/comments/default
Nota: al momento puoi pubblicare commenti solo su un blog di proprietà dell'utente autenticato.
Nota: l'impostazione di un autore personalizzato per i commenti non è al momento supportata. Tutti i nuovi commenti verranno visualizzati come se fossero stati creati dall'utente attualmente autenticato.
Recupero dei commenti
Puoi recuperare i commenti per un determinato post inviando un GET
all'URL del feed dei commenti di questo post:
GET https://www.blogger.com/feeds/blogID/postID/comments/default
Oppure puoi ottenere i commenti da tutti i post utilizzando l'URL del feed dei commenti del blog:
GET https://www.blogger.com/feeds/blogID/comments/default
Queste richieste restituiscono un feed di commenti simile al seguente:
<?xml version='1.0' encoding='utf-8'?> <?xml-stylesheet href="http://www.blogger.com/styles/atom.css" type="text/css"?> <feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearch/1.1/' xmlns:gd='http://schemas.google.com/g/2005' gd:etag='W/"CUYMQ348fyp7ImA9WB9UFkU."'> <id>tag:blogger.com,1999:blog-blogID.postpostID..comments</id> <updated>2007-12-14T17:46:22.077-08:00</updated> <title>Comments on Lizzy's Diary: Quite disagreeable</title> <link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='http://blogName.blogspot.com/feeds/postID/comments/default' /> <link rel='self' type='application/atom+xml' href='http://www.blogger.com/feeds/blogID/postID/comments/default' /> <link rel='alternate' type='text/html' href='http://blogName.blogspot.com/2007/12/quite-disagreeable_5283.html' /> <author> <name>Elizabeth Bennet</name> <uri>http://www.blogger.com/profile/profileID</uri> <email>noreply@blogger.com</email> </author> <generator version='7.00' uri='http://www.blogger.com'>Blogger</generator> <openSearch:totalResults>1</openSearch:totalResults> <openSearch:startIndex>1</openSearch:startIndex> <entry gd:etag='W/"CUYCQX47eSp7ImA9WB9UFkU."'> <id>tag:blogger.com,1999:blog-blogID.post-commentID</id> <published>2007-12-14T17:46:00.001-08:00</published> <updated>2007-12-14T17:46:00.001-08:00</updated> <title>Darcy FTW!</title> <content type='html'>Darcy FTW!</content> <link rel='edit' type='application/atom+xml' href='http://www.blogger.com/feeds/blogID/postID/comments/default/commentID' /> <link rel='self' type='application/atom+xml' href='http://www.blogger.com/feeds/blogID/postID/comments/default/commentID' /> <link rel='alternate' type='text/html' href='http://blogName.blogspot.com/2007/12/quite-disagreeable_5283.html?showComment=1197683160001#ccommentID' title='' /> <author> <name>Elizabeth Bennet</name> <uri>http://www.blogger.com/profile/profileID</uri> <email>liz@gmail.com</email> </author> <thr:in-reply-to xmlns:thr='http://purl.org/syndication/thread/1.0' href='http://blogName.blogspot.com/2007/12/quite-disagreeable_5283.html' ref='tag:blogger.com,1999:blog-blogID.post-postID' source='http://www.blogger.com/feeds/blogID/posts/default/postID' type='text/html' /> </entry> </feed>
Eliminazione dei commenti in corso...
Per eliminare un commento, invia una richiesta DELETE
all'URL di modifica del commento. Questo URL viene evidenziato nel feed dei commenti qui sopra.
Formato di esportazione
Blogger consente agli utenti di esportare e importare i propri blog utilizzando un file di esportazione di Blogger. Il file di esportazione contiene tutti i post e i commenti di un blog. Il formato del file di esportazione è esattamente lo stesso Atom descritto nelle sezioni sul recupero di post e commenti. Questo file di esportazione includerà i contenuti del feed del post e i contenuti del feed dei commenti combinati in un unico documento.
Per esportare o importare i dati del blog utilizzando il formato di esportazione, puoi visitare la pagina Impostazioni del blog. Per recuperare il file di esportazione per un blog utilizzando l'API di dati, usa il seguente URL:
GET https://www.blogger.com/feeds/blogID/archive
Per importare il file di esportazione, crea una richiesta POST
al seguente URL con i contenuti del file di esportazione come dati della richiesta e application/atom+xml
come tipo di contenuti:
POST https://www.blogger.com/feeds/blogID/archive/full
Nessuno degli URL indicati sopra supporta i parametri di query. Entrambe le richieste devono contenere anche informazioni di autenticazione e solo gli amministratori di blog potranno importare/esportare il blog utilizzando questi URL del feed.
Nota: se stai creando un file di esportazione di Blogger, attualmente esiste una restrizione relativa all'ordine delle voci di post e commenti. Il file di esportazione di Blogger elenca prima tutti i post e poi tutti i commenti. L'interfoliazione delle voci di post e commenti è consentita a patto che l'inserimento del commento sia successivo al post del commento.
Per ulteriori informazioni su come Blogger utilizza il formato Atom nel file di esportazione, consulta la guida di riferimento al protocollo.