API do Blogger: como usar a API

A API do Blogger permite integrar o conteúdo do Blogger ao seu aplicativo usando as APIs REST. Antes de começar, é preciso configurar a autorização.

Introdução

Este documento é destinado aos desenvolvedores que querem criar aplicativos que possam interagir com a API do Blogger. O Blogger é uma ferramenta para criar sites que permitem que as pessoas publiquem opiniões em base contínua.

Se você não conhece os conceitos do Blogger, leia Primeiros passos antes de começar a programar.

Como autorizar solicitações e identificar o aplicativo

Cada solicitação que o seu aplicativo envia às APIs do Blogger precisa identificar o seu aplicativo para o Google. Há duas maneiras de identificar o aplicativo: usando o token OAuth 2.0, que também autoriza a solicitação, e/ou usando a chave de API do aplicativo. Veja como determinar a melhor opção para você:

  • Se a solicitação exigir autorização, como uma solicitação de dados particulares de um indivíduo, o aplicativo precisará fornecer um token do OAuth 2.0 com a solicitação. O aplicativo também pode fornecer a chave de API, mas não é obrigatório.
  • Se a solicitação não exige autorização, como uma solicitação de dados públicos, o aplicativo precisa fornecer a chave de API, um token OAuth 2.0 ou ambos, dependendo do que for mais conveniente para você.

Sobre protocolos de autorização

O aplicativo deve obrigatoriamente usar o OAuth 2.0 para autorizar solicitações. Nenhum outro protocolo de autorização é aceito. Se o aplicativo usa o recurso Fazer login com o Google, alguns aspectos da autorização são administrados para você.

Autorizar solicitações com OAuth 2.0

As solicitações para as APIs do Blogger sobre dados de usuários não públicos precisam ser autorizadas por um usuário autenticado.

Esse processo é facilitado com um ID do cliente OAuth.

Acessar um ID do cliente OAuth

ou criar um na página Credenciais.

Os detalhes do processo de autorização ou “fluxo” para o OAuth 2.0 variam um pouco, dependendo do tipo de aplicativo que você está criando. Este processo geral se aplica a todos os tipos de aplicativos:

  1. Quando seu aplicativo precisa de acesso aos dados do usuário, ele pede ao Google um escopo específico de acesso.
  2. O Google exibe uma tela de consentimento para o usuário, pedindo para que o aplicativo seja autorizado a solicitar alguns dos dados dele.
  3. Se o usuário aprovar, o Google fornecerá ao aplicativo um token de acesso de curta duração.
  4. O aplicativo solicita dados de usuário, anexando o token de acesso à solicitação.
  5. Se o Google determinar que a solicitação e o token são válidos, ele retornará os dados solicitados.

Alguns fluxos incluem etapas adicionais, como atualizar tokens para adquirir novos tokens de acesso. Para ver informações detalhadas sobre fluxos de vários tipos de aplicativos, consulte a documentação do OAuth 2.0 do Google.

Estas são as informações de escopo do OAuth 2.0 para as APIs do Blogger:

https://www.googleapis.com/auth/blogger

Para solicitar acesso usando o OAuth 2.0, você precisa das informações do escopo, bem como as fornecidas pelo Google durante o registro do aplicativo, como o ID e a chave secreta do cliente.

Dica: as bibliotecas cliente de APIs do Google cuidam de parte do processo de autorização para você. Elas estão disponíveis para uma grande variedade de linguagens de programação. Verifique a página com bibliotecas e amostras para mais detalhes.

Como receber e usar uma chave de API

As solicitações de dados públicos às APIs do Blogger precisam ser acompanhadas por um identificador, que pode ser uma chave de API ou um token de acesso.

Gerar uma chave

ou criar um na página Credenciais.

Depois que você tiver uma chave de API, seu aplicativo poderá anexar o parâmetro de consulta key=yourAPIKey a todos os URLs de solicitação.

A chave de API é segura para ser incorporada a URLs sem precisar de codificação.

Como trabalhar com blogs

Como recuperar um blog

É possível recuperar informações de um blog específico enviando uma solicitação GET HTTP ao URI do blog. O URI de um blog tem o seguinte formato:

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

Solicitação

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

Um usuário não precisa ser autenticado para recuperar um blog público. O aplicativo não precisa incluir o cabeçalho HTTP Authorization em uma solicitação pública de blog. No entanto, é necessário informar a chave de API.

O Blogger também tem blogs privados, que exigem autenticação.

Resposta

Se a solicitação for bem-sucedida, o servidor responderá com um código de status HTTP 200 OK e os dados do 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": ""
  }
}

