Google Agenda

Over Google Agenda

Instructies voor het maken van herinneringsknoppen voor afspraken in Google Agenda

Het 'recept' voor het maken van de HTML-fragmenten voor herinneringsknoppen voor afspraken in Google Agenda wordt hieronder beschreven. Om deze instructies te kunnen volgen moet je wel enigszins bekend zijn met HTML. Er is ook een formulier waarmee je eenvoudiger HTML-fragmenten voor deze knoppen kunt maken, als je de onderstaande instructies niet wilt volgen.

Een opmerking over ongeldige tekens
Bepaalde tekens, zoals het gelijkteken (=), veroorzaken problemen wanneer ze worden gebruikt in CGI-parameterwaarden. Deze tekens mogen wel voorkomen in de beschrijving van uw afspraken, maar je moet deze converteren in speciale codes voor de CGI-parameters. (We hebben voor de leesbaarheid de ongeldige tekens in de onderstaande voorbeelden niet geconverteerd.) Meer informatie

Gedetailleerde instructies
De details van uw afspraken (zoals Titel van afspraak, Begintijd van afspraak, Eindtijd van afspraak, en Locatie van afspraak) krijgen elk hun eigen CGI-parameter (een duur woord voor het segment van een webadres dat het gedrag van een link verandert) binnen de URL waarnaar je knop een link opent. De CGI-parameters voor je afspraken moeten worden gescheiden door ampersand-tekens (&).

Hier volgt de algemene indeling voor deze HTML-fragmenten. De parameters voor je afspraak komen aan het eind van de href-link en in willekeurige volgorde. Je kunt zoveel parameters toevoegen als je wilt.

<a href="http://www.google.com/calendar/event?action=TEMPLATE&Parameter1;&Parameter2;&Parameter3;"><img src="//www.google.com/calendar/images/ext/gc_button2_nl.gif"></a>

In de onderstaande tabel staan de standaard CGI-parameters die een afspraak aanduiden.

Naam van parameter Waarde Voorbeeld
action (verplicht) Deze waarde is altijd TEMPLATE (in hoofdletters). action=TEMPLATE
text (verplicht) Titel afspraak. text=Brunchen bij Nielsen
dates (verplicht) Datum en tijd van de afspraak, in UTC-indeling. Voeg een hoofdletter 'Z' toe achter tijdstippen. Google Agenda interpreteert vervolgens de datum en tijd voor de tijdzone van de gebruiker. dates=20060415/20060415
voor 15 april 2006, de hele dag

dates=20060415T180000Z/20060415T190000Z
voor 15 april 2006 van 11:00 uur tot 12:00 uur Pacific Time.
sprop (verplicht) Informatie waarmee je organisatie kan worden geïdentificeerd, zoals het adres van je website. Er zijn meerdere sprop-parameters toegestaan. Deze informatie moet worden opgegeven als type:waarde. De dubbele punt mag alleen worden gebruikt om het type en de waarde te scheiden. sprop=website:www.javacafebrunches.com
voor de website = www.javacafebrunches.com

sprop=website:www. javacafebrunches.com&sprop;=name:Café Nielsen
voor de website = www. javacafebrunches.com and name = Café Nielsen
add Het e-mailadres van de gast die je wilt uitnodigen. Er zijn meerdere add-parameters toegestaan. add=gebruikersnaam1@domein.nl
voor twee gasten

add=gebruikersnaam1@domein.nl&add;=gebruikersnaam2@domein.com
voor twee gasten
details Beschrijving van de afspraak. Eenvoudige HTML is toegestaan. details=Probeer onze brunchspecialiteit op zaterdag:<br><br>Flensjes met aardbeien<br><br>Mmmm!
location Locatie waar de afspraak plaatsvindt. We raden locaties aan die ook werken als zoekopdrachten in Google Maps. location=Café Nielsen, Amsterdam
trp Bepaalt of de Google-agenda van de gebruiker op 'bezet' moet staan tijdens de afspraak. De standaardwaarde is false (nee). trp=true

Voorbeeld-HTML voor een herinneringsknop voor een afspraak in Google Agenda
De CGI-parameters voor een brunchafspraak zien er als volgt uit:

actie=TEMPLATE
text=Brunchen bij Nielsen
location=Café Nielsen, Amsterdam
details=Probeer onze brunchspecialiteit op zaterdag:<br><br>Flensjes met aardbeien<br><br>Mmmm!
dates=20060415T180000Z/20060415T190000Z
trp=true
sprop=website:http://www.javacafebrunches.com
sprop=name:Café Nielsen

Wanneer dit allemaal wordt samengevoegd, heb je een HTML-fragment dat je kunt toevoegen aan je website om een herinneringsknop voor deze reservering te maken:

<a href="http://www.google.com/calendar/event?action=TEMPLATE&tekst;=Brunchen bij Nielsen &dates;=20060415T180000Z/20060415T190000Z&location;=Café Nielsen, Amsterdam&details;=Probeer onze brunchspecialiteit op zaterdag:<br><br>Flensjes met aardbeien<br><br>Mmmm!&trp;=true&sprop;=:http://www.javacafebrunches.com&sprop;=name:Café Nielsen"><img src="//www.google.com/calendar/images/ext/gc_button2_nl.gif"></a>

Knopstijlen
We hebben verschillende soorten knoppen ontworpen waaruit je kunt kiezen. Kies degene die het beste bij je site past.

http://www.google.com/calendar/images/ext/gc_button1_nl.gif

http://www.google.com/calendar/images/ext/gc_button2_nl.gif

http://www.google.com/calendar/images/ext/gc_button6_nl.gif