Começar a criar gadgets

Esta é a API de gadgets! Para saber mais sobre os diferentes tipos de gadgets e onde eles são executados, consulte a Visão geral da API de gadgets.

Este guia para desenvolvedores é destinado a pessoas que querem usar a API de gadgets para criar gadgets. Os gadgets são tão fáceis de criar que são um bom ponto de partida se você está aprendendo sobre programação da Web.

"Hello, World"

O gadget mais simples são apenas algumas linhas de código. Este gadget exibe a mensagem "Hello, world!": 

<?xml version="1.0" encoding="UTF-8" ?> 
<Module>
  <ModulePrefs title="hello world example" /> 
  <Content type="html">
     <![CDATA[ 
       Hello, world!
     ]]>
  </Content> 
</Module>

Observe o seguinte sobre o exemplo "Hello World":

  • Os gadgets são especificados em XML. A primeira linha é a forma padrão de iniciar um arquivo XML. Precisa ser a primeira linha do arquivo.
  • A tag <Module> indica que este arquivo XML contém um gadget.
  • A tag <ModulePrefs> contém informações sobre o gadget, como título, descrição, autor e outros recursos opcionais.
  • A linha <Content type="html"> indica que o tipo de conteúdo do gadget é HTML.
  • <![CDATA[ ...insert HTML here... ]]> é usado para incluir HTML quando o tipo de conteúdo de um gadget é html. Ele informa ao analisador de gadget que o texto na seção CDATA não deve ser tratado como XML. A seção CDATA geralmente contém HTML e JavaScript.
  • </Content> significa o final da seção"Conteúdo".
  • </Module> significa o final da definição do gadget.

O que é um gadget?

A API de gadgets consiste em alguns elementos básicos simples: XML, HTML e JavaScript. Para começar, basta ter um conhecimento básico de HTML. Vamos ensinar tudo o que você precisa saber sobre XML para criar gadgets. Depois, à medida que você criar gadgets mais sofisticados, provavelmente vai querer aprender JavaScript se ainda não estiver familiarizado com ele.

XML é uma linguagem de marcação de uso geral. Ele descreve dados estruturados de maneira que humanos e computadores possam ler e gravar.

XML é a linguagem usada para escrever especificações de gadget. Um gadget é simplesmente um arquivo XML, colocado em algum lugar da Internet onde o Google pode encontrá-lo. O arquivo XML que especifica um gadget contém instruções sobre como processar e renderizar o gadget. O arquivo XML pode conter todos os dados e códigos do gadget, ou pode ter referências (URLs) em que é possível encontrar o restante dos elementos.

HTML é a linguagem de marcação usada para formatar páginas na Internet. O conteúdo estático de um gadget geralmente é escrito em HTML. O HTML é parecido com o XML, mas é usado para formatar documentos da Web em vez de descrever dados estruturados.

JavaScript é uma linguagem de script que você pode usar para adicionar um comportamento dinâmico aos seus gadgets.

O que fazer depois

Para informações gerais de programação de gadgets, acesse Como criar seus próprios gadgets. Depois, acesse Desenvolvimento básico.

Voltar ao início