Importante: Esta es una versión antigua de esta página. Para obtener la versión más reciente, usa los vínculos de la barra de navegación de la izquierda.
En este documento, se proporciona documentación de referencia detallada del protocolo sin procesar (XML y HTTP) de la API de datos de Blogger.
Este documento no contiene información sobre las bibliotecas cliente del lenguaje de programación. Para obtener información de referencia sobre la biblioteca cliente, consulta los vínculos de las secciones específicas del lenguaje de programación de la Guía para desarrolladores.
Contenido
Público
Este documento está dirigido a los programadores que desean escribir aplicaciones cliente que puedan interactuar con Blogger.
Es un documento de referencia y en él se supone que comprendes los conceptos que se presentan en la Guía para desarrolladores y las ideas generales detrás del protocolo de las APIs de datos de Google.
Tipos de feeds de Blogger
Blogger ofrece dos representaciones del contenido de blogs en los feeds: feeds completos y feeds de resumen. Un feed completo contiene entradas de blog completas, mientras que un feed de resumen contiene solo un fragmento corto de cada entrada.
Con la configuración de la GUI, el propietario de un blog puede especificar si el blog proporciona un feed completo o un feed de resumen a los distribuidores y agregadores.
Cuando tu app cliente envía una solicitud no autenticada de un feed, recibe el tipo de feed que especificó el propietario del blog.
Sin embargo, cuando tu app cliente envía una solicitud autenticada, siempre recibe un feed completo, sin importar lo que haya especificado el propietario del blog.
Referencia de los parámetros de consulta de Blogger
La API de datos de Blogger admite casi todos los parámetros de consulta estándares de la API de datos de Google.
Blogger no admite los parámetros q (búsqueda de texto) ni author.
Los parámetros de consulta updated-min y updated-max se ignoran, a menos que el parámetro orderby se establezca en updated. Por ejemplo, la siguiente URL recupera todas las entradas de blog que se actualizaron del 16 de marzo de 2008 al 24 de marzo 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
Referencia de los elementos de Blogger
La API de datos de Blogger usa solo elementos estándar de Atom. Para obtener más información, consulta la especificación de formato de distribución de Atom 1.0 y el Protocolo de publicación de Atom.
El resto de esta sección proporciona un par de notas específicas sobre el uso de Blogger de algunos elementos estándar.
Entradas en borrador
Una entrada de blog en borrador se marca con el elemento de extensión <app:draft> definido en el documento del protocolo de publicación de Atom. Este es un ejemplo de una entrada borrador:
<entry xmlns:app='http://purl.org/atom/app#'> ... <app:control> <app:draft>yes</app:draft> </app:control> </entry>
Si no se especifica ningún elemento <draft>, la entrada no es un borrador.
Fechas de publicación y fechas actualizadas
La marca de tiempo proporcionada en el elemento <published> estándar de Atom corresponde a la "fecha de publicación" que un usuario puede establecer en la GUI de Blogger.
Cuando tu cliente crea una entrada nueva, si no especifica un valor para <published>, Blogger establece la fecha de entrada de la entrada en la hora actual del servidor. Cuando tu cliente edita una entrada, pero no especifica un valor de <published>, Blogger no modifica la fecha de publicación de la entrada.
Sin embargo, si tu cliente especifica un valor para el elemento <published> cuando crea o edita una entrada, Blogger establece la fecha de publicación de la entrada en el valor especificado. Esto puede ser útil
para tareas como importar entradas antiguas desde otro sistema de blog (y, al mismo tiempo, mantener
las fechas de creación originales).
Blogger usa el elemento estándar <updated> de Atom para indicar cuándo se modificó una entrada por última vez. Tu cliente no puede controlar el valor de <updated>; Blogger siempre establece la fecha de última actualización de la entrada a la hora actual del servidor cada vez que tu cliente publica o edita una entrada.
Puedes usar los parámetros de consulta estándar de la API de datos de Google published-min, published-max, updated-min y updated-max para solicitar entradas basadas en sus valores <published> o <updated>. Sin embargo, para ver las notas sobre las consultas en fechas actualizadas, consulta la referencia de los parámetros de consulta de Blogger.
Vinculación de comentarios a publicaciones
El formato de exportación de Blogger contiene entradas y entradas de comentarios en un documento de feed de Atom.
Para diferenciar los dos tipos de entradas, Blogger utiliza el elemento <atom:category>. Este elemento tendrá un
parámetro term que refleja si la entrada es de una entrada o un
comentario.
Además, la vinculación de la entrada de comentario con la entrada de entrada a la que pertenece se logra mediante el uso de Atom Threading Extension. En el siguiente ejemplo, el elemento <thr:in-reply-to> de la entrada de comentario apuntará a la entrada mediante el identificador de entrada de la entrada en el parámetro ref. También vincula a la URL HTML de la entrada a través del
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>