Questa pagina è stata tradotta dall'API Cloud Translation.

Guida per gli sviluppatori: protocollo

Importante: questa è una versione precedente di questa pagina. Per la versione più recente, utilizza i link nella barra di navigazione a sinistra.

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

L'applicazione client può utilizzare l'API Blogger Data per creare nuovi post del blog, modificare o eliminare quelli esistenti e eseguire query sui post del blog che soddisfano determinati criteri.

Oltre a fornire alcune informazioni sulle funzionalità dell'API Blogger Data, questo documento fornisce esempi di interazioni di base con l'API Data utilizzando XML non elaborato e HTTP. Dopo aver letto questo documento, ti consigliamo di scoprire di più sull'interazione con l'API utilizzando le nostre librerie client leggendo le sezioni specifiche per il linguaggio di programmazione di questa guida per gli sviluppatori.

Sommario

Pubblico

Questo documento è rivolto ai programmatori che vogliono scrivere applicazioni client in grado di interagire con Blogger utilizzando XML e HTTP.

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 in questo documento senza scrivere codice, potresti trovare utili le utilità a riga di comando UNIX curl o wget. Per ulteriori informazioni, consulta le pagine di manuale di queste utilità.

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

Per iniziare

Creare un account Blogger

Ti consigliamo di creare un account Blogger a scopo di test. Blogger utilizza gli Account Google, quindi se hai già un Account Google, non devi fare altro.

Autenticazione al servizio Blogger

Puoi accedere ai feed pubblici e privati utilizzando l'API Blogger Data. I feed pubblici non richiedono alcuna autenticazione, ma sono di sola lettura. Se vuoi modificare i blog, il tuo cliente deve autenticarsi prima di richiedere i feed privati. Può eseguire l'autenticazione utilizzando uno dei due approcci: autenticazione proxy AuthSub o autenticazione nome utente/password ClientLogin.

Per ulteriori informazioni sull'autenticazione con le API di dati di Google in generale, consulta la documentazione sull'autenticazione.

La maggior parte degli esempi nelle sezioni successive di questo documento presuppone che tu fornisca l'autenticazione appropriata.

Autenticazione proxy AuthSub

L'autenticazione proxy AuthSub viene utilizzata dalle applicazioni web che devono autenticare i propri utenti negli Account Google. L'operatore del sito web e il codice client non hanno accesso al nome utente e alla password dell'utente di Blogger. Il client ottiene invece token AuthSub speciali che gli consentono di agire per conto di un determinato utente. Per informazioni più dettagliate, consulta la documentazione di AuthSub.

Quando un utente visita per la prima volta la tua applicazione, non è ancora stato autenticato. In questo caso, devi mostrare alcune informazioni e un link che indirizzi l'utente a una pagina di Google per autenticare la tua richiesta di accesso ai suoi blog.

I seguenti parametri di query sono inclusi nell'URL AuthSubRequest:

avanti: L'URL della pagina a cui Google deve reindirizzare l'utente dopo l'autenticazione.
ambito: Indica che l'applicazione sta richiedendo un token per accedere ai feed di Blogger. La stringa di ambito da utilizzare è http://www.blogger.com/feeds/ (ovviamente codificata come URL).
sicuro: Indica se il client richiede un token sicuro.
sessione: Indica se il token restituito può essere scambiato con un token multiuso (di sessione).

L'URL AuthSubRequest potrebbe avere il seguente aspetto:

https://www.google.com/accounts/AuthSubRequest?scope=http%3A%2F%2Fwww.blogger.com%2Ffeeds%2F&session=1&secure=0&next=http%3A%2F%2Fwww.example.com%2Fwelcome.html

L'utente segue il link al sito di Google e si autentica nel suo Account Google.

Dopo che l'utente ha eseguito l'autenticazione, il sistema AuthSub lo reindirizza all'URL specificato nel parametro di query next dell'URL AuthSubRequest. Il sistema AuthSub aggiunge un token di autenticazione a quell'URL come valore del parametro di query token. Ad esempio:

