Fügt einen vorhandenen Kalender in die Kalenderliste des Nutzers ein. Probieren Sie es jetzt aus oder sehen Sie sich ein Beispiel an.
Anfrage
HTTP-Anfrage
POST https://www.googleapis.com/calendar/v3/users/me/calendarList
Parameter
Parametername | Wert | Beschreibung |
---|---|---|
Optionale Abfrageparameter | ||
colorRgbFormat |
boolean |
Gibt an, ob die Felder foregroundColor und backgroundColor zum Schreiben der Kalenderfarben (RGB) verwendet werden sollen. Wenn diese Funktion verwendet wird, wird das indexbasierte Feld colorId automatisch auf die beste Übereinstimmungsoption festgelegt. Optional. Die Standardeinstellung ist "False".
|
Autorisierung
Für diese Anfrage ist eine Autorisierung mit folgendem Bereich erforderlich:
Umfang |
---|
https://www.googleapis.com/auth/calendar |
Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.
Anfragetext
Geben Sie im Anfragetext eine calendarList-Ressource mit den folgenden Attributen an:
Property-Name | Wert | Beschreibung | Hinweise |
---|---|---|---|
Erforderliche Attribute | |||
id |
string |
ID des Kalenders. | |
Optionale Attribute | |||
backgroundColor |
string |
Die Hauptfarbe des Kalenders im Hexadezimalformat „#0088aa “. Dieses Attribut ersetzt das indexbasierte Attribut colorId . Wenn Sie diese Eigenschaft festlegen oder ändern möchten, müssen Sie colorRgbFormat=true in den Parametern der Methoden insert, update und patch angeben. Optional. |
Bearbeitbar |
colorId |
string |
Die Farbe des Kalenders. Dies ist eine ID, die sich auf einen Eintrag im Abschnitt calendar der Farbdefinition bezieht (siehe Endpunkt für Farben). Diese Eigenschaft wird durch die Attribute backgroundColor und foregroundColor ersetzt und kann bei Verwendung dieser Eigenschaften ignoriert werden. Optional. |
Bearbeitbar |
defaultReminders[] |
list |
Die Standarderinnerungen des authentifizierten Nutzers für diesen Kalender. | Bearbeitbar |
defaultReminders[].method |
string |
Die von dieser Erinnerung verwendete Methode. Mögliche Werte sind:
Erforderlich beim Hinzufügen einer Erinnerung. |
Bearbeitbar |
defaultReminders[].minutes |
integer |
Anzahl der Minuten vor Beginn des Ereignisses, in denen die Erinnerung ausgelöst werden soll. Gültige Werte liegen zwischen 0 und 40.320 (4 Wochen in Minuten). Erforderlich beim Hinzufügen einer Erinnerung. |
Bearbeitbar |
foregroundColor |
string |
Die Vordergrundfarbe des Kalenders im Hexadezimalformat „#ffffff “. Dieses Attribut ersetzt das indexbasierte Attribut colorId . Wenn Sie diese Eigenschaft festlegen oder ändern möchten, müssen Sie colorRgbFormat=true in den Parametern der Methoden insert, update und patch angeben. Optional. |
Bearbeitbar |
notificationSettings |
object |
Die Benachrichtigungen, die der authentifizierte Nutzer für diesen Kalender erhält. | Bearbeitbar |
notificationSettings.notifications[].method |
string |
Die zum Senden der Benachrichtigung verwendete Methode. Möglicher Wert:
Erforderlich beim Hinzufügen einer Benachrichtigung. |
Bearbeitbar |
notificationSettings.notifications[].type |
string |
Die Art der Benachrichtigung. Mögliche Werte sind:
Erforderlich beim Hinzufügen einer Benachrichtigung. |
Bearbeitbar |
selected |
boolean |
Gibt an, ob der Kalenderinhalt in der Kalender-Benutzeroberfläche angezeigt wird. Optional. Die Standardeinstellung ist "False". | Bearbeitbar |
summaryOverride |
string |
Die Zusammenfassung, die der authentifizierte Nutzer für diesen Kalender festgelegt hat. Optional. | Bearbeitbar |
Antwort
Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine calendarList-Ressource 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.CalendarListEntry; // ... // Initialize Calendar service with valid OAuth credentials Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials) .setApplicationName("applicationName").build(); // Create a new calendar list entry CalendarListEntry calendarListEntry = new CalendarListEntry(); calendarListEntry.setId("calendarId"); // Insert the new calendar list entry CalendarListEntry createdCalendarListEntry = service.calendarList().insert(calendarListEntry).execute(); System.out.println(createdCalendarListEntry.getSummary());
Python
Verwendet die Python-Clientbibliothek.
calendar_list_entry = { 'id': 'calendarId' } created_calendar_list_entry = service.calendarList().insert(body=calendar_list_entry).execute() print created_calendar_list_entry['summary']
PHP
Verwendet die PHP-Clientbibliothek.
$calendarListEntry = new Google_Service_Calendar_CalendarListEntry(); $calendarListEntry->setId("calendarId"); $createdCalendarListEntry = $service->calendarList->insert($calendarListEntry); echo $createdCalendarListEntry->getSummary();
Ruby
Verwendet die Ruby-Clientbibliothek.
entry = Google::Apis::CalendarV3::CalendarListEntry.new( id: 'calendarId' ) result = client.insert_calendar_list(entry) print result.summary
Testen!
Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen.