Events: import

Importa um evento. Essa operação é usada para adicionar uma cópia privada de um evento a uma agenda. Apenas eventos com eventType de default podem ser importados.

Comportamento descontinuado:se um evento não default for importado, o tipo dele vai ser alterado para default, e todas as propriedades específicas do tipo de evento serão descartadas.

Faça um teste agora ou veja um exemplo.

Solicitação

Solicitação HTTP

POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/import

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. Se você quiser acessar a agenda principal do usuário conectado, use a palavra-chave "primary".
Parâmetros de consulta opcionais
conferenceDataVersion integer Número da versão de dados de conferência compatível com o cliente da API. A versão 0 pressupõe que não há suporte para dados de conferência e ignora os dados de conferência no corpo do evento. A versão 1 oferece suporte à cópia de ConferênciaData, bem como à criação de novas conferências usando o campo createRequest de subscriptionData. O padrão é 0. Os valores aceitáveis são de 0 a 1, inclusive.
supportsAttachments boolean Se o cliente da API que executa a operação suporta anexos de eventos. Opcional. O valor padrão é falso.

Autorização

Esta solicitação requer autorização com pelo menos um dos seguintes escopos:

Escopo
https://www.googleapis.com/auth/calendar
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

No corpo da solicitação, forneça um recurso "Events" com as seguintes propriedades:

Nome da propriedade Valor Descrição Observações
Propriedades obrigatórias
end nested object O horário de término (exclusivo) do evento. Para um evento recorrente, este é o horário de término da primeira instância.
iCalUID string Identificador exclusivo do evento, conforme definido no RFC5545. Ele é usado para identificar eventos de forma exclusiva em sistemas de agenda e precisa ser fornecido durante a importação de eventos pelo método import.

Observe que iCalUID e id não são idênticos. Apenas um deles precisa ser fornecido no momento da criação do evento. Uma diferença na semântica é que, em eventos recorrentes, todas as ocorrências de um evento têm ids diferentes, embora todas compartilhem as mesmas iCalUIDs. Para recuperar um evento usando o iCalUID, chame o método events.list usando o parâmetro iCalUID. Para recuperar um evento usando o id, chame o método events.get.
start nested object O horário (inclusive) de início do evento. Para um evento recorrente, é o horário de início da primeira instância.
Propriedades opcionais
anyoneCanAddSelf boolean Se qualquer pessoa pode convidar a si mesma para o evento (descontinuado). Opcional. O valor padrão é falso. gravável
attachments[].fileUrl string Link do URL para o anexo.

Para adicionar anexos de arquivo do Google Drive, use o mesmo formato da propriedade alternateLink do recurso Files na API Drive.

Obrigatório ao adicionar um anexo.

 gravável
attendees[] list Os participantes do evento. Consulte o guia Eventos com participantes para mais informações sobre como agendar eventos com outros usuários da agenda. As contas de serviço precisam usar a delegação de autoridade em todo o domínio para preencher a lista de participantes. gravável
attendees[].additionalGuests integer Número de hóspedes adicionais. Opcional. O padrão é 0. gravável
attendees[].comment string O comentário de resposta do convidado. Opcional. gravável
attendees[].displayName string O nome do convidado, se disponível. Opcional. gravável
attendees[].email string O endereço de e-mail do convidado, se disponível. Este campo deve estar presente ao adicionar um convidado. Ele precisa ser um endereço de e-mail válido de acordo com o RFC5322 (link em inglês).

Obrigatório ao adicionar um convidado.

 gravável
attendees[].optional boolean Se este é um participante opcional. Opcional. O valor padrão é falso. gravável
attendees[].resource boolean Se o participante é um recurso. Só pode ser definido quando o participante é adicionado ao evento pela primeira vez. As modificações subsequentes são ignoradas. Opcional. O valor padrão é falso. gravável
attendees[].responseStatus string O status de resposta do convidado. Os valores possíveis são:
  • "needsAction": o convidado não respondeu ao convite (recomendado para novos eventos).
  • "declined": o convidado recusou o convite.
  • "tentative": o convidado aceitou o convite provisoriamente.
  • "accepted": o convidado aceitou o convite.
 gravável
