Importante: El 30 de septiembre de 2024, se descontinuará la compatibilidad con la API de datos de Google v2.0. Para garantizar una funcionalidad continua, actualiza tus aplicaciones que usan la versión 2.0 de la API de datos de Google a la versión más reciente de la API. Para acceder a la versión más reciente, utiliza los vínculos en la barra de navegación de la izquierda. Nota: Si bien algunas solicitudes GET (como las publicaciones de fichas) se seguirán admitiendo como URLs de feed, existen pequeñas diferencias en su comportamiento. Para obtener información detallada, consulta la documentación de ayuda de Blogger.
En este documento, se brinda documentación de referencia detallada sobre 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 de 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 programadores que quieran crear aplicaciones cliente que puedan interactuar con Blogger.
Es un documento de referencia; se supone que comprendes los conceptos que se presentan en la guía para desarrolladores y las ideas generales detrás del protocolo de APIs de datos de Google.
Tipos de feed 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 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 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 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 configure como updated. Por ejemplo, la siguiente URL recupera todas las entradas de blog que se actualizaron desde el 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 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 de formato de distribución de Atom 1.0 y el Protocolo de publicación de Atom.
En el resto de esta sección, se proporcionan un par de notas específicas sobre el uso que hace 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 en 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 <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 del servidor actual. Cuando tu cliente edita una entrada, pero no especifica un valor de <published>, Blogger deja sola la fecha de entrada.
Sin embargo, si tu cliente especifica un valor para el elemento <published> cuando crea o edita una entrada, Blogger establece la fecha de entrada en el valor especificado. Esto puede ser útil para tareas como importar entradas antiguas desde otro sistema de blogs (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ó por última vez una entrada. Tu cliente no puede controlar el valor <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 published-min, published-max, updated-min y updated-max de la API de datos de Google para solicitar entradas según sus valores de <published> o <updated>. Sin embargo, para obtener notas sobre las consultas sobre fechas actualizadas, consulta la referencia de 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 Atom.
Para diferenciar entre los dos tipos de entradas, Blogger utiliza el elemento <atom:category>. Este elemento tendrá un parámetro term que refleja si la entrada es para una entrada o un comentario.
Además, la vinculación de la entrada de comentario con la entrada a la que pertenece se logra mediante el uso de la extensión Atom Threading. En
el siguiente ejemplo, el elemento <thr:in-reply-to> de la
entrada del 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/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>
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 la entrada de blog