API Blogger: utilizzare l'API

L'API Blogger ti consente di integrare i contenuti Blogger con la tua applicazione utilizzando le API REST. Prima di iniziare, devi configurare l'autorizzazione.

Introduzione

Questo documento è destinato agli sviluppatori che vogliono scrivere applicazioni in grado di interagire con l'API di Blogger. Blogger è uno strumento per la creazione di siti web che consente alle persone di pubblicare le proprie opinioni su una base continua.

Se non hai familiarità con i concetti di Blogger, ti consigliamo di leggere la Guida introduttiva prima di iniziare la programmazione.

Autorizzazione delle richieste e identificazione della tua applicazione

Ogni richiesta che la tua applicazione invia alle API di Blogger deve identificarla in Google. Esistono due modi per identificare la tua applicazione: utilizzare un token OAuth 2.0 (che autorizza anche la richiesta) e/o utilizzare la chiave API dell'applicazione. Ecco come stabilire quali di queste opzioni utilizzare:

• Se la richiesta richiede autorizzazione (ad esempio una richiesta di dati privati di un privato), l'applicazione deve fornire un token OAuth 2.0 alla richiesta. L'applicazione può anche fornire la chiave API, ma non deve necessariamente.
• Se la richiesta non richiede autorizzazione (come una richiesta di dati pubblici), l'applicazione deve fornire la chiave API, un token OAuth 2.0 o entrambi, qualunque sia l'opzione più comoda per te.

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 Accedi con Google, alcuni aspetti dell'autorizzazione vengono gestiti automaticamente.

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 OAuth

o creane uno 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:

1. Quando la tua applicazione vuole accedere ai dati dell'utente, chiede a Google un particolare ambito di accesso.
2. Google mostra una schermata di consenso all'utente, chiedendo di autorizzare l'applicazione a richiedere dei dati.
3. Se l'utente approva, Google fornisce alla tua applicazione un token di accesso di breve durata.
4. L'applicazione richiede i dati utente, allegando il token di accesso alla richiesta.
5. 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 sull'ambito OAuth 2.0 per le API 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.

Acquisire e utilizzare una chiave API

Le richieste ai dati pubblici alle API Blogger devono essere accompagnate da un identificatore, che può essere una chiave API o un token di accesso.

Procurati una chiave

o creane uno nella pagina Credenziali.

Dopo aver creato una chiave API, l'applicazione può aggiungere il parametro di ricerca key=yourAPIKey a tutti gli URL della richiesta.

La chiave API è sicura per l'incorporamento negli URL; non ha bisogno di codifica.

Utilizzo dei blog

Recupero di un blog

Puoi recuperare le informazioni di un blog specifico 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

Risorse richieste:

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 pubblica del blog, ma è necessario fornire la chiave API.

Blogger ha anche blog privati che richiedono l'autenticazione.

Risposta

Se la richiesta ha esito positivo, il server risponde con un codice di stato HTTP 200 OK e con 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 tramite il relativo 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

Risorse richieste:

https://www.googleapis.com/blogger/v3/blogs/byurl?url=http://code.blogger.com/

Risposta

Se la richiesta ha esito positivo, il server risponde con un codice di stato HTTP 200 OK e nella 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 in corso...

Puoi recuperare un elenco dei blog di un utente inviando una richiesta HTTP GET all'URI della raccolta di blog:

https://www.googleapis.com/blogger/v3/users/userId/blogs

Risorse richieste:

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 ha esito positivo, il server risponde con un codice di stato HTTP 200 OK e nella 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": ""
      }
    }
  ]
}

Utilizzare i post

Recupero dei 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

Risorse richieste:

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 pubblica del blog, ma è necessario fornire la chiave API.

Blogger ha anche blog privati che richiedono l'autenticazione.

Risposta

Se la richiesta ha esito positivo, il server risponde con un codice di stato HTTP 200 OK e con 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 del post. L'URI di una risorsa per i post ha il seguente formato:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId

Risorse richieste:

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 pubblica del blog, ma è necessario fornire la chiave API.

Blogger ha anche blog privati che richiedono l'autenticazione.

Risposta

Se la richiesta ha esito positivo, il server risponde con un codice di stato HTTP 200 OK e con 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 in corso...

Per cercare i post di un blog, invia una richiesta GET all'URI post-ricerca con il parametro di ricerca q:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/search?q=query terms

Risorse richieste:

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 pubblica del blog, ma è necessario fornire la chiave API.

Blogger ha anche blog privati che richiedono l'autenticazione.

Risposta

Se la richiesta ha esito positivo, il server risponde con un codice di stato HTTP 200 OK e con 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"
    }
  },
  ...
  ]
}

Aggiungere un post

Puoi aggiungere un post per un blog inviando una richiesta POST all'URI della raccolta post con un corpo JSON post:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/

Risorse richieste:

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..."
}

Devi aver ricevuto l'autenticazione per poter creare un post.

