Des gadgets pour Google Agenda

Google Code a annoncé cette nouvelle il y a quelques jours : Google Agenda supporte maintenant l'insertion de gadgets Google.
Je vais essayé de rapidement débrousser le terrain… Pas moins de deux normes sont utilisables : soit le format iCalendar soit l'API Google Agenda. Le principe consiste à :

• Créer un gadget (le fichier sera au format XML) ;
• Créer un fichier ICS qui fait un lien vers le fichier XML ;
• Importer dans Google Agenda ce fichier ICS.

Voici les explications concernant la création d'un gadget ainsi que l'élaboration d'un fichier ICS.
Vous pouvez vous servir de l'exemple visible dans la rubrique Using the iCal Format.

1. Afin d'ajouter un fichier ICS, cliquez dans Google Agenda sur le bouton fléché Ajouter puis sur le sous-menu Importation d'agenda.
2. Cliquez sur le bouton Parcourir… puis sélectionnez le fichier ICS.
3. Cliquez sur le bouton Importer.
4. Si votre fichier iCal est sur un serveur, sélectionnez, dans ce cas, le sous-menu Ajouter une URL. Vous pouvez faire un test avec ce nom d'agenda : http://gdata.ops.demo.googlepages.com/wotd.ics.

Le seul événement qui est inscrit est programmé pour le 20 juillet 2007… Rien ne vous empêche de saisir cette adresse dans votre navigateur puis d'enregistrer le fichier ICS et, enfin, de l'ouvrir avec le Bloc-Notes Windows.
Afin d'afficher des présentations possibles de fichiers ICS, saisissez cette expression dans Google : ext:ics. La syntaxe est relativement simple… Vos différents événements seront encadrés par ces déclarations :
BEGIN:VCALENDAR
CALSCALE:GREGORIAN
METHOD:PUBLISH
X-WR-CALNAME;VALUE=TEXT:Titre du calendrier
VERSION:2.0
END:VCALENDAR
Chaque événement sera indiqué en utilisant ces déclarations :
BEGIN:VEVENT
DTSTART;VALUE=DATE:20070720
DTEND;VALUE=DATE:20070721
SUMMARY:Word of the Day - with pronounciation!
X-GOOGLE-CALENDAR-CONTENT-TITLE:Word of the Day
X-GOOGLE-CALENDAR-CONTENT-ICON:http://www.thefreedictionary.com/favicon.ico
X-GOOGLE-CALENDAR-CONTENT-URL:http://www.thefreedictionary.com/_/WoD/wod-module.xml
X-GOOGLE-CALENDAR-CONTENT-TYPE:application/x-google-gadgets+xml
X-GOOGLE-CALENDAR-CONTENT-WIDTH:330
X-GOOGLE-CALENDAR-CONTENT-HEIGHT:100
X-GOOGLE-CALENDAR-CONTENT-GADGET-PREF;NAME=Format:0
X-GOOGLE-CALENDAR-CONTENT-GADGET-PREF;NAME=Days:1
END:VEVENT
Notez que dans Google, une recherche sur l'expression "BEGIN:VEVENT" renvoie 481 000 résultats…
Dans cet exemple, le fichier XML est visible à cette adresse.
Il est possible d'ajouter directement un fichier iCal dans Google Agenda en utilisant cette syntaxe : http://www.google.com/calendar/render?cid=http://http://gdata.ops.demo.googlepages.com/wotd.ics.
La différence est la suivante : si vous importez un fichier ICS, l'événement sera inclus à un de vos agendas existants. Pour le supprimer, il vous faudra cliquer sur l'onglet Mon planning puis sur le nom de l'événement importé et enfin sur le lien Supprimer.
Si vous ajouter un fichier iCal placé sur un serveur, il viendra s'ajouter à vos agendas existants comme un nouvel agenda. Afin de le supprimer, vous devrez cliquez sur le lien Gérer les agendas puis sur l'icône représentant une corbeille et placée en face de sa mention.
Afin d'enregistrer un événement ponctuel, vous pouvez vous servir du code source proposé sur le site de "Bolinfest".

1. Cliquez sur le lien Start creating web content events with the wizard puis le bouton Accorder l'accès. Vous autorisez de cette façon le site "Bolinfest.com" à utiliser votre compte Google Agenda pour pouvoir accéder au service Comptes Google en votre nom.
2. Cliquez sur l'onglet Add.
3. Faites un test en cliquant sur le bouton Fill in sample values.
4. N'oubliez pas de cocher la case Show ATOM (for GData developers).
5. Cliquez enfin sur le bouton Add Event.

D'autres suggestions sont disponibles sur ce site sur la programmation.
Voyons maintenant commet transformer un gadget Google en un gadget Google Agenda :
Sur la page de documentation de l'API citée précédemment, il y a un outil appelé " the "of the day" Calendar Gadget Creator".

1. Accédez à la galerie des gadgets Google.
2. Sélectionnez un gadget de type "agenda" puis cliquez sur Afficher la source.
3. Vous allez obtenir ce type d'URL : http://www.calculatorcat.com/gmodules/current_moon.xml.
4. Saisissez l'adresse du fichier XML dans la zone de texte Enter the URL to the XML gadget spec:.
5. Cliquez sur le bouton Load.
6. Attribuez un titre à votre agenda.
7. Cliquez sur le bouton Create Calendar.
8. Copiez l'URL qui sera générée sur un document Bloc-notes. Il y a un "Bug" qui fait que les premières lettres du titre sont coupées. Il suffit de faire un peu d'"URL Rewriting" et le tour est joué !
9. Collez-la ensuite dans votre navigateur.
10. Cliquez sur le bouton Oui, ajouter cet agenda.

Chaque jour de l'année, votre calendrier affichera les phases correspondantes de la lune.
Il existe une documentation complète sur l'API Google Calendar Data et, plus précisément, un paragraphe dédié à la création de gadgets pour Google Agenda.