Esta página foi traduzida pela API Cloud Translation.

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.