Importante: vamos descontinuar o suporte à API Google Data v2.0 em 30 de setembro de 2024. Para garantir a funcionalidade contínua, atualize os aplicativos que dependem da API Google Data v2.0 para a versão mais recente. Para a versão mais recente, use os links na barra de navegação à esquerda. Observação: algumas solicitações GET (como postagens de fichas de empresas) continuarão sendo compatíveis como URLs de feed, mas há pequenas diferenças no comportamento. Para informações detalhadas, consulte a documentação da Ajuda do Blogger.
Neste documento, apresentamos a documentação de referência detalhada sobre o protocolo bruto (XML e HTTP) da API Blogger Data.
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 de linguagem de programação do Guia para desenvolvedores.
Conteúdo
Público-alvo
Este documento é destinado a programadores que querem criar aplicativos clientes que possam interagir com o Blogger.
Trata-se de um documento de referência e pressupõe que você entenda os conceitos apresentados no Guia para desenvolvedores e as ideias gerais por trás do protocolo de APIs de dados do Google.
Tipos de feed do Blogger
O Blogger oferece duas representações do conteúdo do blog nos feeds: feeds completos e feeds de resumo. Um feed completo contém postagens completas do blog, enquanto um feed de resumo contém apenas um pequeno trecho de cada postagem.
O proprietário de um blog pode especificar, usando configurações de GUI, se o blog fornece 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 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 das especificações do proprietário do blog.
Referência de parâmetros de consulta do Blogger
A API Blogger Data é compatível com quase todos os parâmetros de consulta padrão da API Google Data.
O Blogger não oferece suporte ao parâmetro author.
Os parâmetros de consulta updated-min e updated-max são ignorados, a menos que orderby esteja 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 de dados do Blogger usa apenas elementos Atom padrão. Para mais informações, consulte a especificação do formato de distribuição Atom 1.0 e o protocolo de publicação Atom.
O restante desta seção fornece algumas observações específicas sobre o uso de alguns elementos padrão pelo Blogger.
Rascunhos
Uma entrada de rascunho de blog é marcada com 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://www.w3.org/2007/app'> ... <app:control> <app:draft>yes</app:draft> </app:control> </entry>
Se nenhum elemento <draft> for especificado, a entrada não é 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 cria uma nova entrada, se não especificar um valor para <published>, o Blogger define a data de postagem da entrada como o horário atual do servidor. Quando seu cliente edita uma entrada, mas não especifica um valor <published>, o Blogger não muda a data de 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 da entrada como o valor especificado. Isso pode ser útil para tarefas como a importação de entradas antigas de outro sistema de blog (enquanto mantém as datas de criação originais).
O Blogger usa o elemento Atom <updated> padrão para indicar quando uma entrada foi modificada pela última vez. O 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 o cliente publica ou edita uma entrada.
Você pode usar 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 ver observações 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 entre os dois tipos de entradas, o Blogger utiliza 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 extensão Atom Threading permite vincular a entrada do comentário à entrada a que ela pertence. 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 está vinculado ao URL HTML da postagem usando o parâmetro href.
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/"
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 comment</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>
Referência de esquema de feeds do Blogger
- Feed de lista de blogs
- Feed de postagens do blog
- Feed de comentários do blog
- Feed de comentários em postagens do blog