Events: move

Sposta un evento in un altro calendario, ad esempio modifica l'organizzatore di un evento. Tieni presente che puoi spostare solo gli eventi default, mentre gli eventi outOfOffice, focusTime e workingLocation non possono essere spostati. Prova subito o guarda un esempio.

Richiesta

Richiesta HTTP

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

Parametri

Nome del parametro Valore Descrizione
Parametri del percorso
calendarId string Identificatore del calendario del calendario di origine in cui si trova attualmente l'evento.
eventId string Identificatore dell'evento.
Parametri di ricerca obbligatori
destination string Identificatore del calendario di destinazione in cui deve essere spostato l'evento.
Parametri di query facoltativi
sendNotifications boolean Deprecato. Usa invece sendUpdates.

Indica se inviare notifiche relative al cambiamento dell'organizzatore dell'evento. Tieni presente che alcune email potrebbero comunque essere inviate anche se imposti il valore su false. Il valore predefinito è false.
sendUpdates string Invitati che devono ricevere notifiche relative al cambiamento dell'organizzatore dell'evento.

I valori accettati sono:
  • "all": le notifiche vengono inviate a tutti gli invitati.
  • "externalOnly": le notifiche vengono inviate solo agli invitati che non utilizzano Google Calendar.
  • "none": non viene inviata alcuna notifica. Per le attività di migrazione del calendario, ti consigliamo di utilizzare invece il metodo Events.import.

Autorizzazione

Questa richiesta richiede l'autorizzazione con almeno uno dei seguenti ambiti:

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

Per ulteriori informazioni, consulta la pagina relativa all'autenticazione e autorizzazione.

Corpo della richiesta

Non fornire il corpo di una richiesta con questo metodo.

Risposta

In caso di esito positivo, questo metodo restituisce una risorsa Eventi nel corpo della risposta.

Esempi

Nota: gli esempi di codice disponibili per questo metodo non rappresentano tutti i linguaggi di programmazione supportati (consulta la pagina relativa alle librerie client per un elenco dei linguaggi supportati).

Java

Utilizza la libreria client 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

Utilizza la libreria client 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

Utilizza la libreria client PHP.

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

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

Ruby

Utilizza la libreria client di Ruby.

result = client.move_event('primary', 'eventId', 'destinationCalendarId')
print result.updated

Prova.

Utilizza Explorer API di seguito per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.