Hoy inauguro la sección de Google APIs, con este artículo introductorio sobre Google Gadgets API. Un API que permite a cualquier desarrollador con conocimientos mínimos de HTML, JavaScript y XML construir sus propios gadgets de manera muy sencilla.

Que es Google Gadgets API

Los Google Gadgets, como ya sabrás, son mini-aplicaciones hechas en HTML y JavaScript que pueden ser embebidas en páginas web y otras aplicaciones (como iGoogle por ejemplo).

Google Gadgets API, es, como su nombre lo indica, un API que provee Google para crear gadgets.

Como se compone un Google Gadget

Un Google Gadget es un fichero XML:

[sourcecode language="xml"]< ?xml version="1.0" encoding="UTF-8" ?>



< ![CDATA[
Hello, world!
]]>

[/sourcecode]

Como podemos ver, no hay mucho que decir. La primera línea declaramos la versión y codificación de XML (nótese que utilizamos UTF-8 para poder escribir en cualquier lenguaje). El gadget está dentro de los tags y consta de las siguientes partes:

• Preferencias del gadget

  Define algunas propiedades del gadget (título, descripción, autor, etc.):

  [sourcecode language="xml"] author="Homer Simpson"
  author_email="homer@simpson.com"/> [/sourcecode]

  En este tag se pueden definir una serie de atributos, como title, author, author_email, description, thumbnail, entre otros.

• Contenido del gadget

  Es el contenido del gadget (HTML + JavaScript). La sección < ![CDATA[ ... ]]> es utilizada para indicarle al gadget que esa sección no sea tratada como XML. De esta manera se puede insertar código HTML y JavaScript.

  [sourcecode language="xml"]
  < ![CDATA[

  Hello, world!
  ]]>
  [/sourcecode]

  Además, en esta parte del gadget se pueden importar librerías:

  [sourcecode language="xml"][/sourcecode]

• Preferencias del usuario

  No la utilizamos en el ejemplo. Pero es bastante útil, ya que permite a los usuarios especificar determinados valores para el gadget:

  [sourcecode language="xml"] display_name="User Preference 1"
  datatype="enum"
  default_value="2">
  
  
  
  [/sourcecode]

  Es bastante simple, agregamos los tags asignándole un nombre con el atributo name, un tipo de dato con el atributo datatype, y un valor por defecto. En este caso, como elegimos el tipo de dato enum, definimos los tags para definir las opciones.

Como ejecutar el gadget

Para testear el gadget, podemos utilizar GGE (Google Gadgets Editor) que es un editor de gadgets que provee Google, para que los desarrolladores puedan testear fácilmente los gadgets.

Una vez testeado, hay que enviar el gadget a Google, puede añadirse a iGoogle o enviarse al directorio de gadgets de Google (tiene que ser aprobado).

Para añadir el gadget en nuestro sitio, simplemente utilizamos esta URL de Google pasándole por GET el fichero XML del gadget a añadir:

http://gmodules.com/ig/creator?synd=open&url=[gadget-url]

Por ejemplo:

http://gmodules.com/ig/creator?synd=open&url=http://hostexample.com/gadget.xml

Más información

Bueno, esto fue una introducción bastante resumida a la API de Google Gadgets, para más información no hay nada mejor que la guía oficial de la API de Google Gadgets