CalDAV é uma extensão do WebDAV que oferece um padrão para que os clientes acessem informações de agendas em um servidor remoto.
O Google oferece uma interface CalDAV que pode ser usada para ver e gerenciar agendas usando o protocolo CalDAV.
Especificações
Para cada uma das especificações relevantes, o suporte a CalDAV do Google é o seguinte:
- rfc4918: extensões HTTP para criação e controle de versões distribuídos na Web
(WebDAV)
- Oferece suporte aos métodos HTTP
GET
,PUT
,HEAD
,DELETE
,POST
,OPTIONS
,PROPFIND
ePROPPATCH
. - Não oferece suporte aos métodos HTTP
LOCK
,UNLOCK
,COPY
,MOVE
ouMKCOL
ou ao cabeçalhoIf*
(exceto paraIf-Match
). - Não é compatível com propriedades WebDAV arbitrárias (definidas pelo usuário).
- Não oferece suporte ao controle de acesso WebDAV (rfc3744).
- Oferece suporte aos métodos HTTP
- rfc4791: extensões de calendário para WebDAV (CalDAV)
- Oferece suporte ao método HTTP
REPORT
. Todos os relatórios, exceto consulta de livre-ocupado, são implementados. - Não oferece suporte ao método HTTP
MKCALENDAR
. - Não é compatível com a ação
AUDIO
.
- Oferece suporte ao método HTTP
- rfc5545: iCalendar
- Os dados expostos na interface CalDAV são formatados de acordo com a especificação do iCalendar.
- No momento, esse recurso não é compatível com dados de
VTODO
ouVJOURNAL
. - Não é compatível com a extensão Apple iCal® para permitir propriedades de URL configuráveis pelo usuário.
- rfc6578: sincronização de coleções para WebDAV
- Os aplicativos clientes precisam alternar para esse modo de operação após a sincronização inicial.
- rfc6638: como programar extensões para CalDAV
- Oferece suporte a uma "caixa de entrada" trivial, que está sempre vazia.
- Os convites recebidos são entregues automaticamente na coleção "eventos", e não na "caixa de entrada".
- Não é compatível com a pesquisa de disponibilidade.
- caldav-ctag-02: tag de entidade de coleta de agenda (CTag) no CalDAV
- A
ctag
da agenda é como um recursoetag
: ela muda quando algo na agenda muda. Isso permite que o aplicativo cliente determine rapidamente que não precisa sincronizar nenhum evento alterado.
- A
- calendar-proxy: funcionalidade proxy do usuário do Google Agenda no CalDAV
- Para melhorar o desempenho da sincronização de agendas de dispositivos iOS, que
não são compatíveis com delegação, o uso das propriedades
calendar-proxy-read-for
oucalendar-proxy-write-for
com um UserAgent do iOS falhará.
- Para melhorar o desempenho da sincronização de agendas de dispositivos iOS, que
não são compatíveis com delegação, o uso das propriedades
Ainda não fornecemos uma implementação completa de todas as especificações relevantes. No entanto, para muitos clientes, como Apple iCal, o protocolo CalDAV precisa interoperar corretamente.
Observação: para segurança da conta e para evitar abusos, o Google pode definir cookies em aplicativos clientes que acessam dados via CalDAV.
Criar seu ID do cliente
Para usar a API CalDAV, você precisa ter uma Conta do Google. Se você já tem uma conta que pode usar, então não precisa fazer mais nada.
Antes de enviar solicitações à API CalDAV, é preciso registrar seu cliente no Console de APIs do Google. Para isso, crie um projeto.
Vá para o Console de APIs do Google. Clique em Criar projeto, digite um nome e clique em Criar.
A próxima etapa é ativar a API CalDAV.Para ativar uma API no seu projeto, siga estas etapas:
- Abra a biblioteca de APIs no Console de APIs do Google. Se solicitado, selecione um projeto ou crie um novo. A Biblioteca de APIs lista todas as APIs disponíveis agrupadas por família de produtos e popularidade.
- Se a API que você quer ativar não estiver visível na lista, use a pesquisa para encontrá-la.
- Selecione a API que você quer ativar e clique no botão Ativar.
- Se necessário, ative o faturamento.
- Aceite os Termos de Serviço da API se solicitado.
Para localizar o ID do cliente e a chave secreta do cliente do projeto, faça o seguinte:
- Selecione uma credencial do OAuth 2.0 atual ou abra a página Credenciais.
- Se você ainda não tiver feito isso, crie as credenciais do OAuth 2.0 do seu projeto clicando em Criar credenciais > ID do cliente OAuth e fornecendo as informações necessárias para criar as credenciais.
- Procure o ID do cliente na seção IDs do cliente OAuth 2.0. Clique no ID do cliente para saber mais.
Como se conectar ao servidor CalDAV do Google
Para usar a interface CalDAV, um programa cliente se conecta inicialmente ao
servidor da agenda em um dos dois pontos de partida. Em ambos os casos, a conexão
precisa ser feita por HTTPS e usar o esquema de autenticação
OAuth 2.0. O servidor CalDAV se recusará a autenticar uma solicitação a menos que chegue por HTTPS com a autenticação do OAuth 2.0 de uma Conta do Google.
A tentativa de se conectar por HTTP ou usar a autenticação básica resulta em um
código de status HTTP 401 Unauthorized
.
Se o programa cliente (como Apple iCal) exigir uma coleção principal como ponto de partida, o URI a ser conectado será:
https://apidata.googleusercontent.com/caldav/v2/calid/user
Em que calid
precisa ser substituído pelo
"código da agenda" da agenda a ser acessada. Ele pode ser encontrado na interface da Web do Google Agenda da seguinte forma: no menu suspenso ao lado do nome da agenda, selecione Configurações da agenda. Na página resultante, o ID da agenda é mostrado em uma seção chamada Endereço da agenda. O ID da agenda principal de um usuário é o mesmo do endereço de e-mail dele.
Se um programa cliente (como o Mozilla Sunbird) exigir uma coleção de agendas como ponto de partida, o URI para se conectar será:
https://apidata.googleusercontent.com/caldav/v2/calid/events
O endpoint antigo https://www.google.com/calendar/dav foi descontinuado e não é mais compatível. Use-o por sua conta e risco. Recomendamos que você faça a transição para o novo formato de endpoint descrito acima.
iCal é uma marca registrada da Apple Inc.