Events: quickAdd

Crée un événement à partir d'une chaîne de texte simple. Essayez maintenant ou voir un exemple

Requête

Requête HTTP

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

Paramètres

Nom du paramètre Valeur Description
Paramètres de chemin d'accès
calendarId string Identifiant de l'agenda. Pour récupérer les ID d'agenda, appelez la méthode calendarList.list. Si vous souhaitez accéder à l'agenda principal de l'utilisateur actuellement connecté, utilisez le mot clé "primary".
Paramètres de requête obligatoires
text string Texte décrivant l'événement à créer.
Paramètres de requête facultatifs
sendNotifications boolean Obsolète. Veuillez utiliser sendUpdates à la place.

Indique si des notifications doivent être envoyées concernant la création de l'événement. Notez que certains e-mails peuvent toujours être envoyés, même si vous définissez la valeur sur false. La valeur par défaut est false.
sendUpdates string Les invités qui doivent recevoir des notifications concernant la création du nouvel événement.

Les valeurs acceptées sont les suivantes :
  • "all": les notifications sont envoyées à tous les invités.
  • "externalOnly": les notifications ne sont envoyées qu'aux invités qui n'utilisent pas Google Agenda.
  • "none": aucune notification n'est envoyée. Pour les tâches de migration d'agenda, nous vous conseillons d'utiliser plutôt la méthode Events.import.

Autorisation

Cette requête nécessite une autorisation avec au moins l'un des champs d'application suivants:

Portée
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

Pour en savoir plus, consultez la page Authentification et autorisation.

Corps de la requête

Ne spécifiez pas de corps de requête pour cette méthode.

Réponse

Si la requête aboutit, cette méthode renvoie une ressource "Events" dans le corps de la réponse.

Exemples

Remarque : Les langages de programmation compatibles ne figurent pas tous dans les exemples de code présentés pour cette méthode (consultez la page Bibliothèques clientes pour obtenir la liste des langages compatibles).

Java

Utilise la bibliothèque cliente 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

Utilise la bibliothèque cliente Python.

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

print created_event['id']

PHP

Utilise la bibliothèque cliente PHP.

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

echo $createdEvent->getId();

Ruby

Utilise la bibliothèque cliente Ruby.

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

Essayer

Utilisez l'explorateur d'API ci-dessous pour appeler cette méthode sur des données en direct, puis observez la réponse.