Importante: esta é uma versão antiga desta página. Para usar a versão mais recente, use os links na barra de navegação à esquerda.
Este documento fornece uma documentação de referência detalhada do protocolo bruto (XML e HTTP) para a API Data do Blogger.
Este documento não contém informações sobre as bibliotecas de cliente de linguagem de programação. Para informações de referência sobre a biblioteca de cliente, consulte os links das seções específicas da linguagem de programação do guia do desenvolvedor.
Conteúdo
Público-alvo
Este documento é destinado a programadores que querem criar aplicativos clientes que possam interagir com o Blogger.
É um documento de referência que pressupõe que você entenda os conceitos apresentados no guia para desenvolvedores e as ideias gerais por trás do protocolo das APIs Data do Google.
Tipos de feed do Blogger
O Blogger oferece duas representações do conteúdo do blog em feeds: feeds completos e resumidos. Um feed completo contém postagens completas do blog, enquanto um feed de resumo contém apenas um trecho curto 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 resumo para syndicators e agregadores.
Quando o app cliente envia uma solicitação não autenticada para um feed, ele recebe qualquer tipo de feed especificado pelo proprietário do blog.
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 Data do Blogger oferece suporte a quase todos os parâmetros de consulta padrão da API Data do Google.
O Blogger não oferece suporte aos 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 seja 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 a 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 Data do Blogger usa apenas elementos Atom padrão. Para mais informações, consulte a especificação do formato de distribuição 1.0 do Atom e o Atom Publishing Protocol.
O restante desta seção oferece algumas notas específicas sobre o uso de alguns elementos padrão pelo 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. Confira um
exemplo de uma 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 à "data de postagem" que um usuário pode definir na
GUI do Blogger.
Quando o cliente cria uma nova entrada, se ele não especifica um valor
para <published>, o Blogger define a data de postagem da entrada como
a hora atual do servidor. Quando o cliente edita uma entrada, mas não especifica um
valor <published>, o Blogger não altera a data de publicação
da entrada.
No entanto, se o cliente especificar um valor para o
elemento <published> ao criar ou editar uma entrada, o Blogger vai definir a data de postagem da entrada como o valor especificado. Isso pode ser útil
para tarefas como importar entradas antigas de outro sistema de blogs (mantendo
as datas de criação originais).
O Blogger usa o elemento <updated> Atom padrão para
indicar quando uma entrada foi alterada pela última vez. Seu cliente não pode controlar o
valor de <updated>. O Blogger sempre define a data da última atualização
da entrada para a hora atual do servidor sempre que seu cliente publica ou edita uma
entrada.
É possível usar os parâmetros de consulta published-min,
published-max, updated-min e
updated-max da API Data do Google padrão para solicitar entradas com base nos
valores <published> ou <updated>. No entanto,
para notas sobre consultas em datas atualizadas, consulte a Referência de 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 entradas, o Blogger usa o
elemento <atom:category>. Esse elemento terá um
parâmetro term que reflete se a entrada é para uma postagem ou um
comentário.
Além disso, a vinculação da entrada de comentário à entrada de postagem a que ela pertence é
feita usando a extensão de encadeamento do Atom. No
exemplo abaixo, o elemento <thr:in-reply-to> na entrada de
comentário vai apontar para a postagem usando o identificador de entrada de postagem no
parâmetro ref. Ele também vincula ao URL HTML da postagem pelo
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>