Como recuperar um blog pelo URL

É possível recuperar um blog usando o URL enviando uma solicitação GET HTTP para o seguinte URI com um parâmetro url:

https://www.googleapis.com/blogger/v3/blogs/byurl?url=blog-url

Solicitação

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

Resposta

Se a solicitação for bem-sucedida, o servidor responderá com um código de status HTTP 200 OK e a representação completa do blog identificado:

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

Como recuperar os blogs de um usuário

Para recuperar uma lista dos blogs de um usuário, envie uma solicitação GET HTTP ao URI da coleção de blogs:

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

Solicitação

GET https://www.googleapis.com/blogger/v3/users/self/blogs
Authorization: /* OAuth 2.0 token here */

Observação: o usuário precisa ser autenticado para listar os próprios blogs. Portanto, é necessário fornecer o cabeçalho HTTP Authorization com a solicitação GET.

Resposta

Se a solicitação for bem-sucedida, o servidor responderá com um código de status HTTP 200 OK e a representação completa da lista dos blogs do usuário:

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

Como trabalhar com postagens

Recuperar postagens de um blog

Para recuperar uma lista de postagens de um determinado blog, envie uma solicitação GET ao URI da coleção de postagens. O URI de uma coleção de postagens tem o seguinte formato:

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

Solicitação

Exemplo:

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

Um usuário não precisa ser autenticado para recuperar um blog público. O aplicativo não precisa incluir o cabeçalho HTTP Authorization em uma solicitação pública de blog. No entanto, é necessário informar a chave de API.

O Blogger também tem blogs privados, que exigem autenticação.

Resposta

Se a solicitação for bem-sucedida, o servidor responderá com um código de status HTTP 200 OK e a lista de postagens:

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

Recuperar uma postagem específica

É possível recuperar uma postagem específica de um blog enviando uma solicitação GET para o URI do recurso de postagens. O URI de um recurso de postagens tem o seguinte formato:

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

Solicitação

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

Um usuário não precisa ser autenticado para recuperar um blog público. O aplicativo não precisa incluir o cabeçalho HTTP Authorization em uma solicitação pública de blog. No entanto, é necessário informar a chave de API.

O Blogger também tem blogs privados, que exigem autenticação.

Resposta

Se a solicitação for bem-sucedida, o servidor responderá com um código de status HTTP 200 OK e o conteúdo da postagem:

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

Pesquisando uma postagem

Para pesquisar postagens de um blog, envie uma solicitação GET para o URI de pesquisa de postagem com o parâmetro de consulta de pesquisa q:

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

Solicitação

GET https://www.googleapis.com/blogger/v3/blogs/3213900/posts/search?q=documentation&key=YOUR-API-KEY

Um usuário não precisa ser autenticado para recuperar um blog público. O aplicativo não precisa incluir o cabeçalho HTTP Authorization em uma solicitação pública de blog. No entanto, é necessário informar a chave de API.

O Blogger também tem blogs privados, que exigem autenticação.

Resposta

Se a solicitação for bem-sucedida, o servidor responderá com um código de status HTTP 200 OK e o conteúdo da postagem:

{
  "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"
    }
  },
  ...
  ]
}

Como adicionar uma postagem

É possível adicionar uma postagem de blog. Basta enviar uma solicitação POST ao URI da coleção de postagens com um corpo JSON de postagem:

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

Solicitação

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

Você precisa ter feito a autenticação para criar uma postagem.

Resposta

Se a solicitação for bem-sucedida, o servidor responderá com um código de status HTTP 200 OK e o conteúdo da postagem:

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

Como excluir uma postagem

É possível excluir uma postagem de um blog enviando uma solicitação DELETE para o URI do recurso de postagem:

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

Solicitação

Exemplo:

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

Você precisa ter uma autenticação para excluir uma postagem.

Resposta

Se a solicitação for bem-sucedida, o servidor responderá com um código de status HTTP 200 OK.

Como recuperar uma postagem pelo caminho

Para recuperar uma postagem de um blog, envie uma solicitação GET ao URI de postagens por caminho com um parâmetro path. O URI de uma solicitação de postagens por caminho tem o seguinte formato:

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

Solicitação

https://www.googleapis.com/blogger/v3/blogs/2399953/posts/bypath?path=/2011/08/latest-updates-august-1st.html&key=YOUR-API-KEY

Um usuário não precisa ser autenticado para recuperar um blog público. O aplicativo não precisa incluir o cabeçalho HTTP Authorization em uma solicitação pública de blog. No entanto, é necessário informar a chave de API.

