API di Blogger: utilizzo dell'API

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 OAuth

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

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

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