Este documento proporciona documentación de referencia detallada para el protocolo sin procesar (XML y HTTP) para 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 del desarrollador.
Contenido
Público
Este documento está dirigido a programadores que desean escribir aplicaciones cliente que pueden interactuar con Blogger.
Es un documento de referencia; se supone que comprendes los conceptos presentados en la guía para desarrolladores y las ideas generales detrás del protocolo de las API de datos de Google.
Tipos de feed de Blogger
Blogger proporciona dos representaciones del contenido del blog 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.
El propietario de un blog puede especificar, mediante la configuración de la GUI, si el blog proporciona un feed completo o un 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 el propietario del blog especificó.
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 búsqueda de Blogger
La API de datos de Blogger admite casi todos los parámetros de búsqueda de la API de datos de Google estándar.
Blogger no admite el parámetro 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 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 solo usa elementos Atom estándar. Para obtener más información, consulta la especificación del formato de distribución de Atom 1.0 y el Protocolo de publicación de Atom.
El resto de esta sección proporciona algunas notas específicas sobre el uso de algunos elementos estándar de Blogger.
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 Atom. Este es un ejemplo de una entrada de borrador:
<entry xmlns:app='http://www.w3.org/2007/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 Atom <published> estándar 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 <published>, Blogger deja la fecha de entrada de la entrada sola.
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 (sin modificar las fechas de creación originales).
Blogger usa el elemento Atom <updated> estándar para indicar cuándo se modificó una entrada por última vez. Tu cliente no puede controlar el valor <updated>. Blogger siempre establece la última fecha de 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 búsqueda published-min, published-max, updated-min y updated-max de la API de datos estándar de Google para solicitar entradas en función de sus valores <published> o <updated>. Sin embargo, para obtener notas sobre las consultas sobre fechas actualizadas, revisa la referencia de los parámetros de consulta de Blogger.
Cómo vincular comentarios a publicaciones
El formato de exportación de Blogger contiene entradas y entradas de comentarios en un documento de feed 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, el vínculo de la entrada de comentario con la entrada a la que pertenece se logra mediante el uso de la extensión de subprocesos 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 entrada en el parámetro ref. También se 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/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 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>
Referencia del esquema de feeds de Blogger
- Feed de lista de blogs
- Feed de entradas del blog
- Feed de comentarios del blog
- Feed de comentarios de entradas de blog