Events: move

Permet de déplacer un événement vers un autre agenda, c'est-à-dire de modifier l'organisateur d'un événement. Notez que seuls default événements peuvent être déplacés. Impossible de déplacer les événements birthday, focusTime, fromGmail, outOfOffice et workingLocation. Essayez dès 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 l'événement est actuellement enregistré.
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 utiliser sendUpdates à la place.

Indique si des notifications doivent être envoyées concernant le changement d'organisateur 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 concernant le changement d'organisateur de l'événement.

Les valeurs possibles sont les suivantes:
  • "all" : des 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, utilisez plutôt la méthode Events.import.

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();

// Move an event to another calendar
Event updatedEvent =
    service.events().move('primary', "eventId", "destinationCalendarId").execute();

System.out.println(updatedEvent.getUpdated());

Python

Elle 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

Elle utilise la bibliothèque cliente PHP.

$result = $service->events->move('primary', 'eventId', 'destinationCalendarId');

// Print the updated date.
echo $result->getUpdated();

Ruby

Elle 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.