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.
Este documento oferece documentação de referência detalhada para o protocolo bruto (XML e HTTP) para a API de dados do Blogger.
Este documento não contém informações sobre as bibliotecas de cliente de linguagem de programação. Para obter informações de referência da biblioteca cliente, consulte os links de seções específicas de linguagem de programação do guia do desenvolvedor.
Conteúdo
Público-alvo
Este documento é destinado a programadores que desejam escrever código de aplicativos que podem interagir com o Blogger.
É um documento de referência; ele pressupõe que você entende os conceitos apresentado no Guia para desenvolvedores e as ideias gerais por trás das APIs de dados do Google protocolo.
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 do blog completas, enquanto um feed de resumo contém somente um pequeno trecho de cada postagem.
O proprietário de um blog pode especificar, usando as configurações da GUI, se o blog fornece uma um feed completo ou um feed de resumo para distribuidores 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 aplicativo cliente envia uma solicitação autenticada, ela sempre recebe um feed completo, independentemente do que o proprietário do blog tiver especificado.
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 às opções q (pesquisa de texto) e
Parâmetros 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 fornece algumas observações específicas sobre as configurações o uso de alguns elementos padrão.
Rascunhos de inscrições
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 um rascunho de inscrição:
<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 seu cliente criar uma nova entrada, se 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
<published>, o Blogger deixa a data da postagem
sozinhos.
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 <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
A exportação do Blogger
formato 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
O 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ários à entrada de postagens a que 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 está vinculado ao URL HTML da postagem por meio do elemento
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>