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 OAuthou 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:
- Quando seu aplicativo precisa de acesso aos dados do usuário, ele pede ao Google um escopo específico de acesso.
- O Google exibe uma tela de consentimento para o usuário, pedindo para que o aplicativo seja autorizado a solicitar alguns dos dados dele.
- Se o usuário aprovar, o Google fornecerá ao aplicativo um token de acesso de curta duração.
- O aplicativo solicita dados de usuário, anexando o token de acesso à solicitação.
- 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 chaveou 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.