Te damos la bienvenida a la API de Google Gadgets. Esta guía para programadores va dirigida a las personas que deseen usar la API de Google Gadgets para crear un gadget. Los gadgets son tan fáciles de crear que resultan un punto de partida ideal para los que empiezan a formarse en programación web.
La forma más fácil de empezar a conocer esta API es ver un ejemplo. El gadget siguiente muestra el mensaje "Hello, world!":
<?xml version="1.0" encoding="UTF-8" ?>
<Module>
<ModulePrefs title="hello world example" />
<Content type="html">
<![CDATA[ Hello, world! ]]> </Content>
</Module>
Puedes ver la especificación del gadget aquí.
Para ejecutar este ejemplo:
El texto "hello.xml" es la abreviatura de la URL http://www.google.com/ig/modules/hello.xml. Puedes anotar la URL para cualquier especificación de gadget en el cuadro de texto Añadir por URL, incluidas las que tú o tus amigos escribáis (siempre que estén publicadas en un servidor web público).
Ten en cuenta lo siguiente sobre el ejemplo de "Hello World":
La API de Google Gadgets consta de unos sencillos bloques: XML, HTML y JavaScript. Para empezar, sólo necesitas unas nociones básicas de HTML. Nosotros te enseñaremos lo que necesites saber sobre XML para crear gadgets. Más adelante, a medida que crees gadgets más sofisticados, probablemente desearás aprender JavaScript si todavía no estás familiarizado con este lenguaje.
XML es un lenguaje de marcas de ámbito general que describe datos estructurados de un modo que tanto humanos como máquinas pueden leer y escribir.
XML es el lenguaje que se utiliza para escribir especificaciones de gadget. Un gadget es simplemente un archivo XML ubicado en algún punto de Internet donde Google puede encontrarlo. El archivo XML que especifica un gadget contiene instrucciones acerca de cómo procesarlo y ejecutarlo. El archivo XML puede contener todos los datos y códigos del gadget o referencias (URL) donde encontrar el resto de elementos.
HTML es el lenguaje de marcas que se utiliza para dar formato a las páginas de Internet. Normalmente, el contenido estático de un gadget se escribe en HTML. Este código es similar a XML, pero se usa para dar formato a documentos web, más que para describir datos estructurados.
JavaScript es un lenguaje de secuencias de comandos que se puede utilizar para añadir un comportamiento dinámico a los gadgets.
Nota: Anteriormente, los gadgets se denominaban módulos ("modules" en inglés), por lo que la palabra "Module" aparece en toda la API.
La forma más sencilla de empezar a crear gadgets es utilizar el bloc de notas. Este permite editar las especificaciones de gadget y hacer clic en Vista previa para ver los resultados en directo de los cambios sin salir de la guía para programadores. Existen diferentes formas de usar el bloc de notas:
De forma predeterminada, el bloc de notas contiene la especificación de gadget para "Hello World". Puedes modificar el título y el mensaje de "Hello World", por ejemplo:
<?xml version="1.0" encoding="UTF-8" ?> <Module> <ModulePrefs title="My first gadget" /> <Content type="html"> <![CDATA[ <B>Welcome to my first gadget!</B> ]]> </Content>
</Module>
Para ver el resultado de los cambios en el bloc de notas, haz clic en Vista previa. Al actualizar la página, la especificación del gadget "Hello World" original vuelve a aparecer en el bloc de notas. Bajo el bloc de notas hay vínculos a otros gadgets de muestra que puedes ver y editar.
Edítame. Haz clic en "Vista previa" para ver los cambios.
Utiliza esta guía de introducción para obtener información básica sobre los gadgets y experimentar con el bloc de notas. Cuando estés listo para el paso siguiente, ve a Creación de gadgets propios. Desde aquí puedes ir a Principios de programación o volver a la página principal de documentación para obtener una descripción general de las secciones y temas.
©2009 Google - Política de privacidad - Términos y condiciones - Acerca de Google
Última actualización: