Events: quickAdd

Crea un evento basado en una cadena de texto simple. Pruébalo ahora y ve un ejemplo.

Solicitud

Solicitud HTTP

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

Parámetros

Nombre del parámetro Valor Descripción
Parámetros de ruta de acceso
calendarId string Es el identificador del calendario. Para recuperar los IDs de calendario, llama al método calendarList.list. Si deseas acceder al calendario principal del usuario que accedió actualmente, usa la palabra clave "primary".
Parámetros de consulta obligatorios
text string Es el texto que describe el evento que se creará.
Parámetros de consulta opcionales
sendNotifications boolean Obsoleta. En su lugar, usa sendUpdates.

Determina si se deben enviar notificaciones sobre la creación del evento. Ten en cuenta que es posible que se envíen algunos correos electrónicos incluso si estableces el valor en false. El valor predeterminado es false.
sendUpdates string Invitados que deben recibir notificaciones sobre la creación del evento nuevo.

Los valores aceptables son los siguientes:
  • "all": Las notificaciones se envían a todos los invitados.
  • "externalOnly": Las notificaciones solo se envían a los invitados que no usan el Calendario de Google.
  • "none": No se envían notificaciones. Para las tareas de migración de calendarios, considera usar el método Events.import.

Autorización

Esta solicitud requiere autorización con al menos uno de los siguientes permisos:

Alcance
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.events
https://www.googleapis.com/auth/calendar.app.created
https://www.googleapis.com/auth/calendar.events.owned

Para obtener más información, consulta la página autenticación y autorización.

Cuerpo de la solicitud

No proporciones un cuerpo de la solicitud con este método.

Respuesta

Si se ejecuta de forma correcta, este método muestra un recurso de eventos en el cuerpo de la respuesta.

Ejemplos

Nota: Los ejemplos de código disponibles para este método no representan todos los lenguajes de programación admitidos (consulta la página de bibliotecas cliente para consultar una lista de lenguajes admitidos).

Java

Usa la biblioteca cliente de Java.

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

// ...

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

// Quick-add an event
String eventText = "Appointment at Somewhere on June 3rd 10am-10:25am";
Event createdEvent =
    service.events().quickAdd('primary').setText(eventText).execute();

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

Python

Usa la biblioteca cliente de Python.

created_event = service.events().quickAdd(
    calendarId='primary',
    text='Appointment at Somewhere on June 3rd 10am-10:25am').execute()

print created_event['id']

PHP

Usa la biblioteca cliente de PHP.

$createdEvent = $service->events->quickAdd(
    'primary',
    'Appointment at Somewhere on June 3rd 10am-10:25am');

echo $createdEvent->getId();

Ruby

Usa la biblioteca cliente de Ruby.

result = client.quick_add_event(
  'primary',
  'Appointment at Somewhere on June 3rd 10am-10:25am')
print result.id

Pruébalo

Usa el Explorador de APIs que aparece a continuación para llamar a este método en datos en vivo y ver la respuesta.