Importante: esta é uma versão antiga desta página. Para a versão mais recente, use os links na barra de navegação do lado esquerdo.
Neste documento, apresentamos a documentação de referência detalhada para o protocolo bruto (XML e HTTP) da API de dados do Blogger.
Este documento não contém informações sobre as bibliotecas de cliente da linguagem de programação. Para informações de referência da biblioteca de cliente, consulte os links das seções específicas da linguagem de programação do guia do desenvolvedor.
Índice
Público-alvo
Este documento é destinado a programadores que querem criar aplicativos clientes que possam interagir com o Blogger.
É um documento de referência. Ele pressupõe que você entende os conceitos apresentados no guia do desenvolvedor e as ideias gerais por trás do protocolo das APIs de dados do Google.
Tipos de feed do Blogger
O Blogger oferece duas representações do conteúdo do blog em feeds: feeds completos e de resumo. Um feed completo contém postagens completas do blog, enquanto um feed de resumo contém apenas um pequeno snippet de cada postagem.
O proprietário de um blog pode especificar, usando as configurações da GUI, se o blog fornece um feed completo ou um feed de resumo para distribuidores e agregadores.
Quando seu app cliente envia uma solicitação não autenticada de um feed, ele recebe o tipo de feed que o proprietário do blog especificou.
No entanto, quando o app cliente envia uma solicitação autenticada, ele sempre recebe um feed completo, independentemente do que o proprietário do blog especificou.
Referência de parâmetros de consulta do Blogger
A API de dados do Blogger é compatível com quase todos os parâmetros de consulta padrão da API Google Data.
O Blogger não é compatível com os parâmetros q (pesquisa de texto) e
author.
Os parâmetros de consulta updated-min e updated-max
são ignorados, a menos que o parâmetro orderby esteja definido como
updated. Por exemplo, o URL a seguir recupera todas as postagens do blog que foram atualizadas de 16 de março de 2008 para 24 de março de 2008:
http://www.blogger.com/feeds/blogID/posts/default?updated-min=2008-03-16T00:00:00&updated-max=2008-03-24T23:59:59&orderby=updated
Referência de elementos do Blogger
A API Blogger Data usa apenas elementos Atom padrão. Para mais informações, consulte a especificação do formato de distribuição do Atom 1.0 e o protocolo Atom Publishing.
O restante desta seção fornece algumas observações específicas sobre o uso de alguns elementos padrão do Blogger.
Rascunhos de entradas
Uma entrada de rascunho do blog é marcada usando o elemento de extensão <app:draft>
definido no documento do Atom Publishing Protocol. Veja um exemplo de entrada de rascunho:
<entry xmlns:app='http://purl.org/atom/app#'> ... <app:control> <app:draft>yes</app:draft> </app:control> </entry>
Se nenhum elemento <draft> for especificado, a entrada não será
um rascunho.
Datas de publicação e de atualização
O carimbo de data/hora fornecido no elemento <published> padrão do Atom corresponde à "post date" que um usuário pode definir na
GUI do Blogger.
Quando seu cliente criar uma nova entrada, se o cliente não especificar um valor
para <published>, o Blogger definirá a data de publicação da entrada
como o horário atual do servidor. Quando seu cliente edita uma entrada, mas não especifica um valor <published>, o Blogger deixa somente a data da postagem da entrada.
No entanto, se o cliente especificar um valor para o elemento
<published> ao criar ou editar uma entrada, o Blogger definirá a data de postagem dela como o valor especificado. Isso pode ser útil
para tarefas como importar entradas antigas de outro sistema de blog (mantendo
as datas de criação originais).
O Blogger usa o elemento <updated> padrão do Atom para indicar quando uma entrada foi alterada pela última vez. Seu cliente não pode controlar o valor <updated>. O Blogger sempre define a data da última atualização da entrada como o horário atual do servidor sempre que seu cliente posta ou edita uma entrada.
Use os parâmetros de consulta padrão da API Google Data published-min, published-max, updated-min e updated-max para solicitar entradas com base nos valores <published> ou <updated>. No entanto,
para saber mais sobre as consultas em datas atualizadas, consulte a referência
dos parâmetros de consulta do Blogger.
Vincular comentários a postagens
O formato de exportação do Blogger contém postagens e entradas de comentários em um documento de feed Atom.
Para diferenciar os dois tipos de entrada, o Blogger usa o
elemento <atom:category>. Esse elemento terá um parâmetro term, que reflete se a entrada é de uma postagem ou de um comentário.
Além disso, a vinculação da entrada de comentário à entrada da postagem a que ela pertence é
realizada pelo uso da extensão Threading do Atom. No exemplo abaixo, o elemento <thr:in-reply-to> na entrada de comentário apontará para a postagem usando o identificador de entrada de postagem no parâmetro ref. Ele também cria um link para o URL HTML da postagem usando o parâmetro href.
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
xmlns:thr="http://purl.org/syndication/thread/1.0">
...
<-- A blog post entry -->
<entry>
<id>tag:blogger.com,1999:blog-blogID.post-postID</id>
<content type="html">This is my first post</content>
<link rel="alternate" type="text/html"
href="http://blogName.blogspot.com/2007/04/first-post.html">
</link>
<category scheme="http://schemas.google.com/g/2005#kind"
term="http://schemas.google.com/blogger/2008/kind#post"/>
...
</entry>
<-- A comment to the blog post entry -->
<entry>
<id>tag:blogger.com,1999:blog-blogID.post-postID.comment-commentID</id>
<content type="html">This is my first commment</content>
<category scheme="http://schemas.google.com/g/2005#kind"
term="http://schemas.google.com/blogger/2008/kind#comment"/>
<thr:in-reply-to href="http://blogName.blogspot.com/2007/04/first-post.html"
ref="tag:blogger.com,1999:blog-blogID.post-postID"
type="text/html"/>
...
</entry>
</feed>