Events: instances

Retorna instâncias do evento recorrente especificado. Faça um teste agora ou veja um exemplo.

Solicitação

Solicitação HTTP

GET https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId/instances

Parâmetros

Nome do parâmetro Valor Descrição
Parâmetros de caminho
calendarId string Identificador da agenda. Para recuperar IDs de agendas, chame o método calendarList.list. Para acessar a agenda principal do usuário conectado, use "primary" palavra-chave.
eventId string Identificador de evento recorrente.
Parâmetros de consulta opcionais
alwaysIncludeEmail boolean Obsoleto e ignorado. Um valor será sempre retornado no campo email para o organizador, o criador e os participantes, mesmo se nenhum endereço de e-mail real estiver disponível (ou seja, será fornecido um valor gerado e que não funciona).
maxAttendees integer O número máximo de participantes a serem incluídos na resposta. Se houver mais do que o número especificado de participantes, somente o participante será retornado. Opcional.
maxResults integer Número máximo de eventos retornados em uma página de resultados. Por padrão, o valor é de 250 eventos. O tamanho da página não pode ser maior do que 2.500 eventos. Opcional.
originalStart string O horário de início original da instância no resultado. Opcional.
pageToken string Token que especifica qual página de resultados deve ser retornada. Opcional.
showDeleted boolean Define se eventos excluídos (com status é igual a "cancelled") no resultado. As instâncias canceladas de eventos recorrentes ainda serão incluídas se singleEvents for falso. Opcional. O valor padrão é falso.
timeMax datetime Limite superior (exclusivo) para o horário de início de um evento que será filtrado. Opcional. O padrão não é filtrar por horário de início. Precisa ser um carimbo de data/hora RFC3339 com deslocamento de fuso horário obrigatório.
timeMin datetime Limite inferior (inclusive) para o horário de término de um evento que será filtrado. Opcional. O padrão não é filtrar por horário de término. Precisa ser um carimbo de data/hora RFC3339 com deslocamento de fuso horário obrigatório.
timeZone string Fuso horário usado na resposta. Opcional. O padrão é o fuso horário da agenda.

Autorização

Essa solicitação permite autorização com pelo menos um dos seguintes escopos:

Escopo
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.events.readonly
https://www.googleapis.com/auth/calendar.events

Para mais informações, consulte a página de autenticação e autorização.

Corpo da solicitação

Não forneça um corpo de solicitação com este método.

Resposta

Se for bem-sucedido, esse método retornará um corpo de resposta com esta estrutura:

{
  "kind": "calendar#events",
  "etag": etag,
  "summary": string,
  "description": string,
  "updated": datetime,
  "timeZone": string,
  "accessRole": string,
  "defaultReminders": [
    {
      "method": string,
      "minutes": integer
    }
  ],
  "nextPageToken": string,
  "nextSyncToken": string,
  "items": [
    events Resource
  ]
}
Nome da propriedade Valor Descrição Observações
kind string Tipo da coleção ("calendar#events").
etag etag ETag da coleção.
summary string Título da agenda. Somente leitura.
description string Descrição da agenda. Somente leitura.
updated datetime Hora da última modificação da agenda (como um carimbo de data/hora RFC3339). Somente leitura.
timeZone string O fuso horário da agenda. Somente leitura.
accessRole string A função de acesso do usuário à agenda. Somente leitura. Os valores possíveis são:
  • "none" - O usuário não tem acesso.
  • "freeBusyReader" - O usuário tem acesso de leitura às informações de disponível/ocupado.
  • "reader" - O usuário tem acesso de leitura à agenda. Os eventos particulares vão aparecer para os usuários com acesso de leitura, mas os detalhes deles vão ficar ocultos.
  • "writer" - O usuário tem acesso de leitura e gravação à agenda. Os eventos particulares serão exibidos para os usuários com acesso de gravador, e os detalhes dos eventos ficarão visíveis.
  • "owner" - O usuário é proprietário da agenda. Esse papel tem todas as permissões da função de gravador, com a capacidade adicional de ver e manipular ACLs.
defaultReminders[] list Os lembretes padrão na agenda para o usuário autenticado. Estes lembretes se aplicam a todos os eventos desta agenda que não os modificam explicitamente, ou seja, sem a definição de reminders.useDefault como "True".
defaultReminders[].method string O método usado pelo lembrete. Os valores possíveis são:
  • "email" - Os lembretes são enviados por e-mail.
  • "popup" - Os lembretes são enviados por uma janela pop-up na interface.

Obrigatório ao adicionar um lembrete.

gravável
defaultReminders[].minutes integer Número de minutos antes do início do evento quando o lembrete deve ser acionado. Os valores válidos estão entre 0 e 40320 (4 semanas em minutos).

Obrigatório ao adicionar um lembrete.

gravável
nextPageToken string Token usado para acessar a próxima página deste resultado. Omitido se nenhum outro resultado estiver disponível. Nesse caso, nextSyncToken é fornecido.
items[] list Lista de eventos na agenda.
nextSyncToken string Token usado posteriormente para recuperar apenas as entradas que foram alteradas desde que esse resultado foi retornado. Omitido se outros resultados estiverem disponíveis. Nesse caso, nextPageToken é fornecido.

Exemplos

Observação: os exemplos de código disponíveis para esse método não representam todas as linguagens de programação compatíveis. Consulte a página de bibliotecas cliente para ver uma lista de linguagens compatíveis.

Java

Usa a biblioteca cliente de Java.

import com.google.api.services.calendar.Calendar;
import com.google.api.services.calendar.model.Event;
import com.google.api.services.calendar.model.Events;

// ...

// Initialize Calendar service with valid OAuth credentials
Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials)
    .setApplicationName("applicationName").build();

// Iterate over the instances of a specific recurring event
String pageToken = null;
do {
  Events events =
      service.events().instances('primary', 'eventId').setPageToken(pageToken).execute();
  List<Event> items = events.getItems();
  for (Event event : items) {
    System.out.println(event.getSummary());
  }
  pageToken = events.getNextPageToken();
} while (pageToken != null);

Python

Usa a biblioteca cliente de Python.

page_token = None
while True:
  events = service.events().instances(calendarId='primary', eventId='eventId',
                                      pageToken=page_token).execute()
  for event in events['items']:
    print event['summary']
  page_token = events.get('nextPageToken')
  if not page_token:
    break

PHP

Usa a biblioteca cliente de PHP.

$events = $service->events->instances('primary', "eventId");

while(true) {
  foreach ($events->getItems() as $event) {
    echo $event->getSummary();
  }
  $pageToken = $events->getNextPageToken();
  if ($pageToken) {
    $optParams = array('pageToken' => $pageToken);
    $events = $service->events->instances('primary', "eventId",
        $optParams);
  } else {
    break;
  }
}

Ruby

Usa a biblioteca de cliente Ruby.

page_token = nil
begin
  result = client.list_event_instances('primary', 'eventId')
  result.items.each do |e|
    print e.summary + "\n"
  end
  if result.next_page_token != page_token
    page_token = result.next_page_token
  else
    page_token = nil
  end
end while !page_token.nil?

Confira!

Use o APIs Explorer abaixo para chamar esse método em dados ativos e ver a resposta.