O Blogger também tem blogs privados, que exigem autenticação.

Resposta

Se a solicitação for bem-sucedida, o servidor responderá com um código de status HTTP 200 OK e o conteúdo da postagem:

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

Atualizar uma postagem

É possível atualizar uma postagem de um blog enviando uma solicitação PUT para o URI do recurso de postagem com um corpo JSON da postagem:

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

Solicitação

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

Você precisa ter feito a autenticação para atualizar uma postagem.

Resposta

Se a solicitação for bem-sucedida, o servidor responderá com um código de status HTTP 200 OK e o conteúdo da postagem:

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

Como atualizar uma postagem com semântica de patch

É possível atualizar uma postagem com semântica de patch enviando uma solicitação PATCH para o URI do recurso de postagem com um corpo JSON da postagem:

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

Solicitação

Exemplo:

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

Você precisa ter feito a autenticação para atualizar uma postagem.

Resposta

Se a solicitação for bem-sucedida, o servidor responderá com um código de status HTTP 200 OK e o conteúdo da postagem:

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

Como trabalhar com comentários

Recuperar comentários de uma postagem

Para recuperar uma lista de comentários de uma postagem, envie uma solicitação GET para o URI de coleta de comentários. O URI de uma coleção de comentários tem o seguinte formato:

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

Solicitação

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

"Um usuário não precisa ser autenticado para recuperar um blog público. O aplicativo não precisa incluir o cabeçalho HTTP Authorization em uma solicitação pública de blog. No entanto, é necessário informar a chave de API.

O Blogger também tem blogs privados, que exigem autenticação.

Resposta

Se a solicitação for bem-sucedida, o servidor responderá com um código de status HTTP 200 OK e a lista de comentários:

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

Recuperar um comentário específico

Para recuperar um comentário específico de uma postagem, envie uma solicitação GET para o URI do recurso de comentários. O URI de um recurso de comentários tem o seguinte formato:

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

Solicitação

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

"Um usuário não precisa ser autenticado para recuperar um blog público. O aplicativo não precisa incluir o cabeçalho HTTP Authorization em uma solicitação pública de blog. No entanto, é necessário informar a chave de API.

O Blogger também tem blogs privados, que exigem autenticação.

Resposta

Se a solicitação for bem-sucedida, o servidor responderá com um código de status HTTP 200 OK e os dados de comentário:

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

Como trabalhar com páginas

Recuperar páginas de um blog

É possível recuperar uma lista de páginas de um blog enviando uma solicitação GET para o URI de coleta de páginas. O URI de uma coleção de páginas tem o seguinte formato:

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

Solicitação

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

"Um usuário não precisa ser autenticado para recuperar um blog público. O aplicativo não precisa incluir o cabeçalho HTTP Authorization em uma solicitação pública de blog. No entanto, é necessário informar a chave de API.

O Blogger também tem blogs privados, que exigem autenticação.

Resposta

Se a solicitação for bem-sucedida, o servidor responderá com um código de status HTTP 200 OK e a lista de páginas:

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

Como recuperar uma página específica

É possível recuperar uma página específica de um blog enviando uma solicitação GET para o URI do recurso de páginas. O URI de um recurso de páginas tem o seguinte formato:

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

Solicitação

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

"Um usuário não precisa ser autenticado para recuperar um blog público. O aplicativo não precisa incluir o cabeçalho HTTP Authorization em uma solicitação pública de blog. No entanto, é necessário informar a chave de API.

O Blogger também tem blogs privados, que exigem autenticação.

Resposta

Se a solicitação for bem-sucedida, o servidor responderá com um código de status HTTP 200 OK e os dados da página:

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

Como trabalhar com usuários

Como recuperar um usuário

É possível recuperar as informações de um usuário enviando uma solicitação GET HTTP para o URI do recurso dele:

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

Solicitação

GET https://www.googleapis.com/blogger/v3/users/self
Authorization: /* OAuth 2.0 token here */

Observação: o usuário precisa ser autenticado para listar as próprias informações. Portanto, é necessário fornecer o cabeçalho HTTP Authorization com a solicitação GET.

Resposta

Se a solicitação for bem-sucedida, o servidor responderá com um código de status HTTP 200 OK e um link para uma lista dos blogs do usuário:

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

Parâmetros de consulta padrão

Os seguintes parâmetros de consulta podem ser usados com todos os métodos e recursos nas APIs do Blogger.

Os parâmetros de consulta que se aplicam a todas as operações das APIs do Blogger estão documentados em Parâmetros do sistema.