Erstellt ein Ereignis basierend auf einer einfachen Textzeichenfolge. Probieren Sie es aus oder sehen Sie sich ein Beispiel an.
Anfragen
HTTP-Anfrage
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/quickAdd
Parameter
Parametername | Wert | Beschreibung |
---|---|---|
Pfadparameter | ||
calendarId |
string |
Kalender-ID. Rufen Sie die Methode calendarList.list auf, um Kalender-IDs abzurufen. Wenn Sie auf den Hauptkalender des aktuell angemeldeten Nutzers zugreifen möchten, verwenden Sie das Schlüsselwort „primary “.
|
Erforderliche Abfrageparameter | ||
text |
string |
Der Text zur Beschreibung des Ereignisses, das erstellt werden soll. |
Optionale Abfrageparameter | ||
sendNotifications |
boolean |
Veraltet. Verwenden Sie stattdessen sendUpdates. Gibt an, ob Benachrichtigungen über die Erstellung des Termins gesendet werden sollen. Hinweis: Einige E-Mails werden möglicherweise trotzdem gesendet, wenn Sie den Wert auf false festlegen. Der Standardwert ist false .
|
sendUpdates |
string |
Gäste, die Benachrichtigungen zur Erstellung des neuen Termins erhalten sollen.
Zulässige Werte sind:
|
Autorisierung
Für diese Anfrage ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
Umfang |
---|
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.events |
Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.
Anfragetext
Mit dieser Methode keinen Anfragetext bereitstellen.
Antwort
Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine Ereignisressource im Antworttext zurückgegeben.
Beispiele
Hinweis: Bei den für diese Methode verfügbaren Codebeispielen sind nicht alle unterstützten Programmiersprachen vertreten. Eine Liste der unterstützten Sprachen finden Sie auf der Seite für Clientbibliotheken.
Java
Verwendet die Java-Clientbibliothek.
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
Verwendet die Python-Clientbibliothek.
created_event = service.events().quickAdd( calendarId='primary', text='Appointment at Somewhere on June 3rd 10am-10:25am').execute() print created_event['id']
PHP
Verwendet die PHP-Clientbibliothek.
$createdEvent = $service->events->quickAdd( 'primary', 'Appointment at Somewhere on June 3rd 10am-10:25am'); echo $createdEvent->getId();
Ruby
Verwendet die Ruby-Clientbibliothek.
result = client.quick_add_event( 'primary', 'Appointment at Somewhere on June 3rd 10am-10:25am') print result.id
Jetzt testen
Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen.