Welcome to the gadgets API! To learn more about different types of gadgets and where they run, see the gadgets API Overview.
This developers guide is intended for people who want to use the gadgets API to write gadgets. Gadgets are so easy to create that they are a good starting point if you are just learning about web programming.
The simplest gadget is just a few lines of code. This gadget displays the message "Hello, world!":
<?xml version="1.0" encoding="UTF-8" ?>
<ModulePrefs title="hello world example" />
<![CDATA[ Hello, world! ]]> </Content>
Note the following about the "Hello World" example:
- Gadgets are specified in XML. The first line is the standard way to start an XML file. This must be the first line in the file.
<Module>tag indicates that this XML file contains a gadget.
<ModulePrefs>tag contains information about the gadget such as its title, description, author, and other optional features.
- The line
<Content type="html">indicates that the gadget's content type is HTML.
<![CDATA[ ...insert HTML here... ]]>is used to enclose HTML when a gadget's content type is
</Content>signifies the end of the Content section.
</Module>signifies the end of the gadget definition.
What's In a Gadget?
XML is a general purpose markup language. It describes structured data in a way that both humans and computers can read and write.
XML is the language you use to write gadget specifications. A gadget is simply an XML file, placed somewhere on the internet where Google can find it. The XML file that specifies a gadget contains instructions on how to process and render the gadget. The XML file can contain all of the data and code for the gadget, or it can have references (URLs) for where to find the rest of the elements.
HTML is the markup language used to format pages on the internet. The static content of a gadget is typically written in HTML. HTML looks similar to XML, but it's used to format web documents rather than to describe structured data.
Where to Go From Here
For general gadget programming information, go to Writing Your Own Gadgets. From there you can go to Development Fundamentals.