Recherche d'infos sur les gadgets
Malheureusement, cette documentation n’est plus à jour. Si vous préférez, vous pouvez utiliser la documentation en anglais, qui a été mise à jour. Nous vous prions de nous excuser pour ce désagrément.

Mise en route

Bienvenue dans l'API Google Gadgets ! Ce guide du développeur s'adresse à tous ceux qui souhaitent programmer des gadgets à l'aide de l'API Google Gadgets. Les gadgets sont des éléments extrêmement faciles à créer : ils peuvent donc constituer un bon point de départ pour les débutants en programmation Web.

Sommaire

  1. Gadget "Hello, World!"
  2. De quoi un gadget est-il fait ?
  3. Démarrage immédiat grâce au bloc-notes
  4. Étapes suivantes

Gadget "Hello, World!"

La façon la plus simple d'apprendre à vous servir de cette API est de commencer avec un exemple. Le gadget suivant permet d'afficher, tout simplement, le message "Hello, world!" ("Bonjour à tous !") : 

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

Retrouvez les spécifications correspondant à ce gadget en cliquant sur ce lien.

Pour exécuter cet exemple, procédez comme suit :

  1. Accédez à la page http://www.google.com/ig.
  2. Pour exécuter un gadget, vous devez disposer d'une page iGoogle. Si vous n'en possédez pas encore, vous devez en créer une en cliquant sur Personnalisez-la sur la page d'accueil. Connectez-vous ensuite avec votre compte Google ou créez un nouveau compte.
  3. Une fois que vous avez personnalisé votre page iGoogle, vous pouvez y ajouter des gadgets en cliquant sur Ajouter des modules dans la partie supérieure droite de la page afin d'accéder à l'annuaire de contenu. Parcourez l'annuaire de contenu pour rechercher et ajouter des gadgets à votre page d'accueil.
  4. Cliquez sur Ajouter une URL (en regard du bouton Recherche de contenu).
  5. Dans la zone de texte Ajouter une URL, entrez le texte "hello.xml" et cliquez sur Ajouter.
  6. Cliquez sur Retour à la page d'accueil. Vous y verrez le gadget que vous venez d'ajouter.

Le texte "hello.xml" est un raccourci pour désigner l'URL http://www.google.com/ig/modules/hello.xml. Les URL de spécifications de gadget peuvent systématiquement être indiquées dans la zone de texte Ajouter une URL, y compris les URL correspondant à des spécifications que vous ou vos amis ont écrites, à condition qu'elles aient été transmises à un serveur Web public.

Prenez note des éléments suivants relatifs à l'exemple "Hello, World!" :

De quoi un gadget est-il fait ?

L'API Google Gadgets est constituée de quelques éléments essentiels simples : XML, HTML et JavaScript. Tout d'abord, vous devez avoir des connaissances générales sur le langage HTML. Nous nous chargerons de vous apprendre tout ce que vous devez savoir sur le langage XML pour pouvoir programmer un gadget. Plus tard, si vous désirez programmer des gadgets plus élaborés, vous aurez peut-être besoin d'en savoir plus sur le langage JavaScript.

XML est un langage de balisage à portée très générale. Il permet de décrire des données structurées, compréhensibles à la fois par l'homme et la machine.

Ce langage est celui que vous allez utiliser pour écrire vos spécifications de gadget. Un gadget est un simple fichier XML, placé quelque part sur Internet, à un emplacement accessible par Google. Le fichier XML qui spécifie un gadget contient des instructions sur la façon dont le gadget sera traité et exécuté. Le fichier XML peut contenir toutes les données et le code du gadget ou être constitué de références (URL) à des emplacements où se trouvent les éléments nécessaires.

HTML est le langage de balisage utilisé pour mettre en forme les pages Web. C'est dans ce langage qu'est écrit le contenu statique d'un gadget. Le langage HTML est assez semblable au langage XML, mais s'utilise plutôt pour mettre en forme des documents Web que pour décrire des données structurées.

JavaScript est un langage de script qui permet d'ajouter des éléments dynamiques à vos gadgets.

Remarque : Au départ, les gadgets étaient appelés "modules". C'est pourquoi le terme "Module" apparaît encore dans l'API.

Démarrage immédiat grâce au bloc-notes

Pour commencer à programmer des gadgets, la solution de facilité consiste à utiliser le bloc-notes. Celui-ci vous permet de modifier des spécifications de gadget et d'afficher un aperçu du résultat sans même quitter le guide du développeur. Vous pouvez vous servir de ce bloc-notes de plusieurs façons :

Par défaut, le bloc-notes contient les spécifications du gadget "Hello, World!". Vous pouvez en modifier le titre et le message comme suit : 

<?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>

Pour afficher les résultats de vos modifications dans le bloc-notes, cliquez sur Aperçu. Lorsque vous réactualisez la page, les spécifications du gadget de départ "Hello, World!" s'affichent à nouveau dans le bloc-notes. Sous le bloc-notes, vous trouverez des liens vers d'autres exemples de gadget que vous pouvez afficher et modifier.

Modifiez-moi ! Une fois vos modifications effectuées, cliquez sur "Aperçu" pour les visualiser.


Étapes suivantes

Servez-vous de cette mise en route pour vous familiariser avec les gadgets et faire des essais dans le bloc-notes. Une fois que vous vous sentez prêt, passez à l'étape suivante : Programmation de votre propre gadget. De là, vous pourrez continuer avec la rubrique Développement : notions essentielles ou retourner à la page d'accueil de la documentation qui donne un aperçu des rubriques et des sujets abordés.

 

Retour au début

Mis à jour le