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 para el protocolo sin procesar (XML y HTTP) de la API de Blogger Data.
Este documento no contiene información sobre las bibliotecas cliente de lenguaje de programación. Para obtener información de referencia de la biblioteca cliente, consulta los vínculos de las secciones específicas de cada lenguaje de programación de la guía para desarrolladores.
Contenido
Público
Este documento está dirigido a programadores que deseen escribir aplicaciones cliente que puedan interactuar con Blogger.
Es un documento de referencia que 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 Google Data.
Tipos de feeds de Blogger
Blogger proporciona dos representaciones del contenido de los blogs en los feeds: feeds completos y feeds de resumen. Un feed completo contiene entradas de blog completas, mientras que un feed de resumen solo contiene un fragmento corto de cada entrada.
El propietario de un blog puede especificar, mediante la configuración de la GUI, si el blog proporciona un feed completo o un feed de resumen a los agregadores y distribuidores.
Cuando tu app cliente envía una solicitud no autenticada para 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, independientemente de 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ándar 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 Blogger Data solo usa elementos Atom estándar. Para obtener más información, consulta la especificación del formato de sindicación de Atom 1.0 y el protocolo de publicación de Atom.
En el resto de esta sección, se proporcionan algunas notas específicas sobre el uso que hace Blogger de algunos elementos estándar.
Entradas de borrador
Un borrador de entrada de blog se marca con el elemento de extensión <app:draft> que se define en el documento del Protocolo de Publicación de Atom. Este es un
ejemplo de una entrada de 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 de actualización
La marca de tiempo que se proporciona 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 publicación de la entrada en la hora actual del servidor. Cuando tu cliente edita una entrada, pero no especifica un valor de <published>, Blogger deja la fecha de publicación de la entrada intacta.
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 de otro sistema de blogs (sin perder las fechas de creación originales).
Blogger usa el elemento <updated> estándar de Atom para indicar cuándo se cambió una entrada por última vez. Tu cliente no puede controlar el valor de <updated>. Blogger siempre establece la fecha de la última actualización de la entrada en 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 Google Data published-min, published-max, updated-min y updated-max para solicitar entradas según sus valores <published> o <updated>. Sin embargo, si quieres obtener notas sobre cómo consultar fechas actualizadas, consulta la referencia de parámetros de consulta de Blogger.
Cómo vincular comentarios a publicaciones
El formato de exportación de Blogger contiene entradas de publicaciones y comentarios en un documento de feed de Atom.
Para diferenciar entre los dos tipos de entradas, Blogger usa el elemento <atom:category>. Este elemento tendrá un parámetro term que refleja si la entrada es para una publicación o un comentario.
Además, la vinculación de la entrada de comentario a la entrada de publicación a la que pertenece se realiza mediante el uso de la extensión de subprocesos de Atom. En el siguiente ejemplo, el elemento <thr:in-reply-to> en la entrada de comentario apuntará a la publicación mediante el identificador de entrada de publicación en el parámetro ref. También vincula a la URL HTML de la publicación 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>