attendeesOmitted boolean Se os participantes podem ter sido omitidos da representação do evento. Ao recuperar um evento, isso pode ocorrer devido a uma restrição especificada pelo parâmetro de consulta maxAttendee. Ao atualizar um evento, essa opção só pode ser usada para atualizar a resposta do participante. Opcional. O valor padrão é falso. gravável
colorId string A cor do evento. Esse é um ID que se refere a uma entrada na seção event da definição de cores. Consulte o endpoint de cores. Opcional. gravável
conferenceData nested object As informações relacionadas à videoconferência, como os detalhes de uma videoconferência do Google Meet. Para criar novos detalhes de videoconferência, use o campo createRequest. Para manter suas mudanças, defina o parâmetro de solicitação conferenceDataVersion como 1 para todas as solicitações de modificação de eventos. gravável
description string É a descrição do evento. Pode conter HTML. Opcional. gravável
end.date date A data, no formato "aaaa-mm-dd", se for um evento de dia inteiro. gravável
end.dateTime datetime A hora, como um valor combinado de data-hora (formatado de acordo com RFC3339). É necessário um deslocamento de fuso horário, a menos que um fuso horário seja explicitamente especificado em timeZone. gravável
end.timeZone string O fuso horário em que o horário é especificado. Formatado como um nome do banco de dados de fuso horário IANA, por exemplo, "Europa/Zurique". Para eventos recorrentes, este campo é obrigatório e especifica o fuso horário em que a recorrência é expandida. Para eventos únicos, esse campo é opcional e indica um fuso horário personalizado para o início/término do evento. gravável
extendedProperties.private object São as propriedades particulares à cópia do evento que aparece nessa agenda. gravável
extendedProperties.shared object Propriedades compartilhadas entre cópias do evento nas agendas de outros participantes. gravável
focusTimeProperties nested object Dados do evento "Horário de concentração". Usado se eventType for focusTime. gravável
gadget.display string O modo de exibição do gadget. Obsoleto. Os valores possíveis são:
  • "icon": o gadget é exibido ao lado do título do evento na visualização da agenda.
  • "chip": o gadget é exibido quando o evento é clicado.
 gravável
gadget.height integer A altura do gadget em pixels. A altura precisa ser um número inteiro maior que zero. Opcional. Obsoleto. gravável
gadget.preferences object Preferências. gravável
gadget.title string O título do gadget. Obsoleto. gravável
gadget.type string O tipo de gadget. Obsoleto. gravável
gadget.width integer A largura do gadget em pixels. A largura precisa ser um número inteiro maior que zero. Opcional. Obsoleto. gravável
guestsCanInviteOthers boolean Se participantes que não sejam o organizador podem convidar outras pessoas para o evento. Opcional. O padrão é "True". gravável
guestsCanModify boolean Se outros participantes além do organizador podem modificar o evento. Opcional. O valor padrão é falso. gravável
guestsCanSeeOtherGuests boolean Se outros participantes além do organizador podem ver quem são os participantes do evento. Opcional. O padrão é "True". gravável
location string A localização geográfica do evento como texto em formato livre. Opcional. gravável
organizer object O organizador do evento. Se o organizador também for um convidado, isso será indicado em uma entrada separada no arquivo attendees com o campo organizer definido como "True". Para alterar o organizador, use a operação mover. Somente leitura, exceto ao importar um evento. gravável
organizer.displayName string O nome do organizador, se disponível. gravável
organizer.email string O endereço de e-mail do organizador, se disponível. Ele precisa ser um endereço de e-mail válido de acordo com o RFC5322 (link em inglês). gravável
originalStartTime.date date A data, no formato "aaaa-mm-dd", se for um evento de dia inteiro. gravável
originalStartTime.dateTime datetime A hora, como um valor combinado de data-hora (formatado de acordo com RFC3339). É necessário um deslocamento de fuso horário, a menos que um fuso horário seja explicitamente especificado em timeZone. gravável
originalStartTime.timeZone string O fuso horário em que o horário é especificado. Formatado como um nome do banco de dados de fuso horário IANA, por exemplo, "Europa/Zurique". Para eventos recorrentes, este campo é obrigatório e especifica o fuso horário em que a recorrência é expandida. Para eventos únicos, esse campo é opcional e indica um fuso horário personalizado para o início/término do evento. gravável
outOfOfficeProperties nested object Dados de eventos fora do escritório. Usado se eventType for outOfOffice. gravável
recurrence[] list Lista de linhas RRULE, EXRULE, RDATE e EXDATE para um evento recorrente, conforme especificado em RFC5545. As linhas DTSTART e DTEND não são permitidas nesse campo. Os horários de início e término do evento são especificados nos campos start e end. Este campo é omitido para eventos únicos ou instâncias de eventos recorrentes. gravável
reminders.overrides[] list Se o evento não usar os lembretes padrão, os lembretes específicos serão listados ou, se não for definido, indica que nenhum lembrete foi definido para o evento. O número máximo de lembretes de substituição é 5. gravável
reminders.overrides[].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 em um pop-up da interface.

Obrigatório ao adicionar um lembrete.

 gravável
reminders.overrides[].minutes integer Número de minutos antes do início do evento em que 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
reminders.useDefault boolean Define se os lembretes padrão da agenda se aplicam ao evento. gravável
sequence integer Número de sequência de acordo com o iAgenda. gravável
source.title string O título da fonte, por exemplo, o título de uma página da Web ou o assunto de um e-mail. gravável
source.url string URL da origem que aponta para um recurso. O esquema de URL precisa ser HTTP ou HTTPS. gravável
start.date date A data, no formato "aaaa-mm-dd", se for um evento de dia inteiro. gravável
start.dateTime datetime A hora, como um valor combinado de data-hora (formatado de acordo com RFC3339). É necessário um deslocamento de fuso horário, a menos que um fuso horário seja explicitamente especificado em timeZone. gravável
start.timeZone string O fuso horário em que o horário é especificado. Formatado como um nome do banco de dados de fuso horário IANA, por exemplo, "Europa/Zurique". Para eventos recorrentes, este campo é obrigatório e especifica o fuso horário em que a recorrência é expandida. Para eventos únicos, esse campo é opcional e indica um fuso horário personalizado para o início/término do evento. gravável
status string Status do evento. Opcional. Os valores possíveis são:
  • "confirmed": o evento foi confirmado. Esse é o status padrão.
  • "tentative": o evento foi confirmado temporariamente.
  • "cancelled": o evento foi cancelado (excluído). O método list retorna eventos cancelados somente na sincronização incremental (quando syncToken ou updatedMin são especificados) ou se a sinalização showDeleted estiver definida como true. O método get sempre as retorna.

    Um status "cancelado" representa dois estados diferentes, dependendo do tipo de evento:

    1. As exceções canceladas de um evento recorrente não cancelado indicam que essa instância não deve mais ser apresentada ao usuário. Os clientes devem armazenar esses eventos durante o ciclo de vida do evento recorrente pai.

      As exceções canceladas só garantem o preenchimento dos valores dos campos id, recurringEventId e originalStartTime. Os outros campos podem estar vazios.

    2. Todos os outros eventos cancelados representam eventos excluídos. Os clientes devem remover as cópias sincronizadas localmente. Esses eventos cancelados desaparecerão em algum momento. Portanto, não espere que eles fiquem disponíveis indefinidamente.

      Os eventos excluídos só têm a garantia de que o campo id esteja preenchido.

    Na agenda do organizador, os eventos cancelados continuam a exibir detalhes (resumo, local etc.) para que possam ser restaurados (cancelar a exclusão). Da mesma forma, os eventos para os quais o usuário foi convidado e que ele removeu manualmente continuam a fornecer detalhes. No entanto, as solicitações de sincronização incremental com showDeleted definido como falso não vão retornar esses detalhes.

    Se um evento alterar seu organizador (por exemplo, por meio da operação mover) e o organizador original não estiver na lista de participantes, ele deixará um evento cancelado em que apenas o campo id será preenchido.

gravável
summary string Título do evento. gravável
transparency string Define se o evento bloqueia o tempo na agenda. Opcional. Os valores possíveis são:
  • "opaque": valor padrão. O evento bloqueia o horário na agenda. Isso equivale a configurar Mostrar-me como como Ocupado na interface do Google Agenda.
  • "transparent": o evento não bloqueia o horário na agenda. Isso equivale a configurar Mostrar-me como como Disponível na interface do Google Agenda.
 gravável
visibility string Visibilidade do evento. Opcional. Os valores possíveis são:
  • "default": usa a visibilidade padrão para eventos da agenda. Esse é o valor padrão.
  • "public": o evento é público, e os detalhes dele são visíveis para todos os leitores da agenda.
  • "private": o evento é privado e somente os participantes podem ver os detalhes.
  • "confidential": o evento é particular. Esse valor é fornecido por motivos de compatibilidade.
 gravável

Resposta

Se for bem-sucedido, esse método retornará um recurso "Events" no corpo da resposta.

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.EventAttendee;
import com.google.api.services.calendar.model.EventDateTime;
import com.google.api.client.util.DateTime;

import java.util.Date;
// ...

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

// Create and initialize a new event (could also retrieve an existing event)
Event event = new Event();
event.setICalUID("originalUID");

Event.Organizer organizer = new Event.Organizer();
organizer.setEmail("organizerEmail");
organizer.setDisplayName("organizerDisplayName");
event.setOrganizer(organizer);

ArrayList<EventAttendee> attendees = new ArrayList<EventAttendee>();
attendees.add(new EventAttendee().setEmail("attendeeEmail"));
// ...
event.setAttendees(attendees);

Date startDate = new Date();
Date endDate = new Date(startDate.getTime() + 3600000);
DateTime start = new DateTime(startDate, TimeZone.getTimeZone("UTC"));
event.setStart(new EventDateTime().setDateTime(start));
DateTime end = new DateTime(endDate, TimeZone.getTimeZone("UTC"));
event.setEnd(new EventDateTime().setDateTime(end));

// Import the event into a calendar
Event importedEvent = service.events().calendarImport('primary', event).execute();

System.out.println(importedEvent.getId());

Python

Usa a biblioteca cliente de Python.

event = {
  'summary': 'Appointment',
  'location': 'Somewhere',
  'organizer': {
    'email': 'organizerEmail',
    'displayName': 'organizerDisplayName'
  },
  'start': {
    'dateTime': '2011-06-03T10:00:00.000-07:00'
  },
  'end': {
    'dateTime': '2011-06-03T10:25:00.000-07:00'
  },
  'attendees': [
    {
      'email': 'attendeeEmail',
      'displayName': 'attendeeDisplayName',
    },
    # ...
  ],
  'iCalUID': 'originalUID'
}

imported_event = service.events().import_(calendarId='primary', body=event).execute()

print imported_event['id']

PHP

Usa a biblioteca cliente de PHP.

$event = new Google_Service_Calendar_Event();
$event->setSummary('Appointment');
$event->setLocation('Somewhere');
$start = new Google_Service_Calendar_EventDateTime();
$start->setDateTime('2011-06-03T10:00:00.000-07:00');
$event->setStart($start);
$end = new Google_Service_Calendar_EventDateTime();
$end->setDateTime('2011-06-03T10:25:00.000-07:00');
$event->setEnd($end);
$attendee1 = new Google_Service_Calendar_EventAttendee();
$attendee1->setEmail('attendeeEmail');
// ...
$attendees = array($attendee1,
                   // ...,
                  );
$event->attendees = $attendees;
$organizer = new Google_Service_Calendar_EventOrganizer();
$organizer->setEmail('organizerEmail');
$organizer->setDisplayName('organizerDisplayName');
$event->setOrganizer($organizer);
$event->setICalUID('originalUID');
$importedEvent = $service->events->import('primary', $event);

echo $importedEvent->getId();

Ruby

Usa a biblioteca de cliente do Ruby.

event = Google::Apis::CalendarV3::Event.new(
  summary: 'Appointment',
  location: 'Somewhere',
  organizer: {
    email: 'organizerEmail',
    display_name: 'organizerDisplayName'
  },
  start: {
    date_time: '2011-06-03T10:00:00.000-07:00'
  },
  end: {
    date_time: '2011-06-03T10:25:00.000-07:00'
  },
  attendees: [
    {
      email: 'attendeeEmail',
      display_name: 'attendeeDisplayName',
    },
    # ...
  ],
  i_cal_uid: 'originalUID'
)
result = client.import_event('primary', event)
print result.id

Confira!

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