http://www.example.com/welcome.html?token=yourAuthToken

Questo valore del token rappresenta un token AuthSub monouso. In questo esempio, poiché è stato specificato session=1, questo token può essere scambiato con un token di sessione AuthSub chiamando il servizio AuthSubSessionToken con il token monouso in un'intestazione Authorization, come segue:

GET /accounts/AuthSubSessionToken HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Authorization: AuthSub token="yourAuthToken"
User-Agent: Java/1.5.0_06
Host: www.google.com
Accept: text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2
Connection: keep-alive

La risposta del servizio AuthSubSessionToken include un'intestazione Token che contiene il token sessione e un'intestazione Expiration che indica per quanto tempo il token rimarrà valido.

La tua applicazione può quindi utilizzare il valore del token di sessione nell'Authorization intestazione delle interazioni successive con Blogger.

Di seguito è riportato un esempio di richiesta HTTP contenente un token non sicuro che potresti inviare a Blogger:

GET /feeds/blogID/blogs/posts/defaults HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Authorization: AuthSub token="yourSessionToken"
User-Agent: Java/1.5.0_06
Host: www.blogger.com
Accept: text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2
Connection: keep-alive

Autenticazione tramite nome utente/password ClientLogin

Utilizza l'autenticazione ClientLogin se il client è un client "installato" autonomo per un solo utente (ad esempio un'applicazione desktop). Per richiedere un token di autenticazione utilizzando il meccanismo ClientLogin, invia una richiesta POST al seguente URL:

https://www.google.com/accounts/ClientLogin

Il corpo di POST deve contenere un insieme di parametri di query che assomigliano ai parametri passati da un modulo HTML, utilizzando il tipo di contenuti application/x-www-form-urlencoded. Questi parametri sono:

Email: L'indirizzo email dell'utente.
Passwd: La password dell'utente.
servizio: Il nome del servizio Blogger è blogger. Per altri nomi di servizi, consulta l'elenco dei nomi dei servizi.
accountType: Questo valore deve sempre essere impostato su GOOGLE quando utilizzi l'API Blogger. Se non imposti questo parametro, impedirai l'accesso agli utenti che hanno anche un account G Suite.
origine: Identifica la tua applicazione client. Deve avere il formato companyName-applicationName-versionID. Negli esempi viene utilizzato il nome exampleCo-exampleApp-1.

Per saperne di più sui parametri, consulta il documento Autenticazione per le applicazioni installate.

Se la richiesta di autenticazione non va a buon fine, il server restituisce un codice di stato HTTP403 Forbidden.

Se l'operazione riesce, il server restituisce un codice di stato HTTP 200 OK, oltre a tre codici alfanumerici lunghi nel corpo della risposta: SID, LSID e Auth. Il valore Auth è il token di autorizzazione che invierai a Blogger con ogni richiesta successiva, quindi conserva una copia di questo valore. Puoi ignorare i valori SID e LSID.

Poiché tutte le richieste ai feed privati richiedono l'autenticazione, devi impostare l'intestazione Authorization in tutte le interazioni successive con Blogger utilizzando il seguente formato:

Authorization: GoogleLogin auth=yourAuthToken

Dove yourAuthToken è la stringa Auth restituita dalla richiesta ClientLogin.

Per ulteriori informazioni sull'autenticazione ClientLogin, incluse richieste e risposte di esempio, consulta la documentazione sull'autenticazione per le applicazioni installate.

Nota: utilizza lo stesso token per tutte le richieste in una determinata sessione; non acquisire un nuovo token per ogni richiesta di Blogger.

