Guida per gli sviluppatori: protocollo

L'API Blogger Data consente alle applicazioni client di visualizzare e aggiornare i contenuti di Blogger sotto forma di feed dell'API dati di Google.

L'applicazione client può utilizzare l'API di dati di Blogger per creare nuovi post del blog, modificare o eliminare i post del blog esistenti e fare query per post di blog che corrispondono a criteri specifici.

Oltre a fornire alcune informazioni sulle funzionalità dell'API di dati di Blogger, il presente documento fornisce esempi di interazioni di base dell'API di dati utilizzando XML e HTTPS non elaborati. Dopo aver letto questo documento, puoi scoprire di più sull'interazione con l'API utilizzando le nostre librerie client leggendo le sezioni specifiche per i linguaggi di programmazione di questa guida per gli sviluppatori.

Contenuti

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 abbia compreso le idee generali alla base del protocollo API di dati di Google.

Se utilizzi un sistema UNIX e vuoi provare gli esempi in questo documento senza scrivere alcun codice, potresti trovare utili le utilità a riga di comando UNIX curl o wget; per saperne di più, consulta le pagine manuali di tali utilità.

Per informazioni di riferimento sull'API di dati di Blogger, consulta la guida di riferimento del protocollo.

Per cominciare

Creazione di un account Blogger

Ti consigliamo di creare un account Blogger per scopi di test. Blogger utilizza gli Account Google pertanto, se hai già un Account Google, 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

Per autorizzare le richieste, ti consigliamo di utilizzare OAuth 2.0.

L'API Blogger GData supporta anche le opzioni di autorizzazione precedenti, come OAuth 1.0, AuthSub o ClientLogin; tuttavia, nella maggior parte dei casi no, Se la tua applicazione utilizza già queste opzioni, ti consigliamo di eseguire la migrazione a OAuth 2.0, se possibile.

Se la tua applicazione ha determinati requisiti di autorizzazione insoliti, come l'accesso contemporaneamente alla richiesta di accesso ai dati (ibrido) o la delega dell'autorità a livello di dominio (2LO), al momento non puoi utilizzare i token OAuth 2.0. In questi casi, devi invece 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 del processo di autorizzazione, o "flusso", per OAuth 2.0 variano leggermente in base al tipo di applicazione che vuoi scrivere. Il seguente processo generale si applica a tutti i tipi di applicazione:

  1. Quando crei la tua applicazione, la registra con Google. Google fornisce poi informazioni di cui avrai bisogno in un secondo momento, ad esempio un ID client e un client secret.
  2. Quando la tua applicazione richiede l'accesso ai dati utente, chiede a Google un ambito di accesso specifico.
  3. Google mostra una finestra di dialogo OAuth all'utente, chiedendo di autorizzare l'applicazione a richiedere alcuni dati.
  4. Se l'utente approva, Google fornisce alla tua applicazione un token di accesso di breve durata.
  5. L'applicazione richiede i dati utente, allegando il token di accesso alla richiesta.
  6. Se Google stabilisce che la tua 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 di OAuth 2.0 di Google.

Ecco le informazioni sull'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, nonché le informazioni fornite da Google durante la registrazione (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 diversi tipi di linguaggi di programmazione; consulta la pagina Librerie ed esempi per maggiori dettagli.

Specificare una versione

Ogni richiesta inviata tramite 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 puoi impostare intestazioni HTTP, puoi specificare v=2 come parametro di ricerca nell'URL. Tuttavia, se possibile, è preferibile utilizzare l'intestazione HTTP.

Nota: le librerie client forniscono automaticamente le intestazioni di versione appropriate, quindi non utilizzare il parametro di query v=2 quando utilizzi una libreria client.

Recupero di un elenco di blog in corso...

L'API di dati di Blogger fornisce un feed che elenca i blog per un determinato utente; tale feed è noto come "metafeed".

Invia un GET HTTP al seguente URL per recuperare l'elenco di blog:

https://www.blogger.com/feeds/profileID/blogs

Dove l'ID profilo è il numero dell'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.

Creazione di post

