Importante: esta é uma versão antiga da página. Para a versão mais recente, use os links na barra de navegação do lado esquerdo.
Neste documento, você encontra a documentação de referência detalhada do protocolo bruto (XML e HTTP) da API Blogger Data.
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 para desenvolvedores.
Conteúdo
Público
Este documento é destinado a programadores que querem criar aplicativos clientes que possam interagir com o Blogger.
Ele é um documento de referência e pressupõe que você entende os conceitos apresentados no Guia para desenvolvedores 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 feeds de resumo. Um feed completo contém postagens de blog completas, enquanto um feed de resumo contém apenas um pequeno trecho 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 o aplicativo cliente envia uma solicitação não autenticada para um feed, ele recebe o 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 tenha especificado.
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 de dados 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 seguinte URL 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 Blogger Data usa apenas elementos Atom padrão. Para mais informações, consulte a especificação de formato de distribuição Atom 1.0 e o protocolo de publicação Atom.
O restante desta seção apresenta algumas observações específicas sobre o uso de alguns elementos padrão pelo Blogger.
Rascunhos de inscrições
Uma entrada de blog de rascunho é marcada usando o elemento de extensão <app:draft> definido no documento do Atom Publishing Protocol. Veja 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 datas atualizadas
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 criar uma nova entrada e não especificar um valor para <published>, o Blogger definirá a data de postagem da entrada como o horário atual do servidor. Quando o cliente edita uma entrada, mas não especifica um valor <published>, o Blogger não altera a data da postagem.
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 da entrada com 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 Atom <updated> padrão 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 a hora atual do servidor sempre que seu cliente posta ou edita uma entrada.
Use os parâmetros de consulta padrão published-min, published-max, updated-min e updated-max da API Google Data para solicitar entradas com base nos valores <published> ou <updated>. No entanto,
para observações sobre consultas em datas atualizadas, consulte a Referência de parâmetros
de consulta do Blogger.
Como 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 é de uma postagem ou de um comentário.
Além disso, a vinculação da entrada de comentário à entrada a que ela pertence é
feita com o uso da extensão Atom Threading. No exemplo abaixo, o elemento <thr:in-reply-to> na entrada do comentário apontará para a postagem usando o identificador de entrada da postagem no parâmetro ref. Ele também é vinculado ao URL HTML da postagem por meio do 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>