Lembretes e notificações

A API Calendar é compatível com lembretes e notificações.

  • Lembretes são alarmes acionados em um horário especificado antes do início de um evento.
  • Com a opção Notificações, os usuários podem ficar sabendo das alterações nos eventos da agenda.

O último item não deve ser confundido com push notificações que, em vez de serem entregues, a um usuário, notificar outro servidor sobre as alterações em uma agenda.

Para mais detalhes sobre as notificações no Google Agenda, acesse Modifique as notificações do Google Agenda.

Lembretes

Um lembrete consiste em:

  • Quando mostrar o lembrete, expresso em minutos antes do horário de início do evento
  • O método de exibição a ser usado (consulte Mecanismos de exibição)

Lembretes podem ser especificados para agendas inteiras e para eventos individuais. Usuários pode definir lembretes padrão para cada uma de suas agendas; esses padrões se aplicam todos os eventos dessa agenda. No entanto, os usuários também podem substituir essas padrões para eventos individuais, substituindo-os por um conjunto diferente de lembretes.

Lembretes padrão

Lembretes são informações particulares específicas de um usuário autenticado. eles estão não são compartilhados entre vários usuários. O resultado disso é o seguinte:

  • Os lembretes padrão são manipulados pela coleção CalendarList, que contém metadados de agenda específicos do usuário
  • Elas não podem ser acessadas na coleção Agendas, que contém metadados compartilhados entre todos os usuários.

Lembretes padrão também são retornados ao fazer uma consulta da lista de eventos.

Substituir lembretes padrão

Para substituir os lembretes padrão ao inserir ou modificar um evento, defina reminders.useDefault como false e preencher reminders.overrides com o novo lembrete definido.

"reminders": {
  "useDefault": false,
  # Overrides can be set if and only if useDefault is false.
  "overrides": [
      {
        "method": "reminderMethod",
        "minutes": "reminderMinutes"
      },
      # ...
  ]
}

Para voltar ao conjunto de lembretes padrão, defina uma configuração de atualização reminders.useDefault de volta para true.

Notificações

O Google Agenda é compatível com os seguintes tipos de notificação:

  • Criação de evento: um novo evento é adicionado a uma das agendas do usuário.
  • Alteração do evento: o organizador modificou um evento para o qual o usuário foi convidado.
  • Cancelamento de evento: um evento é cancelado para o qual o usuário foi convidado.
  • Resposta do participante: um convidado de um evento criado pelo usuário alterou o status de resposta.
  • Compromissos: uma lista de todos os eventos na agenda do usuário, enviados no início do dia.

O usuário pode decidir quais notificações ativar de acordo com a agenda e a entrega para cada tipo de notificação. Estas configurações não são compartilhadas com outros usuários. Assim como os lembretes padrão, eles podem ser acessados na Coleção CalendarList.

Para enviar notificações por e-mail aos participantes sobre eventos que foram inseridos ou atualizado pela API, defina o parâmetro sendNotifications no bloco solicitação como "true".

Mecanismos de entrega

Estes são os métodos de entrega oferecidos pelo Google Agenda:

  • Pop-up. Eles são compatíveis com plataformas móveis e clientes da Web.
  • E-mail enviado pelo servidor.

A tabela a seguir mostra os métodos compatíveis para cada lembrete ou tipo de notificação:

Pop-up E-mail
Lembretes Lembretes padrão ✓ ✓
Substituir lembretes ✓ ✓
Notificações Criação do evento ❌ ✓
Alteração no evento ❌ ✓
Cancelamento do evento ❌ ✓
Resposta do participante ❌ ✓
Tópicos ❌ ✓