Crea un evento basato su una semplice stringa di testo. Prova subito o guarda un esempio.
Richiesta
Richiesta HTTP
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/quickAdd
Parametri
Nome del parametro | Valore | Descrizione |
---|---|---|
Parametri del percorso | ||
calendarId |
string |
Identificatore del calendario. Per recuperare gli ID calendario, chiama il metodo calendarList.list. Utilizza la parola chiave "primary " per accedere al calendario principale dell'utente che ha eseguito l'accesso.
|
Parametri di ricerca obbligatori | ||
text |
string |
Il testo che descrive l'evento da creare. |
Parametri di query facoltativi | ||
sendNotifications |
boolean |
Deprecato. Usa invece sendUpdates. Indica se inviare notifiche sulla creazione 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 sulla creazione del nuovo evento.
I valori accettati sono:
|
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(); // 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
Utilizza la libreria client Python.
created_event = service.events().quickAdd( calendarId='primary', text='Appointment at Somewhere on June 3rd 10am-10:25am').execute() print created_event['id']
PHP
Utilizza la libreria client PHP.
$createdEvent = $service->events->quickAdd( 'primary', 'Appointment at Somewhere on June 3rd 10am-10:25am'); echo $createdEvent->getId();
Ruby
Utilizza la libreria client di Ruby.
result = client.quick_add_event( 'primary', 'Appointment at Somewhere on June 3rd 10am-10:25am') print result.id
Prova.
Utilizza Explorer API di seguito per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.