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 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 HTTP 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 HTTP.

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.

Autenticazione al servizio Blogger

Puoi accedere ai feed pubblici e privati utilizzando l'API dei dati di Blogger. I feed pubblici non richiedono alcuna autenticazione, ma sono di sola lettura. Se vuoi modificare i blog, il tuo cliente deve eseguire l'autenticazione prima di richiedere i feed privati. Può eseguire l'autenticazione utilizzando uno dei due approcci seguenti: autenticazione del proxy AuthSub o autenticazione del nome utente e della password di 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 del proxy AuthSub viene utilizzata dalle applicazioni web che devono autenticare gli 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 invece riceve token AuthSub speciali che consentono al client 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 visualizzare alcune informazioni e un link che indirizza l'utente a una pagina Google per autenticare la richiesta di accesso ai suoi blog.

I seguenti parametri di ricerca 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 richiede un token per accedere ai feed di Blogger. La stringa dell'ambito da utilizzare è http://www.blogger.com/feeds/ (con codifica URL, ovviamente).
sicuro: Indica se il client richiede un token sicuro.
sessione: Indica se il token restituito può essere scambiato con un token multiuso (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 ed esegue l'autenticazione sul proprio Account Google.

Dopo l'autenticazione dell'utente, il sistema AuthSub li reindirizza all'URL specificato nel parametro di ricerca next dell'URL AuthSubRequest. Il sistema AuthSub aggiunge un token di autenticazione all'URL, come valore del parametro di ricerca token. Ad esempio:

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

Questo valore token rappresenta un token AuthSub monouso. In questo esempio, poiché session=1 è stato specificato, il 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 di sessione e un'intestazione Expiration che indica per quanto tempo il token rimarrà valido.

La tua applicazione può quindi utilizzare il valore del token della sessione nell'intestazione Authorization 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 nome utente/password ClientLogin

Utilizza l'autenticazione ClientLogin se il client è un client autonomo, "singolo" per utente singolo (come 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 POST deve contenere un insieme di parametri di ricerca simili ai parametri trasmessi 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 gli altri nomi di servizio, consulta l'elenco dei nomi di servizio.
Tipo di account: Deve essere sempre impostato su GOOGLE quando si utilizza l'API Blogger. Se non imposti questo parametro, gli utenti che dispongono anche di un account G Suite non potranno accedere.
origine: Identifica la tua applicazione client. Deve essere nel formato companyName-applicationName-versionID. Negli esempi viene utilizzato il nome exampleCo-exampleApp-1.

Per ulteriori informazioni sui parametri, consulta la documentazione del documento Autenticazione per le applicazioni installate.

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

In caso di esito positivo, il server restituisce un codice di stato HTTP 200 OK e tre lunghi codici alfanumerici nel corpo della risposta: SID, LSID e Auth. Il valore Auth è il token di autorizzazione che invierai a Blogger con ciascuna delle tue richieste successive, quindi conserva una copia di tale valore. Puoi ignorare i valori SID e LSID.

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

Authorization: GoogleLogin auth=yourAuthToken

Dove yourAuthToken è la stringa di autenticazione restituita dalla richiesta ClientLogin.

Per ulteriori informazioni sull'autenticazione ClientLogin, incluse le richieste e le 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 Google emetta e gestisca la verifica CAPTCHA, invia l'utente a https://www.google.com/accounts/DisplayUnlockCaptcha?service=blogger (anziché all'URL di gestione CAPTCHA fornito nella documentazione ClientLogin).

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:

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

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>
  <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 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:

http://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://purl.org/atom/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 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. 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.

<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 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 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 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, http://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.

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>
  <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 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 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 http://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 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 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 http://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 http://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