Nota: come descritto nella documentazione di ClientLogin, la richiesta di autenticazione potrebbe non riuscire e richiedere una verifica CAPTCHA. Se vuoi che sia Google a emettere e gestire la verifica CAPTCHA, indirizza l'utente all'URL https://www.google.com/accounts/DisplayUnlockCaptcha?service=blogger (anziché all'URL di gestione del CAPTCHA indicato nella documentazione di ClientLogin).

Recupero di un elenco di blog

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

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

http://www.blogger.com/feeds/userID/blogs

Nota: puoi anche sostituire default con l'ID utente, che indica a Blogger di restituire l'elenco dei blog dell'utente le cui credenziali accompagnano la richiesta.

Una voce nel metafeed potrebbe avere il seguente aspetto:

<entry>
  <id>tag:blogger.com,1999:blog-blogID.post-postID</id>
  <published>2006-08-02T18:44:43.089-07:00</published>
  <updated>2006-11-08T18:10:23.020-08:00</updated>
  <title type='text'>Lizzy's Diary</title>
  <summary type='html'>Being the journal of Elizabeth Bennet</summary>
  <link rel='alternate' type='text/html'
    href='http://blogName.blogspot.com/'>
  </link>
  <link rel='http://schemas.google.com/g/2005#feed'
    type='application/atom+xml'
    href='http://blogName.blogspot.com/feeds/posts/default'>
  </link>
  <link rel='http://schemas.google.com/g/2005#post'
    type='application/atom+xml'
    href='http://www.blogger.com/feeds/blogID/posts/default'>
  </link>
  <link rel='self' type='application/atom+xml'
    href='http://www.blogger.com/feeds/userID/blogs/blogID'>
  </link>
  <link rel='edit' type='application/atom+xml'
      href='http://www.blogger.com/feeds/userID/blogs/blogID'>
  </link>
  <author>
    <name>Elizabeth Bennet</name>
    <email>noreply@blogger.com</email>
    <uri>http://www.blogger.com/profile/profileID</uri>
  </author>
</entry>

Per informazioni sul significato di ciascuno di questi elementi, consulta il documento Documento di riferimento del protocollo delle API Data di Google o le specifiche Atom 1.0.

Se la richiesta non va a buon fine per qualche motivo, Blogger potrebbe restituire un codice stato diverso. Ulteriori informazioni sui codici di stato HTTP sono disponibili anche nel documento Documento di riferimento del protocollo per le API di dati di Google.

Creare post

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

Pubblicazione di 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 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, colloca l'elemento Atom <entry> nel corpo di una nuova richiesta POST utilizzando il tipo di contenuto application/atom+xml. Poi 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, nel seguente formato:

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

Nota: questo URL è uguale a quello nel tag <link rel="service.post"> 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 HTTP201 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 la richiesta non va a buon fine per qualche motivo, Blogger potrebbe restituire un codice stato diverso. Per informazioni sui codici di stato, consulta il documento di riferimento del protocollo dell'API Google Data.

Creare una bozza di un post del blog

Le bozze dei post vengono create nello stesso modo dei post pubblici, ma con un elemento <app:control> aggiunto alla voce che 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://purl.org/atom/app#'>
  <app:draft>yes</app:draft>
</app:control>

Affinché il post venga riconosciuto come bozza, i dati contenuti nell'elemento <app:draft> devono essere la stringa yes.

Puoi trasformare una bozza di post del blog esistente in un post pubblicato recuperando la bozza, impostando i dati dell'elemento <app:draft> sulla stringa no e poi 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 il RFC 5023.

Recupero dei post

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

Puoi eseguire query su un feed pubblico di Blogger senza autenticazione. Pertanto, non è necessario impostare il parametro Authorization quando recuperi i post di un blog pubblico.

Recupero di tutti i post del blog

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 del blog appropriate. Ad esempio, per ottenere 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 http://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 conto che abbiamo modificato leggermente questo esempio per renderlo più leggibile da parte degli utenti. In particolare, un feed di Blogger reale contiene ID e URL reali.