Risposta

Se la richiesta ha esito positivo, il server risponde con un codice di stato HTTP 200 OK e con 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"
 }
}

Eliminare un post

Puoi eliminare un post per un blog inviando una richiesta DELETE all'URI della risorsa di post:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId

Risorse richieste:

Ecco un esempio:

DELETE https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058
Authorization: /* OAuth 2.0 token here */

Devi avere effettuato l'autenticazione per eliminare un post.

Risposta

Se la richiesta ha esito positivo, 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 ai URI del percorso dei post con un parametro path. L'URI di una richiesta per post per percorso ha il seguente formato:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/bypath?path=post-path

Risorse richieste:

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 pubblica del blog, ma è necessario fornire la chiave API.

Blogger ha anche blog privati che richiedono l'autenticazione.

Risposta

Se la richiesta ha esito positivo, il server risponde con un codice di stato HTTP 200 OK e con 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 di post con un corpo JSON post:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId

Risorse richieste:

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..."
}

Devi aver ricevuto l'autenticazione per aggiornare un post.

Risposta

Se la richiesta ha esito positivo, il server risponde con un codice di stato HTTP 200 OK e con 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 delle patch

Puoi aggiornare un post con la semantica delle patch inviando una richiesta PATCH all'URI della risorsa di post con un corpo JSON del post:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId

Risorse richieste:

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..."
}

Devi aver ricevuto l'autenticazione per aggiornare un post.

Risposta

Se la richiesta ha esito positivo, il server risponde con un codice di stato HTTP 200 OK e con 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"
 }
}

Utilizzare i commenti

Recupero dei commenti per un post

Puoi recuperare un elenco di commenti per un post, inviando una richiesta GET all'URI della raccolta dei commenti. L'URI per una raccolta di commenti ha il seguente formato:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId/comments

Risorse richieste:

GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments?key=YOUR-API-KEY

"Un utente non deve essere autenticato per recuperare un blog pubblico. L'applicazione non deve includere l'intestazione HTTP Authorization per una richiesta pubblica del blog, ma è necessario fornire la chiave API.

Blogger ha anche blog privati che richiedono l'autenticazione.

Risposta

Se la richiesta ha esito positivo, il server risponde con un codice di stato HTTP 200 OK e con 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 per i commenti. L'URI di una risorsa dei commenti ha il seguente formato:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId/comments/commentId

Risorse richieste:

GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519?key=YOUR-API-KEY

"Un utente non deve essere autenticato per recuperare un blog pubblico. L'applicazione non deve includere l'intestazione HTTP Authorization per una richiesta pubblica del blog, ma è necessario fornire la chiave API.

Blogger ha anche blog privati che richiedono l'autenticazione.

Risposta

Se la richiesta ha esito positivo, il server risponde con un codice di stato HTTP 200 OK e con i dati dei commenti:

{
  "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"
    }
  }
}

Utilizzare le pagine

Recupero delle pagine di un blog in corso...

Puoi recuperare un elenco di pagine di un blog inviando una richiesta GET all'URI di raccolta delle pagine. L'URI di una raccolta di pagine ha il seguente formato:

https://www.googleapis.com/blogger/v3/blogs/blogId/pages

Risorse richieste:

GET https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages?key=YOUR-API-KEY

"Un utente non deve essere autenticato per recuperare un blog pubblico. L'applicazione non deve includere l'intestazione HTTP Authorization per una richiesta pubblica del blog, ma è necessario fornire la chiave API.

Blogger ha anche blog privati che richiedono l'autenticazione.

Risposta

Se la richiesta ha esito positivo, il server risponde con un codice di stato HTTP 200 OK e con l'elenco delle 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 pagine. L'URI di una risorsa di pagina ha il seguente formato:

https://www.googleapis.com/blogger/v3/blogs/blogId/pages/pageId

Risorse richieste:

GET https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages/273541696466681878?key=YOUR-API-KEY

"Un utente non deve essere autenticato per recuperare un blog pubblico. L'applicazione non deve includere l'intestazione HTTP Authorization per una richiesta pubblica del blog, ma è necessario fornire la chiave API.

Blogger ha anche blog privati che richiedono l'autenticazione.

Risposta

Se la richiesta ha esito positivo, il server risponde con un codice di stato HTTP 200 OK e con 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 in corso...

Puoi recuperare le informazioni di un utente inviando una richiesta HTTP GET all'URI della risorsa utente:

https://www.googleapis.com/blogger/v3/users/userId

Risorse richieste:

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 ha esito positivo, il server risponde con un codice di stato HTTP 200 OK e con un link a un elenco dei blog degli utenti:

{
  "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 ricerca possono essere utilizzati con tutti i metodi e tutte le risorse presenti nelle API di Blogger.

I parametri di ricerca che si applicano a tutte le operazioni delle API di Blogger sono documentati in Parametri di sistema.