Crée un événement à partir d'une simple chaîne de texte. Essayez dès maintenant ou consultez 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 bouton "primary " mot clé.
|
Paramètres de requête requis | ||
text |
string |
Texte décrivant l'événement à créer. |
Paramètres de requête facultatifs | ||
sendNotifications |
boolean |
Obsolète. Veuillez plutôt utiliser sendUpdates. Vous voulez recevoir des notifications 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 |
Invités qui doivent recevoir des notifications à propos de la création de l'événement.
Les valeurs possibles sont les suivantes: <ph type="x-smartling-placeholder">
|
Autorisation
Une autorisation est requise pour cette demande. Celle-ci doit inclure au moins l'un des champs d'application suivants:
Champ d'application |
---|
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.events |
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
Lorsque cette méthode fonctionne, elle renvoie une ressource "Events" dans le corps de 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
Elle 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
Elle 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
Elle utilise la bibliothèque cliente PHP.
$createdEvent = $service->events->quickAdd( 'primary', 'Appointment at Somewhere on June 3rd 10am-10:25am'); echo $createdEvent->getId();
Ruby
Elle 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.