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 ID de calendario, llama al método calendarList.list. Si quieres acceder al calendario principal del usuario actual, 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 Ya no está disponible. En su lugar, usa sendUpdates.

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

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

Autorización

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

Permiso
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.events

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

Cuerpo de la solicitud

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

Respuesta

Si se aplica 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 Ruby.

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

Pruébala

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