L'API Blogger Data consente di creare e pubblicare nuove voci di blog, nonché di creare bozze di voci.

Pubblicare un post del blog

Dopo l'autenticazione, potrai pubblicare nuove voci del blog.

In primo luogo, crea una rappresentazione XML del post da pubblicare. Questo XML deve essere sotto forma di elemento Atom <entry>, 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 non è attualmente supportata. Tutti i nuovi post verranno visualizzati come se fossero stati creati dall'utente attualmente autenticato.

Per pubblicare questa voce, inviala all'URL del post del blog come segue. Innanzitutto, inserisci l'elemento <entry> Atom 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> in cui l'attributo rel termina con #post. L'URL del post del blog viene fornito come attributo href di questo elemento, che è nel seguente formato:

https://www.blogger.com/feeds/blogID/posts/default

Nota: questo URL è uguale all'URL nel tag <link rel="service.post"> che viene visualizzato 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 la documentazione di riferimento del protocollo dell'API di dati di Google.

Creazione di una bozza di post del blog

Le bozze dei post vengono create come i post pubblici, ma alla voce viene aggiunto un elemento <app:control> che indica che il post deve essere (ancora) 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.

Puoi trasformare una bozza di post esistente in un post pubblicato recuperando la bozza del post, impostando i dati dell'elemento <app:draft> sulla stringa no e aggiornando il post. Il recupero e l'aggiornamento dei post sono trattati nelle due sezioni successive.

Nota: per ulteriori informazioni sul protocollo di pubblicazione Atom, inclusi gli spazi dei nomi <app:control> e <app:draft>, consulta RFC 5023.

Recupero dei post in corso...

Le seguenti sezioni descrivono come recuperare un elenco di post del blog, con e senza parametri di ricerca.

Puoi eseguire query su un feed pubblico di Blogger senza autenticazione. quindi non devi impostare il parametro di autorizzazione quando recuperi i post del blog da un blog pubblico.

Recupero di tutti i post del blog in corso...

Per recuperare i post dell'utente, invia una richiesta HTTP GET all'URL del feed del blog. Blogger restituisce quindi un feed contenente le voci appropriate del blog. Ad esempio, per ottenere un elenco di post del blog per liz@gmail.com, invia la seguente richiesta HTTP a Blogger (con il valore appropriato al posto di blogID, ovviamente):

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. Nota che abbiamo leggermente modificato questo esempio, rendendolo un po' più leggibile dalle persone. In particolare, un feed di Blogger reale 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'>&lt;p&gt;I met Mr. Bingley's friend Mr. Darcy
      this evening. I found him quite disagreeable.&lt;/p&gt;</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 post del blog nuovamente

Se vuoi recuperare un post che hai recuperato in precedenza, puoi migliorare l'efficienza comunicando a Blogger l'invio del post solo se è cambiato rispetto all'ultima volta che lo hai recuperato.

Per eseguire questa operazione di recupero condizionale, invia una richiesta HTTP GET che includa un'intestazione HTTP If-None-Match. 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 i tag ETag corrispondono, la voce non è cambiata e Blogger restituisce un codice di stato HTTP 304 Not Modified.

Se i tag ETag non corrispondono, la voce è stata modificata dall'ultima richiesta e Blogger restituisce la voce.

Per ulteriori informazioni sugli ETag, consulta la guida di riferimento delle API di dati Google.

Recupero dei post mediante parametri di ricerca

L'API di dati di Blogger consente di richiedere un set di voci che corrispondono a criteri specifici, come la richiesta di 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 del blog create tra il 16 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.

I parametri updated-min e updated-max possono essere utilizzati anche per aggiornare tutte le voci del blog in un determinato intervallo. Tuttavia, tieni presente che questi parametri vengono ignorati a meno che anche il parametro orderby sia impostato su updated.

L'API di dati di Blogger supporta i seguenti parametri di ricerca:

alt
Il tipo di feed da restituire, ad esempio atom (impostazione predefinita) o rss.
/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 le voci con le etichette Fritz e Laurie.
max risultati
Il numero massimo di voci da restituire.
ordina
L'ordine in cui restituire le voci, ad esempio lastmodified (impostazione predefinita), starttime o updated.
min-pubblicato-max-pubblicato
I limiti per le date di pubblicazione delle iscrizioni.
indice-indice
L'indice in base uno del primo risultato da recuperare (per il paging).
min-aggiornato, max-aggiornato
I limiti per le date di aggiornamento delle voci. Questi parametri di ricerca vengono ignorati a meno che il parametro orderby non sia impostato su updated.
percorso
Il percorso del permalink di un post. Ad esempio, per un post con l'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 a testo intero. In questo modo potrai cercare in un blog i post che corrispondono a una query.

Per ulteriori informazioni sui parametri di ricerca, consulta la Guida di riferimento API per i dati di Blogger e la Guida di riferimento per le API di dati Google.

Aggiornamento dei post in corso...

Per aggiornare un post del blog esistente, devi prima recuperare la voce che vuoi aggiornare, quindi modificarla, quindi invia una richiesta PUT, con la voce aggiornata nel corpo del messaggio, all'URL di modifica del post. Assicurati che il valore <id> della voce PUT corrisponda esattamente al valore <id> della voce esistente.

L'URL di modifica viene evidenziato nella voce seguente:

<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'>&lt;p&gt;I met Mr. Bingley's friend Mr. Darcy
    this evening. I found him quite disagreeable.&lt;/p&gt;</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à con l'inoltro, assicurati che, quando PUT una voce aggiornata, conservi tutti i file XML presenti al momento del recupero della voce da Blogger. In caso contrario, quando implementiamo nuovi elementi e includi elementi <new-awesome-feature> nel feed, il cliente non li restituirà e gli utenti perderanno l'accesso. Le librerie client dell'API di dati Google gestiscono tutte queste operazioni correttamente, quindi se stai utilizzando una delle librerie impostate.

Nota: la modifica dei dati dell'autore associati ai post non è attualmente supportata.

Suggerimento per la risoluzione dei problemi: alcuni firewall bloccano i messaggi PUT HTTP. Per aggirare questo 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 API di dati di Google.

Eliminazione dei post in corso...

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 DELETE HTTP. Per aggirare questo 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 API di dati di Google.

Commenti

L'API Blogger Data consente di creare, recuperare ed eliminare i commenti. L'aggiornamento dei commenti non è supportato (né è 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, posiziona l'elemento <entry> Atom nel corpo di una nuova richiesta POST, utilizzando il tipo di contenuti application/atom+xml. Invia quindi 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 è attualmente supportata. Tutti i nuovi commenti appariranno come se fossero stati creati dall'utente attualmente autenticato.

Recupero dei commenti in corso...

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

In alternativa, 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 dei 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 commenti

Per eliminare un commento, invia una richiesta DELETE all'URL di modifica del commento. Questo URL è evidenziato nel feed di commenti sopra.

Formato di esportazione

Blogger consente agli utenti di esportare e importare i propri blog utilizzando un file di esportazione di Blogger. Questo file di esportazione contiene tutti i post e i commenti di un blog. Il formato del file di esportazione è esattamente lo stesso formato 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 in un unico documento.

Per esportare o importare 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, utilizza il seguente URL:

GET https://www.blogger.com/feeds/blogID/archive

Per importare il file di esportazione, crea una richiesta POST nel 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 per i parametri di query indicati sopra supporta. Entrambe le richieste devono contenere anche informazioni di autenticazione e solo gli amministratori del blog potranno importare/esportare il blog utilizzando questi URL del feed.

Nota: se stai creando il tuo file di esportazione di Blogger, attualmente esiste una restrizione all'ordine delle voci di post e commenti. Il file di esportazione di Blogger elenca prima tutti i post, poi tutti i commenti. L'interlazione di post e commenti è consentita a condizione che la relativa voce provenga dopo il post.

Per ulteriori informazioni su come Blogger utilizza il formato Atom nel file di esportazione, consulta la guida di riferimento al protocollo.

Torna all'inizio