<feed xmlns='http://www.w3.org/2005/Atom'>
  <id>tag:blogger.com,1999:blog-blogID</id>
  <updated>2006-11-08T18:10:23.020-08:00</updated>
  <title type='text'>Lizzy's Diary</title>
  <link rel='alternate' type='text/html'
    href='http://blogName.blogspot.com/index.html'>
  </link>
  <link rel='http://schemas.google.com/g/2005#feed'
    type='application/atom+xml'
    href='http://blogName.blogspot.com/feeds/posts/default'>
  </link>
  <link rel='self' type='application/atom+xml'
    href='http://blogName.blogspot.com/feeds/posts/default'>
  </link>
  <author>
    <name>Elizabeth Bennet</name>
    <email>noreply@blogger.com</email>
    <uri>http://www.blogger.com/profile/profileID</uri>
  </author>
  <generator version='7.00' uri='http://www2.blogger.com'>Blogger</generator>
  <entry>
    <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>
    <author>
      <name>Elizabeth Bennet</name>
      <email>noreply@blogger.com</email>
      <uri>http://www.blogger.com/profile/profileID</uri>
    </author>
  </entry>
</feed>

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, ad esempio 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 recuperare tutte le voci del blog create tra il 16 marzo 2008 e il 24 marzo 2008, invia una richiesta HTTP all'URL del feed del blog:

GET http://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 HTTP200 OK e un feed contenente tutti i post del blog creati nell'intervallo di date specificato.

I parametri updated-min e updated-max possono essere utilizzati anche per recuperare tutte le voci del blog aggiornate in 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 Blogger Data supporta i seguenti parametri di query:

alt: Il tipo di feed da restituire, ad esempio atom (il valore predefinito) o rss.
/category: Specifica le categorie (dette anche etichette) per filtrare i risultati del feed. Ad esempio, http://www.blogger.com/feeds/blogID/posts/default/-/Fritz/Laurie restituisce voci con le etichette Fritz e Laurie.
max-results: Il numero massimo di voci da restituire.
orderby: L'ordine in cui restituire le voci, ad esempio lastmodified (il valore predefinito), starttime o updated.
published-min, published-max: I limiti per le date di pubblicazione delle voci.
start-index: L'indice a partire da 1 del primo risultato da recuperare (per la paginazione).
updated-min, updated-max: I limiti per le date di aggiornamento delle voci. Questi parametri di query vengono ignorati a meno che il parametro orderby non sia impostato su updated.

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 da aggiornare, poi modificala e infine invia una richiesta PUT con la voce aggiornata nel corpo del messaggio all'URL di modifica del post. Assicurati che il valore <id> nella voce che PUT corrisponda esattamente al <id> della voce esistente.

L'URL di modifica è evidenziato nella seguente voce:

<entry>
  <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à futura, assicurati che quando PUT una voce aggiornata, venga conservato tutto il codice XML presente quando hai recuperato la voce da Blogger. In caso contrario, quando implementiamo nuove funzionalità e includiamo elementi <new-awesome-feature> nel feed, il tuo client non li restituirà e i tuoi utenti rimarranno a bocca asciutta. Le librerie client dell'API Google Data gestiscono tutto correttamente, quindi se utilizzi una di queste librerie non devi fare altro.

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

Suggerimento per la risoluzione dei problemi: alcuni firewall bloccano i messaggi HTTPPUT. Per aggirare 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 Google Data.

Eliminare i 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 HTTPDELETE. Per aggirare 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 Google Data.

Commenti

