Instruções para criar o botão de lembrete de eventos do Google Agenda
A "receita" para criar snippets HTML que controlam os botões de lembrete de eventos do Google Agenda é descrita a seguir. As instruções pressupõem que você tem conhecimentos em HTML. Temos também uma forma simples para ajudá-lo a criar snippets HTML para esses botões, se você não quiser se informar a respeito do descrito a seguir.
Uma observação sobre caracteres não permitidos
Determinados caracteres, como o sinal de igual (=), causam problemas quando utilizados dentro de valores de parâmetros CGI. Você ainda pode fazer com que esses caracteres especiais sejam exibidos em seus eventos, mas será necessário convertê-los em códigos especiais para seus parâmetros CGI. (Não convertemos os caracteres não permitidos nos exemplos seguintes para manter a legibilidade.) Saiba mais
Instruções detalhadas Os detalhes de seu evento (como o título, a hora de início e de término e o local do evento) recebem seus próprios parâmetros CGI (uma frase especial para o segmento de um endereço na web que altera o comportamento do link) dentro do URL aos quais seus botões criam links. Os parâmetros CGI de eventos devem ser separados pelo símbolo “e” comercial (&).
Veja aqui o formato geral para esses snippets HTML. Seus parâmetros de eventos vão ao final do link href, em qualquer ordem, e você pode adicionar quantos parâmetros forem necessários.
<a href="http://www.google.com/calendar/event?action=TEMPLATE&Parameter1&Parameter2&Parameter3"><img src="http://www.google.com/calendar/images/ext/gc_button2_pt-BR.gif"></a>
A tabela a seguir lista os parâmetros CGI básicos que definem um evento:
| Nome do parâmetro |
Valor |
Exemplo |
| action (obrigatório) |
Esse valor é sempre TEMPLATE (em maiúsculas). |
action=TEMPLATE |
| text (obrigatório) |
Título do evento. |
text=Brunch no Java Cafe |
| dates (obrigatório) |
Data e hora do evento, no formato UTC. Adicione uma letra "Z" maiúscula ao final das horas. O Google Agenda interpretará a data e a hora para o fuso horário do usuário. |
dates=20060415/20060415 durante todo o dia, em 15 de abril de 2006
dates=20060415T180000Z/20060415T190000Z para 15 de abril de 2006 às 11:00am - meio-dia na Hora do Pacífico |
| sprop (obrigatório) |
Informações para identificar sua organização, como o endereço do site. São permitidos vários parâmetros sprop. Essas informações devem ser especificadas como tipo:valor. O caractere dois pontos (:) deve ser utilizado apenas para separar o tipo e o valor. |
sprop=website:www.javacafebrunches.com para o website = www.javacafebrunches.com
sprop=website:www.javacafebrunches.com&sprop=name:Java Cafe para o website = www.javacafebrunches.com and name = Java Cafe |
| add |
Endereço de e-mail da pessoa a ser convidada. São permitidos vários parâmetros add. |
add=username1@domain.com para um convidado
add=username1@domain.com&add=username2@domain.com para dois convidados |
| details |
Descrição do evento. É permitido HTML simples. |
details=Experimente nosso brunch especial de sábado:<br><br>Rabanadas com frutas frescas<br><br>Hum! |
| location |
Local onde o evento ocorrerá. São recomendados locais que funcionem como consultas do Google Maps. |
location=Java Cafe, San Francisco, CA |
| trp |
Especifica se o Google Agenda do usuário o mostrará como "ocupado" durante esse evento. O valor padrão é false. |
trp=true |
Exemplo de HTML para um botão de lembrete de eventos do Google Agenda
Veja aqui como os parâmetros CGI se apresentariam para as reservas de brunch:
action=TEMPLATE
text=Brunch no Java Cafe
location=Java Cafe, San Francisco, CA
details=Experimente nosso brunch especial de sábado:<br><br>Rabanadas com frutas frescas<br><br>Hum!
dates=20060415T180000Z/20060415T190000Z
trp=true
sprop=website:http://www.javacafebrunches.com
sprop=name:Jave Cafe
Juntando tudo, veja aqui o snippet completo do HTML que você adicionaria a seu site para inserir o botão do lembrete de eventos do Google Agenda para essa reserva de brunch:
<a href="http://www.google.com/calendar/event?action=TEMPLATE&text=Brunch at Java Cafe&dates=20060415T180000Z/20060415T190000Z&location=Java Cafe, San Francisco, CA&details=Experimente nosso brunch especial de sábado:<br><br>Rabanadas com frutas frescas<br><br>Hum!&trp=true&sprop=:http://www.javacafebrunches.com&sprop=name:Jave Cafe"><img src="http://www.google.com/calendar/images/ext/gc_button2_pt-BR.gif"></a>
Estilos do botão Nós criamos uma variedade de botões para você escolher. Sinta-se à vontade para escolher aqueles mais apropriados para seu site.
|