API do Blogger: como usar a API

Com a API Blogger, é possível integrar o conteúdo do Blogger ao seu aplicativo usando as APIs REST. Antes de começar, você precisará configurar a autorização.

Introdução

Este documento é destinado a desenvolvedores que querem criar aplicativos que possam interagir com a API do Blogger. O Blogger é uma ferramenta para criar sites em que as pessoas podem publicar ideias continuamente.

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

Como autorizar solicitações e identificar seu aplicativo

Toda solicitação que seu aplicativo envia para as APIs do Blogger precisa identificá-lo 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 privados de um indivíduo), o aplicativo deverá fornecer um token OAuth 2.0 com a solicitação. O aplicativo também pode informar a chave de API, mas isso 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. Não há outros protocolos de autorização compatíveis. Se o aplicativo usa o 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 de dados de usuário não públicos às APIs do Blogger precisam ser autorizadas por um usuário autenticado.

Esse processo é facilitado com um ID do cliente OAuth.

Gerar um ID do cliente OAuth

Ou crie uma 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. O processo geral a seguir se aplica a todos os tipos de aplicativo:

  1. Quando seu aplicativo precisar de acesso aos dados do usuário, ele solicitará ao Google um determinado escopo do acesso.
  2. O Google exibe uma tela de consentimento ao 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 mais informações sobre fluxos de vários tipos de aplicativos, acesse a documentação OAuth 2.0 do Google.

Veja 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, seu aplicativo precisa de informações do escopo, bem como informações 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 incluir um identificador, que pode ser uma chave de API ou um token de acesso.

Acessar uma chave

Ou crie uma 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

Recuperar um blog

Para recuperar informações de um blog específico, envie uma solicitação GET HTTP para o 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 estar autenticado para recuperar um blog público. O aplicativo não precisa incluir o cabeçalho HTTP Authorization para uma solicitação de blog público. No entanto, você precisa fornecer a chave de API.

O Blogger também tem blogs particulares, 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": ""
  }
}

Recuperar um blog pelo URL

Para recuperar um blog usando o URL dele, envie 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 para o URI da coleção dos 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, você precisa 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 de 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": ""
      }
    }
  ]
}

Trabalhar com postagens

Recuperar postagens de um blog

Para recuperar uma lista de postagens de um determinado blog, envie uma solicitação GET para o 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

Confira um exemplo:

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

Um usuário não precisa estar autenticado para recuperar um blog público. O aplicativo não precisa incluir o cabeçalho HTTP Authorization para uma solicitação de blog público. No entanto, você precisa fornecer a chave de API.

O Blogger também tem blogs particulares, 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

Para recuperar uma postagem específica de um blog, envie uma solicitação GET ao 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 estar autenticado para recuperar um blog público. O aplicativo não precisa incluir o cabeçalho HTTP Authorization para uma solicitação de blog público. No entanto, você precisa fornecer a chave de API.

O Blogger também tem blogs particulares, 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"
  }
}

Como pesquisar uma postagem

Para pesquisar postagens em um blog, envie uma solicitação GET ao URI de pesquisa de postagens 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 estar autenticado para recuperar um blog público. O aplicativo não precisa incluir o cabeçalho HTTP Authorization para uma solicitação de blog público. No entanto, você precisa fornecer a chave de API.

O Blogger também tem blogs particulares, 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"
    }
  },
  ...
  ]
}

Adicionando uma postagem

Para adicionar uma postagem a um blog, envie uma solicitação POST para o URI de coleta 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 de 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"
 }
}

Excluir uma postagem

Para excluir uma postagem de um blog, envie uma solicitação DELETE para o URI do recurso de postagem:

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

Solicitação

Confira um exemplo:

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

Você precisa de 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 por caminho das postagens 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 estar autenticado para recuperar um blog público. O aplicativo não precisa incluir o cabeçalho HTTP Authorization para uma solicitação de blog público. No entanto, você precisa fornecer a chave de API.

O Blogger também tem blogs particulares, 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

Para atualizar uma postagem em um blog, envie uma solicitação PUT para o URI do recurso de postagem com um corpo JSON de 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 de 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

Para atualizar uma postagem com semântica de patch, envie uma solicitação PATCH para o URI do recurso post com um corpo post JSON:

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

Solicitação

Confira um 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 de 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 da 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 estar autenticado para recuperar um blog público. O aplicativo não precisa incluir o cabeçalho HTTP Authorization para uma solicitação de blog público. No entanto, você precisa fornecer a chave de API.

O Blogger também tem blogs particulares, 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
    }
  ]
}

Como 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 estar autenticado para recuperar um blog público. O aplicativo não precisa incluir o cabeçalho HTTP Authorization para uma solicitação de blog público. No entanto, você precisa fornecer a chave de API.

O Blogger também tem blogs particulares, 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 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

Para recuperar uma lista de páginas de um blog, envie uma solicitação GET ao URI da coleção de páginas. O URI de um conjunto 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 estar autenticado para recuperar um blog público. O aplicativo não precisa incluir o cabeçalho HTTP Authorization para uma solicitação de blog público. No entanto, você precisa fornecer a chave de API.

O Blogger também tem blogs particulares, 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

Para recuperar uma página específica de um blog, envie uma solicitação GET ao 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 estar autenticado para recuperar um blog público. O aplicativo não precisa incluir o cabeçalho HTTP Authorization para uma solicitação de blog público. No entanto, você precisa fornecer a chave de API.

O Blogger também tem blogs particulares, 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

Para recuperar as informações de um usuário, envie uma solicitação GET HTTP para o URI do recurso de usuários:

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 de 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 parâmetros de consulta a seguir 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.