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 brinda documentación de referencia detallada del protocolo sin procesar (XML y HTTP) para la API de datos de Blogger.
Este documento no contiene información sobre el lenguaje de programación bibliotecas cliente. 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 código de que pueden 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 Contiene solo un fragmento breve de cada publicación.
El propietario de un blog puede especificar mediante la configuración de la GUI si el blog proporciona un feed completo o de resumen a los distribuidores y agregadores.
Cuando tu app cliente envía una solicitud no autenticada para un feed, recibe cualquier tipo de feed que haya especificado 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 todos los datos de la
Publicaciones actualizadas del 16 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 Atom estándar. para obtener más información puedes ver la columna Atom Especificación del formato de distribución 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 en 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 entrada 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 desde otro sistema de blogs (y mantener
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 <updated>; Blogger siempre establece la última actualización
con la hora actual del servidor cada vez que tu cliente publique o edite un
entrada.
Puedes usar published-min de la API de datos estándar de Google.
published-max, updated-min y
updated-max parámetros de consulta para solicitar entradas según su
Valores <published> o <updated>. Sin embargo,
Para ver notas sobre consultas en fechas actualizadas, visita Blogger
referencia de los parámetros de consulta.
Cómo vincular comentarios a publicaciones
La exportación de Blogger
formato contiene entradas y entradas de comentarios en un documento del 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 de una entrada o una
comentario.
Además, vincular la entrada de comentario con la entrada de la entrada a la que pertenece es
lograste mediante el uso de Atom Threading Extension. En la
ejemplo a continuación, el elemento <thr:in-reply-to> en el comentario
entrada apuntará a la entrada utilizando el identificador de entrada de la entrada en la
Parámetro ref. También vincula a la URL HTML de la entrada a través de la
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>