Questo documento spiega come iniziare a utilizzare l'API JSON di Blogger.
Contenuti
Introduzione
Questo documento è destinato agli sviluppatori che vogliono scrivere applicazioni in grado di interagire con l'API JSON di Blogger.
L'API JSON di Blogger estende la versione 2.0 dell'API Blogger Data. Se vuoi recuperare i dati da Blogger in formato JSON anziché da XML, utilizza l'API JSON di Blogger. Se vuoi recuperare i dati in formato XML, usa l'API di dati di Blogger.
Al momento questa versione dell'API JSON di Blogger è in sola lettura, ma stiamo pianificando di aggiungere capacità di lettura/scrittura e altre. Non esitare a richiedere altre funzionalità nel forum di assistenza di Blogger.
Prima di iniziare
Crea un account Google
Assicurati di aver configurato un Account Google. Ti consigliamo di utilizzare un Account Google separato per scopi di sviluppo e test per proteggerti dalla perdita accidentale di dati. Se hai già un account di prova, è tutto pronto. Puoi visitare l'interfaccia utente di Blogger per impostare, modificare o visualizzare i tuoi dati di test.
Acquisisci familiarità con Blogger
Se non hai familiarità con i concetti di Blogger, leggi questo documento e sperimenta con l'interfaccia utente prima di iniziare a programmare. Questo documento presuppone che tu abbia familiarità con Blogger, che abbia concetti di programmazione web e con formati di dati web.
Scopri di più sull'autorizzazione delle richieste e sull'identificazione della tua applicazione
Quando la tua applicazione richiede dati privati, questa deve essere autorizzata da un utente autenticato che ha accesso a questi dati.
Quando l'applicazione richiede dati pubblici, la richiesta non deve essere autorizzata, ma deve essere accompagnata da un identificatore, ad esempio una chiave API.
Per informazioni su come autorizzare le richieste e utilizzare le chiavi API, consulta l'articolo su come autorizzare le richieste e identificare l'applicazione nel documento Utilizzo del documento API.
Sfondo dell'API JSON di Blogger
Concetti di Blogger
Blogger si basa su cinque concetti di base:
- Blog: il concetto principale dell'API. Un blog include post e pagine. Questo è il container per le meta-informazioni dei blog come Nome blog e Descrizione.
- Post: un post del blog è l'elemento pubblicabile creato dall'autore del blog. Queste informazioni sono pensate per essere tempestive, in quanto rispecchiano ciò che gli autori vogliono pubblicare nel mondo attuale. Siamo consapevoli che, con il passare del tempo, i post dei blog potrebbero invecchiare e diventare meno pertinenti.
- Commenti: un commento è il luogo in cui persone diverse dal post del blog reagiscono a ciò che l'autore ha scritto. Dai mattoni ai bouquet.
- Pagine: in una pagina sono presenti contenuti statici, ad esempio informazioni biografiche o come contattare l'utente. Si tratta in genere di informazioni senza tempo che non cambiano molto spesso.
- Utenti: un utente è una persona che interagisce con Blogger, agisce come autore, amministratore o solo come lettore. Per i blog pubblici, i lettori possono essere anonimi, ma sui blog privati devono essere identificati da Blogger.
Modello di dati API JSON di Blogger
Una risorsa è una singola entità dati con un identificatore univoco. L'API JSON di Blogger opera su cinque tipi di risorse:
- Risorsa blog: rappresenta un blog.
- Risorsa post: rappresenta un post; ogni risorsa post è una risorsa secondaria di un blog.
- Risorsa commenti: rappresenta un commento su un post specifico. Ogni risorsa dei commenti è una risorsa secondaria di un post.
- Risorsa pagine: rappresenta una pagina statica; ogni risorsa pagina è un figlio di una risorsa blog.
- Risorsa utente: rappresenta un utente non anonimo. Utilizzato per identificare l'autore di una pagina, un post o un commento.
Il modello di dati dell'API JSON di Blogger si basa su gruppi di risorse, chiamate raccolte:
- Raccolta di blog
- Una <span/#quot;apicollection">Blogs Collection comprende tutti i blog a cui un utente ha diritti di accesso. Puoi elencare i blog per utente o recuperare un singolo blog per ID.</span/#quot;apicollection">
- Raccolta di post
- Una raccolta di post è costituita da tutte le risorse relative ai post di una specifica risorsa del blog.
- Raccolta commenti
- Una raccolta di commenti è composta da tutte le risorse relative ai commenti all'interno di una specifica risorsa.
- Raccolta di pagine
- Una raccolta di pagine è costituita da tutte le risorse delle pagine di una specifica risorsa del blog.
- Raccolta utenti
- Una raccolta Utenti è composta da tutte le risorse utente su Blogger e non può quindi essere elencata. Un utente può recuperare la propria risorsa utenti (ma nessun altro utente) per ID o utilizzando l'identificatore
self
.
Operazioni dell'API JSON di Blogger
Nell'API JSON di Blogger puoi richiamare due metodi diversi per le raccolte e le risorse, come descritto nella tabella seguente.
Operazione | Descrizione | Mappature HTTP REST |
---|---|---|
list | Elenca tutte le risorse all'interno di una raccolta. | GET su un URI della raccolta. |
get | Visualizza una risorsa specifica. | GET su un URI della risorsa. |
La tabella seguente mostra i metodi supportati per ogni tipo di risorsa. Tutte le operazioni di elenco e get su blog privati richiedono l'autenticazione.
Tipo di risorsa |
Metodi supportati |
|
---|---|---|
lista | get. | |
Blog | sì | sì |
Post | sì | sì |
Commenti | sì | sì |
Pagine | sì | sì |
Utenti | no | sì |
Stili di chiamata
Esistono diversi modi per richiamare l'API:
- Utilizzo di REST direttamente o da JavaScript (non è necessario codice lato server)
- Utilizzare le librerie client.
REST
REST è un tipo di architettura software che fornisce un approccio pratico e coerente per la richiesta e la modifica dei dati.
Il termine REST è l'acronimo di "REpresentational State Transfer". Nel contesto delle API di Google, si riferisce all'utilizzo dei verbi HTTP per recuperare e modificare le rappresentazioni dei dati archiviati da Google.
In un sistema RESTful, le risorse vengono archiviate in un datastore. Un client invia una richiesta affinché il server esegua una determinata azione (ad esempio la creazione, il recupero, l'aggiornamento o l'eliminazione di una risorsa) e il server esegue l'azione e invia una risposta, spesso sotto forma di rappresentazione della risorsa specificata.
Nelle API RESTful di Google, il client specifica un'azione utilizzando un verbo HTTP come POST
, GET
, PUT
o DELETE
. Specifica una risorsa tramite un URI univoco a livello globale del seguente formato:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Poiché tutte le risorse dell'API dispongono di URI univoci accessibili tramite HTTP, REST consente la memorizzazione dei dati nella cache ed è ottimizzato per operare con l'infrastruttura distribuita del Web.
Potrebbero esserti utili le definizioni dei metodi riportate nella documentazione degli standard HTTP 1.1, in cui sono incluse le specifiche per GET
, POST
, PUT
e DELETE
.
REST nell'API JSON di Blogger
Le operazioni di Blogger supportate vengono mappate direttamente ai verbi HTTP REST, come descritto nelle operazioni dell'API JSON Blogger.
Il formato specifico per gli URI dell'API JSON di Blogger è il seguente:
https://www.googleapis.com/blogger/v2/users/userId https://www.googleapis.com/blogger/v2/users/self https://www.googleapis.com/blogger/v2/users/userId/blogs https://www.googleapis.com/blogger/v2/users/self/blogs https://www.googleapis.com/blogger/v2/blogs/blogId/posts https://www.googleapis.com/blogger/v2/blogs/blogId/posts/postId https://www.googleapis.com/blogger/v2/blogs/blogId/posts/postId/comments https://www.googleapis.com/blogger/v2/blogs/blogId/posts/postId/comments/commentId https://www.googleapis.com/blogger/v2/blogs/blogId/pages https://www.googleapis.com/blogger/v2/blogs/blogId/pages/pageId
La spiegazione completa degli URI utilizzati e dei risultati per ogni operazione supportata nell'API è riassunta nel documento Blogger JSON API Reference.
Ecco un paio di esempi di come funziona nell'API JSON di Blogger.
Elenca i blog per i quali l'utente autenticato dispone dei diritti di accesso:
GET https://www.googleapis.com/blogger/v2/users/self/blogs?key=YOUR-API-KEY
Leggi i post sul blog di code.blogger.com (con ID blog 3213900):
GET https://www.googleapis.com/blogger/v2/blogs/3213900?key=YOUR-API-KEY
REST da JavaScript
Puoi richiamare l'API JSON di Blogger utilizzando REST da JavaScript, utilizzando il parametro di ricerca callback
e una funzione di callback. Questo consente di scrivere applicazioni avanzate che mostrano i dati di Blogger senza scrivere codice lato server.
L'esempio seguente recupera un post dal blog code.blogger.com in seguito alla sostituzione di YOUR-API-KEY con la chiave API.
<html> <head> <title>Blogger JSON API Example</title> </head> <body> <div id="content"></div> <script> function handleResponse(response) { document.getElementById("content").innerHTML += "<h1>" + response.title + "</h1>" + response.content; } </script> <script src="https://www.googleapis.com/blogger/v2/blogs/3213900/posts/8398240586497962757?callback=handleResponse&key=YOUR-API-KEY"></script> </body> </html>
Formato dei dati
JSON
JSON (JavaScript Object Notation) è un formato comune dei dati indipendente dal linguaggio che fornisce una semplice rappresentazione testuale di strutture arbitrarie di dati. Per saperne di più, consulta json.org.