L'API Blogger Data consente di creare, recuperare ed eliminare i commenti. L'aggiornamento dei commenti non è supportato (e non è disponibile nell'interfaccia web).

Creazione di commenti

Per pubblicare un commento, crea un elemento Atom <entry> 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 Atom <entry> nel corpo di una nuova richiesta POST utilizzando il tipo di contenuto application/atom+xml. Quindi, invia la richiesta POST all'URL di Blogger appropriato:

POST http://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 al momento non è supportata. Tutti i nuovi commenti verranno visualizzati come se fossero stati creati dall'utente attualmente autenticato.

Recupero dei commenti

Puoi recuperare i commenti di un determinato post inviando un messaggio GET all'URL del feed dei commenti del post:

GET http://www.blogger.com/feeds/blogID/postID/comments/default

In alternativa, puoi recuperare i commenti di tutti i post utilizzando l'URL del feed commenti del blog:

GET http://www.blogger.com/feeds/blogID/comments/default

Queste richieste restituiscono un feed dei commenti simile al seguente:

<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">
  <id>tag:blogger.com,1999:blog-blogID.post-postID.comment-commentID</id>
  <updated>2007-04-04T21:56:29.803-07:00</updated>
  <title type="text">My Blog : Time to relax</title>
  <link rel="alternate" type="text/html" href="http://blogName.blogspot.com/2007/04/first-post.html"/>
  <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://blogName.blogspot.com/feeds/postID/comments/default"/>
  <author>
    <name>Blog Author name</name>
  </author>
  <generator version="7.00" uri="http://www2.blogger.com">Blogger</generator>
  <openSearch:totalResults>1</openSearch:totalResults>
  <openSearch:startIndex>1</openSearch:startIndex>
  <entry>
    <id>tag:blogger.com,1999:blog-blogID.post-commentID</id>
    <published>2007-04-04T21:56:00.000-07:00</published>
    <updated>2007-04-04T21:56:29.803-07:00</updated>
    <title type="text">This is my first comment</title>
    <content type="html">This is my first comment</content>
    <link rel="alternate" type="text/html" href="http://blogName.blogspot.com/2007/04/first-post.html#commentID"/>
    <link rel="self" type="application/atom+xml" href="http://blogName.blogspot.com/feeds/postID/comments/default/commentID"/>
    <link rel="edit" type="application/atom+xml" href="http://www.blogger.com/feeds/blogID/postID/comments/default/commentID"/>
    <thr:in-reply-to href="http://blogName.blogspot.com/2007/04/first-post.html" 
                     ref="tag:blogger.com,1999:blog-blogID.post-postID" 
                     source="http://www.blogger.com/feeds/posts/default/blogID"
                     type="text/html"/>
    <author>
      <name>Blog Author name</name>
      <email>blog_author@gmail.com</email>
      <uri>http://www.blogger.com/profile/userID</uri>
    </author>
    <thr:in-reply-to xmlns:thr='http://purl.org/syndication/thread/1.0' 
         href='http://blogName.blogspot.com/2007/04/first-post.html' 
         ref='tag:blogger.com,1999:blog-blogID.post-postID' 
         source='http://blogName.blogspot.com/feeds/posts/default/postID'
         type='text/html' />
  </entry>
</feed>

Eliminazione dei commenti

Per eliminare un commento, invia una richiesta DELETE all'URL di modifica del commento. Questo URL è 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. 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 conterrà i contenuti del feed dei post e 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 di un blog utilizzando l'API Data, utilizza il seguente URL:

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

Per importare il file di esportazione, crea una richiesta POST all'URL seguente con i contenuti del file di esportazione come dati della richiesta e application/atom+xml come tipo di contenuti:

POST http://www.blogger.com/feeds/blogID/archive/full

Nessuno degli URL sopra indicati supporta i parametri di query. Entrambe le richieste devono contenere anche informazioni di autenticazione e solo gli amministratori del blog potranno importare/esportare il blog utilizzando questi URL dei feed.

Nota: se crei il tuo file di esportazione di Blogger, al momento esiste una limitazione relativa all'ordinamento delle voci dei post e dei commenti. Il file di esportazione di Blogger elenca prima tutti i post e poi tutti i commenti. È consentito interlacciare le voci di post e commenti se la voce del commento segue il post a cui si riferisce.

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

Torna all'inizio