L'API Blogger ti consente di integrare i contenuti di Blogger con la tua applicazione utilizzando le API REST. Prima di iniziare, devi configurare l'autorizzazione.
Introduzione
Questo documento è rivolto agli sviluppatori che desiderano scrivere applicazioni in grado di interagire con l'API Blogger. Blogger è uno strumento per la creazione di siti web che consentono alle persone di pubblicare i propri pensieri su base continuativa.
Se non hai dimestichezza con i concetti di Blogger, ti consigliamo di leggere la Guida introduttiva prima di iniziare a programmare.
Autorizzazione delle richieste e identificazione dell'applicazione
Ogni richiesta che la tua applicazione invia alle API di Blogger deve identificare la tua applicazione a Google. Esistono due modi per identificare la tua applicazione: utilizzando un token OAuth 2.0 (che autorizza anche la richiesta) e/o la chiave API dell'applicazione. Ecco come stabilire quali opzioni utilizzare:
- Se la richiesta richiede l'autorizzazione (ad esempio una richiesta per i dati privati di un privato), l'applicazione deve fornire un token OAuth 2.0 insieme alla richiesta. Anche l'applicazione potrebbe fornire la chiave API, ma non è obbligatorio.
- Se la richiesta non richiede l'autorizzazione (ad esempio una richiesta di dati pubblici), l'applicazione deve fornire la chiave API, un token OAuth 2.0 o entrambi, a seconda dell'opzione che preferisci.
Informazioni sui protocolli di autorizzazione
La tua applicazione deve utilizzare il protocollo OAuth 2.0 per autorizzare le richieste. Non sono supportati altri protocolli di autorizzazione. Se la tua applicazione utilizza la funzionalità Accedi con Google, alcuni aspetti dell'autorizzazione vengono gestiti per te.
Autorizzazione delle richieste con OAuth 2.0
Le richieste di dati utente non pubblici alle API di Blogger devono essere autorizzate da un utente autenticato.
Questa procedura è facilitata da un ID client OAuth.
Ottenere un ID client OAuthIn alternativa, creane una nella pagina Credenziali.
I dettagli della procedura di autorizzazione, o "flusso", per il protocollo OAuth 2.0 variano a seconda del tipo di applicazione che stai scrivendo. La seguente procedura generale si applica a tutti i tipi di applicazione:
- Quando la tua applicazione vuole accedere ai dati dell'utente, chiede a Google un particolare ambito di accesso.
- Google mostra una schermata di consenso all'utente, chiedendo di autorizzare l'applicazione a richiedere dei 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 ritiene validi la richiesta e il token, restituisce i dati richiesti.
Alcuni flussi includono passaggi aggiuntivi, come l'uso 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 le API di Blogger:
https://www.googleapis.com/auth/blogger
Per richiedere l'accesso utilizzando il protocollo OAuth 2.0, l'applicazione richiede le informazioni relative all'ambito e le informazioni che Google fornisce quando registri la tua applicazione (ad esempio l'ID client e 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 delle librerie e dei campioni per maggiori dettagli.
Acquisizione e utilizzo di una chiave API
Le richieste di dati pubblici alle API di Blogger devono essere accompagnate da un identificatore, che può essere una chiave API o un token di accesso.
Ottieni una chiaveIn alternativa, creane una nella pagina Credenziali.
Dopo aver ottenuto una chiave API, l'applicazione può aggiungere il parametro di query
key=yourAPIKey
a tutti gli URL delle richieste.
La chiave API è sicura per l'incorporamento negli URL; non è necessaria alcuna codifica.
Lavorare con i blog
Recupero di un blog
Puoi recuperare le informazioni per un determinato blog inviando una richiesta HTTP GET
all'URI del blog. L'URI di un blog ha il seguente formato:
https://www.googleapis.com/blogger/v3/blogs/blogId
Richiesta
GET https://www.googleapis.com/blogger/v3/blogs/2399953?key=YOUR-API-KEY
Non è necessario che un utente sia autenticato per recuperare un blog pubblico. L'applicazione non deve includere l'intestazione HTTP Authorization
per una richiesta di blog pubblico; tuttavia, devi fornire la chiave API.
Blogger dispone anche di blog privati, che richiedono l'autenticazione.
Risposta
Se la richiesta riesce, il server risponde con un codice di stato HTTP 200 OK
e i dati del blog:
{ "kind": "blogger#blog", "id": "2399953", "name": "Blogger Buzz", "description": "The Official Buzz from Blogger at Google", "published": "2007-04-23T22:17:29.261Z", "updated": "2011-08-02T06:01:15.941Z", "url": "http://buzz.blogger.com/", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953", "posts": { "totalItems": 494, "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts" }, "pages": { "totalItems": 2, "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/pages" }, "locale": { "language": "en", "country": "", "variant": "" } }
Recupero di un blog in base all'URL
Puoi recuperare un blog utilizzando il relativo URL inviando una richiesta HTTP GET
al seguente URI con un parametro url
:
https://www.googleapis.com/blogger/v3/blogs/byurl?url=blog-url
Richiesta
https://www.googleapis.com/blogger/v3/blogs/byurl?url=http://code.blogger.com/
Risposta
Se la richiesta riesce, il server risponde con un codice di stato HTTP 200 OK
e la rappresentazione completa del blog identificato:
{ "kind": "blogger#blog", "id": "3213900", "name": "Blogger Developers Network", "description": "The official Blogger Developers Network weblog.", "published": "2007-02-09T10:13:10-08:00", "updated": "2012-04-15T19:38:01-07:00", "url": "http://code.blogger.com/", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900", "posts": { "totalItems": 55, "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/posts" }, "pages": { "totalItems": 1, "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/pages" }, "locale": { "language": "en", "country": "US", "variant": "" } }
Recupero dei blog di un utente
Puoi recuperare un elenco dei blog di un utente inviando una richiesta GET
HTTP all'URI della raccolta dei blog:
https://www.googleapis.com/blogger/v3/users/userId/blogs
Richiesta
GET https://www.googleapis.com/blogger/v3/users/self/blogs
Authorization: /* OAuth 2.0 token here */
Nota: l'utente deve essere autenticato per elencare i propri blog, quindi devi fornire l'intestazione HTTP Authorization
con la richiesta GET
.
Risposta
Se la richiesta riesce, il server risponde con un codice di stato HTTP 200 OK
e la rappresentazione completa dell'elenco dei blog dell'utente:
{ "kind": "blogger#blogList", "items": [ { "kind": "blogger#blog", "id": "4967929378133675647", "name": "Brett's Test Blawg", "description": "", "published": "2010-10-06T23:33:31.662Z", "updated": "2011-08-08T06:50:02.005Z", "url": "http://brettmorgan-test-blawg.blogspot.com/", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647", "posts": { "totalItems": 13, "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/posts" }, "pages": { "totalItems": 1, "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages" }, "locale": { "language": "en", "country": "", "variant": "" } } ] }
Utilizzo dei post
Recupero di post da un blog
Puoi recuperare un elenco di post da un determinato blog inviando una richiesta GET
all'URI della raccolta dei post. L'URI di una raccolta di post ha il seguente formato:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts
Richiesta
Ecco un esempio:
GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts?key=YOUR-API-KEY
Non è necessario che un utente sia autenticato per recuperare un blog pubblico. L'applicazione non deve includere l'intestazione HTTP Authorization
per una richiesta di blog pubblico; tuttavia, devi fornire la chiave API.
Blogger dispone anche di blog privati, che richiedono l'autenticazione.
Risposta
Se la richiesta riesce, il server risponde con un codice di stato HTTP 200 OK
e l'elenco di post:
{ "kind": "blogger#postList", "nextPageToken": "CgkIChiAkceVjiYQ0b2SAQ", "items": [ { "kind": "blogger#post", "id": "7706273476706534553", "blog": { "id": "2399953" }, "published": "2011-08-01T19:58:00.000Z", "updated": "2011-08-01T19:58:51.947Z", "url": "http://buzz.blogger.com/2011/08/latest-updates-august-1st.html", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553", "title": "Latest updates, August 1st", "content": "elided for readability", "author": { "id": "401465483996", "displayName": "Brett Wiltshire", "url": "http://www.blogger.com/profile/01430672582309320414", "image": { "url": "http://4.bp.blogspot.com/_YA50adQ-7vQ/S1gfR_6ufpI/AAAAAAAAAAk/1ErJGgRWZDg/S45/brett.png" } }, "replies": { "totalItems": "0", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553/comments" } }, { "kind": "blogger#post", "id": "6069922188027612413", elided for readability } ] }
Recupero di un post specifico
Puoi recuperare un post specifico da un blog inviando una richiesta GET
all'URI della risorsa post. L'URI di una risorsa post ha il seguente formato:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId
Richiesta
GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553?key=YOUR-API-KEY
Non è necessario che un utente sia autenticato per recuperare un blog pubblico. L'applicazione non deve includere l'intestazione HTTP Authorization
per una richiesta di blog pubblico; tuttavia, devi fornire la chiave API.
Blogger dispone anche di blog privati, che richiedono l'autenticazione.
Risposta
Se la richiesta riesce, il server risponde con un codice di stato HTTP 200 OK
e i contenuti del post:
{ "kind": "blogger#post", "id": "7706273476706534553", "blog": { "id": "2399953" }, "published": "2011-08-01T19:58:00.000Z", "updated": "2011-08-01T19:58:51.947Z", "url": "http://buzz.blogger.com/2011/08/latest-updates-august-1st.html", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553", "title": "Latest updates, August 1st", "content": "elided for readability", "author": { "id": "401465483996", "displayName": "Brett Wiltshire", "url": "http://www.blogger.com/profile/01430672582309320414", "image": { "url": "http://4.bp.blogspot.com/_YA50adQ-7vQ/S1gfR_6ufpI/AAAAAAAAAAk/1ErJGgRWZDg/S45/brett.png" } }, "replies": { "totalItems": "0", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553/comments" } }
Ricerca di un post
Puoi cercare i post di un blog inviando una richiesta GET
all'URI di ricerca dei post con il parametro di query q search:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/search?q=query terms
Richiesta
GET https://www.googleapis.com/blogger/v3/blogs/3213900/posts/search?q=documentation&key=YOUR-API-KEY
Non è necessario che un utente sia autenticato per recuperare un blog pubblico. L'applicazione non deve includere l'intestazione HTTP Authorization
per una richiesta di blog pubblico; tuttavia, devi fornire la chiave API.
Blogger dispone anche di blog privati, che richiedono l'autenticazione.
Risposta
Se la richiesta riesce, il server risponde con un codice di stato HTTP 200 OK
e i contenuti del post:
{ "kind": "blogger#postList", "nextPageToken": "CgkIChiAj86CpB8QzJTEAQ", "items": [ { "kind": "blogger#post", "id": "1387873546480002228", "blog": { "id": "3213900" }, "published": "2012-03-23T01:58:00-07:00", "updated": "2012-03-23T01:58:12-07:00", "url": "http://code.blogger.com/2012/03/blogger-documentation-has-moved-to.html", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/posts/1387873546480002228", "title": "Blogger Documentation has moved to developers.google.com", "content": "content elided for readability", "author": { "id": "16258312240222542576", "displayName": "Brett Morgan", "url": "http://www.blogger.com/profile/16258312240222542576", "image": { "url": "https://resources.blogblog.com/img/b16-rounded.gif" } }, "replies": { "totalItems": "0", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/posts/1387873546480002228/comments" } }, ... ] }
Aggiunta di un post
Puoi aggiungere un post per un blog inviando una richiesta POST
all'URI della raccolta dei post con un corpo JSON del post:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/
Richiesta
POST https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/ Authorization: /* OAuth 2.0 token here */ Content-Type: application/json { "kind": "blogger#post", "blog": { "id": "8070105920543249955" }, "title": "A new post", "content": "With <b>exciting</b> content..." }
Per creare un post devi disporre dell'autenticazione.
Risposta
Se la richiesta riesce, il server risponde con un codice di stato HTTP 200 OK
e i contenuti del post:
{ "kind": "blogger#post", "id": "6819100329896798058", "blog": { "id": "8070105920543249955" }, "published": "2012-05-20T20:08:00-07:00", "updated": "2012-05-20T20:08:35-07:00", "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post.html", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058", "title": "A new post", "content": "With <b>exciting</b> content...", "author": { "id": "16258312240222542576", "displayName": "Brett Morgan", "url": "http://www.blogger.com/profile/16258312240222542576", "image": { "url": "https://resources.blogblog.com/img/b16-rounded.gif" } }, "replies": { "totalItems": "0", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058/comments" } }
Eliminazione di un post
Puoi eliminare un post per un blog inviando una richiesta DELETE
all'URI della risorsa del post:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId
Richiesta
Ecco un esempio:
DELETE https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058 Authorization: /* OAuth 2.0 token here */
Per eliminare un post devi disporre dell'autenticazione.
Risposta
Se la richiesta riesce, il server risponde con un codice di stato HTTP 200 OK
.
Recupero di un post dal relativo percorso
Puoi recuperare un post da un blog inviando una richiesta GET
all'URI dei post in base al percorso con un parametro path
. L'URI di una richiesta di post per percorso ha il seguente formato:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/bypath?path=post-path
Richiesta
https://www.googleapis.com/blogger/v3/blogs/2399953/posts/bypath?path=/2011/08/latest-updates-august-1st.html&key=YOUR-API-KEY
Non è necessario che un utente sia autenticato per recuperare un blog pubblico. L'applicazione non deve includere l'intestazione HTTP Authorization
per una richiesta di blog pubblico; tuttavia, devi fornire la chiave API.
Blogger dispone anche di blog privati, che richiedono l'autenticazione.
Risposta
Se la richiesta riesce, il server risponde con un codice di stato HTTP 200 OK
e i contenuti del post:
{ "kind": "blogger#post", "id": "7706273476706534553", "blog": { "id": "2399953" }, "published": "2011-08-01T19:58:00.000Z", "updated": "2011-08-01T19:58:51.947Z", "url": "http://buzz.blogger.com/2011/08/latest-updates-august-1st.html", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553", "title": "Latest updates, August 1st", "content": "elided for readability", "author": { "id": "401465483996", "displayName": "Brett Wiltshire", "url": "http://www.blogger.com/profile/01430672582309320414", "image": { "url": "http://4.bp.blogspot.com/_YA50adQ-7vQ/S1gfR_6ufpI/AAAAAAAAAAk/1ErJGgRWZDg/S45/brett.png" } }, "replies": { "totalItems": "0", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553/comments" } }
Aggiornamento di un post
Puoi aggiornare un post per un blog inviando una richiesta PUT
all'URI della risorsa del post con un corpo JSON del post:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId
Richiesta
PUT https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/3445355871727114160 Authorization: /* OAuth 2.0 token here */ Content-Type: application/json { "kind": "blogger#post", "id": "3445355871727114160", "blog": { "id": "8070105920543249955" }, "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post_20.html", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/3445355871727114160", "title": "An updated post", "content": "With really <b>exciting</b> content..." }
Per aggiornare un post devi eseguire l'autenticazione.
Risposta
Se la richiesta riesce, il server risponde con un codice di stato HTTP 200 OK
e i contenuti del post:
{ "kind": "blogger#post", "id": "6819100329896798058", "blog": { "id": "8070105920543249955" }, "published": "2012-05-20T20:08:00-07:00", "updated": "2012-05-20T20:08:35-07:00", "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post.html", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058", "title": "An updated post", "content": "With really <b>exciting</b> content...", "author": { "id": "16258312240222542576", "displayName": "Brett Morgan", "url": "http://www.blogger.com/profile/16258312240222542576", "image": { "url": "https://resources.blogblog.com/img/b16-rounded.gif" } }, "replies": { "totalItems": "0", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058/comments" } }
Aggiornare un post con la semantica della patch
Puoi aggiornare un post con la semantica della patch inviando una richiesta PATCH
all'URI della risorsa post con un corpo JSON del post:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId
Richiesta
Ecco un esempio:
PATCH https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/3445355871727114160 Authorization: /* OAuth 2.0 token here */ Content-Type: application/json { "content": "With absolutely <b>fabulous</b> content..." }
Per aggiornare un post devi eseguire l'autenticazione.
Risposta
Se la richiesta riesce, il server risponde con un codice di stato HTTP 200 OK
e i contenuti del post:
{ "kind": "blogger#post", "id": "6819100329896798058", "blog": { "id": "8070105920543249955" }, "published": "2012-05-20T20:08:00-07:00", "updated": "2012-05-20T20:08:35-07:00", "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post.html", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058", "title": "An updated post", "content": "With absolutely <b>fabulous</b> content...", "author": { "id": "16258312240222542576", "displayName": "Brett Morgan", "url": "http://www.blogger.com/profile/16258312240222542576", "image": { "url": "https://resources.blogblog.com/img/b16-rounded.gif" } }, "replies": { "totalItems": "0", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058/comments" } }
Utilizzo dei commenti
Recupero di commenti per un post
Puoi recuperare un elenco dei commenti per un post inviando una richiesta GET
all'URI della raccolta dei commenti. L'URI di una raccolta di commenti ha il seguente formato:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId/comments
Richiesta
GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments?key=YOUR-API-KEY
"Non è necessario che l'utente sia autenticato per recuperare un blog pubblico. L'applicazione non deve includere l'intestazione HTTP Authorization
per una richiesta di blog pubblico; tuttavia, devi fornire la chiave API.
Blogger dispone anche di blog privati, che richiedono l'autenticazione.
Risposta
Se la richiesta riesce, il server risponde con un codice di stato HTTP 200 OK
e l'elenco di commenti:
{ "kind": "blogger#commentList", "nextPageToken": "CgkIFBDwjvDXlyYQ0b2SARj9mZe9n8KsnlQ", "prevPageToken": "CgkIFBisvMGRlyYQ0b2SARj9mZe9n8KsnlQ", "items": [ { "kind": "blogger#comment", "id": "9200761938824362519", "post": { "id": "6069922188027612413" }, "blog": { "id": "2399953" }, "published": "2011-07-28T19:19:57.740Z", "updated": "2011-07-28T21:29:42.015Z", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519", "content": "elided", "author": { "id": "530579030283", "displayName": "elided", "url": "elided", "image": { "url": "elided" } } }, { "kind": "blogger#comment", "id": "400101178920857170", elided for readability } ] }
Recupero di un commento specifico
Puoi recuperare un commento specifico da un post inviando una richiesta GET
all'URI della risorsa dei commenti. L'URI di una risorsa commenti ha il seguente formato:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId/comments/commentId
Richiesta
GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519?key=YOUR-API-KEY
"Non è necessario che l'utente sia autenticato per recuperare un blog pubblico. L'applicazione non deve includere l'intestazione HTTP Authorization
per una richiesta di blog pubblico; tuttavia, devi fornire la chiave API.
Blogger dispone anche di blog privati, che richiedono l'autenticazione.
Risposta
Se la richiesta riesce, il server risponde con un codice di stato HTTP 200 OK
e i dati del commento:
{ "kind": "blogger#comment", "id": "9200761938824362519", "post": { "id": "6069922188027612413" }, "blog": { "id": "2399953" }, "published": "2011-07-28T19:19:57.740Z", "updated": "2011-07-28T21:29:42.015Z", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519", "content": "elided", "author": { "id": "530579030283", "displayName": "elided", "url": "elided", "image": { "url": "elided" } } }
Lavorare con le pagine
Recupero di pagine per un blog
Puoi recuperare un elenco di pagine di un blog inviando una richiesta GET
all'URI della raccolta delle pagine. L'URI di una raccolta di pagine ha il seguente formato:
https://www.googleapis.com/blogger/v3/blogs/blogId/pages
Richiesta
GET https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages?key=YOUR-API-KEY
"Non è necessario che l'utente sia autenticato per recuperare un blog pubblico. L'applicazione non deve includere l'intestazione HTTP Authorization
per una richiesta di blog pubblico; tuttavia, devi fornire la chiave API.
Blogger dispone anche di blog privati, che richiedono l'autenticazione.
Risposta
Se la richiesta riesce, il server risponde con un codice di stato HTTP 200 OK
e l'elenco di pagine:
{ "kind": "blogger#pageList", "items": [ { "kind": "blogger#page", "id": "273541696466681878", "blog": { "id": "4967929378133675647" }, "published": "2011-07-14T16:16:00.000Z", "updated": "2011-07-14T16:16:23.602Z", "url": "http://brettmorgan-test-blawg.blogspot.com/p/static-content.html", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages/273541696466681878", "title": "Static Content", "content": "elided for readability", "author": { "id": "901569848744", "displayName": "brett", "url": "http://www.blogger.com/profile/16258312240222542576", "image": { "url": "https://resources.blogblog.com/img/b16-rounded.gif" } } } ] }
Recupero di una pagina specifica
Puoi recuperare una pagina specifica da un blog inviando una richiesta GET
all'URI della risorsa delle pagine. L'URI di una risorsa "Pagine" ha il seguente formato:
https://www.googleapis.com/blogger/v3/blogs/blogId/pages/pageId
Richiesta
GET https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages/273541696466681878?key=YOUR-API-KEY
"Non è necessario che l'utente sia autenticato per recuperare un blog pubblico. L'applicazione non deve includere l'intestazione HTTP Authorization
per una richiesta di blog pubblico; tuttavia, devi fornire la chiave API.
Blogger dispone anche di blog privati, che richiedono l'autenticazione.
Risposta
Se la richiesta riesce, il server risponde con un codice di stato HTTP 200 OK
e i dati della pagina:
{ "kind": "blogger#page", "id": "273541696466681878", "blog": { "id": "4967929378133675647" }, "published": "2011-07-14T16:16:00.000Z", "updated": "2011-07-14T16:16:23.602Z", "url": "http://brettmorgan-test-blawg.blogspot.com/p/static-content.html", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages/273541696466681878", "title": "Static Content", "content": "elided for readability", "author": { "id": "901569848744", "displayName": "brett", "url": "http://www.blogger.com/profile/16258312240222542576", "image": { "url": "https://resources.blogblog.com/img/b16-rounded.gif" } } }
Attività con gli utenti
Recupero di un utente
Puoi recuperare le informazioni di un utente inviando una richiesta GET
HTTP
all'URI della risorsa degli utenti:
https://www.googleapis.com/blogger/v3/users/userId
Richiesta
GET https://www.googleapis.com/blogger/v3/users/self
Authorization: /* OAuth 2.0 token here */
Nota: l'utente deve essere autenticato per elencare le proprie informazioni, quindi devi fornire l'intestazione HTTP Authorization
con la richiesta GET
.
Risposta
Se la richiesta riesce, il server risponde con un codice di stato HTTP 200 OK
e un link a un elenco dei blog dell'utente:
{ "kind": "blogger#user", "id": "901569848744", "selfLink": "https://www.googleapis.com/blogger/v3/users/901569848744", "blogs": { "selfLink": "https://www.googleapis.com/blogger/v3/users/901569848744/blogs" } }
Parametri di query standard
I seguenti parametri di query possono essere utilizzati con tutti i metodi e tutte le risorse nelle API di Blogger.
I parametri di query che si applicano a tutte le operazioni delle API di Blogger sono documentati in Parametri di sistema.