Déplace un événement vers un autre agenda ou change l'organisateur de l'événement. Notez que seuls les événements default
peuvent être déplacés ; les événements outOfOffice
, focusTime
, workingLocation
et fromGmail
ne peuvent pas être déplacés.
Essayez maintenant ou consultez un exemple.
Requête
Requête HTTP
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId/move
Paramètres
Nom du paramètre | Valeur | Description |
---|---|---|
Paramètres de chemin d'accès | ||
calendarId |
string |
Identifiant de l'agenda source dans lequel se trouve actuellement l'événement. |
eventId |
string |
Identifiant d'événement. |
Paramètres de requête requis | ||
destination |
string |
Identifiant de l'agenda cible vers lequel l'événement doit être déplacé. |
Paramètres de requête facultatifs | ||
sendNotifications |
boolean |
Obsolète. Veuillez plutôt utiliser sendUpdates. Permet d'envoyer des notifications concernant le changement d'organisateur de l'événement. Notez que certains e-mails peuvent quand même être envoyés, même si vous définissez la valeur sur false . La valeur par défaut est false .
|
sendUpdates |
string |
Invités devant recevoir des notifications concernant le changement d'organisateur de l'événement.
Les valeurs acceptées sont les suivantes :
|
Autorisation
Une autorisation est requise pour cette requête. 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 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(); // Move an event to another calendar Event updatedEvent = service.events().move('primary', "eventId", "destinationCalendarId").execute(); System.out.println(updatedEvent.getUpdated());
Python
Utilise la bibliothèque cliente Python
# First retrieve the event from the API. updated_event = service.events().move( calendarId='primary', eventId='eventId', destination='destinationCalendarId').execute() # Print the updated date. print updated_event['updated']
PHP
Utilise la bibliothèque cliente PHP
$result = $service->events->move('primary', 'eventId', 'destinationCalendarId'); // Print the updated date. echo $result->getUpdated();
Ruby
Utilise la bibliothèque cliente Ruby.
result = client.move_event('primary', 'eventId', 'destinationCalendarId') print result.updated
Essayer
Utilisez l'explorateur d'API ci-dessous pour appeler cette méthode sur des données en direct, puis observez la réponse.