Calendars: update

Aktualizuje metadane kalendarza. Wypróbuj teraz

Żądanie

Żądanie HTTP

PUT https://www.googleapis.com/calendar/v3/calendars/calendarId

Parametry

Nazwa parametru Wartość Opis
Parametry ścieżki
calendarId string Identyfikator kalendarza. Aby pobrać identyfikatory kalendarzy, wywołaj metodę calendarList.list. Jeśli chcesz uzyskać dostęp do kalendarza głównego aktualnie zalogowanego użytkownika, użyj słowa kluczowego „primary”.

Autoryzacja

To żądanie wymaga autoryzacji z co najmniej jednym z tych zakresów:

Zakres
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.app.created
https://www.googleapis.com/auth/calendar.calendars

Więcej informacji znajdziesz na stronie Uwierzytelnianie i autoryzacja.

Treść żądania

W treści żądania podaj zasób Kalendarze z tymi właściwościami:

Nazwa usługi Wartość Opis Uwagi
Właściwości opcjonalne
description string Opis kalendarza. Opcjonalnie. z możliwością zapisu,
labelProperties nested object Właściwości etykiety zdefiniowane w tym kalendarzu. Jeśli jest określona, zastępuje istniejące właściwości etykiety. Jeśli nie określisz tego ustawienia, właściwości etykiety pozostaną niezmienione. z możliwością zapisu,
labelProperties.eventLabels[] list Etykiety wydarzeń zdefiniowane w tym kalendarzu. Jeśli ten parametr jest obecny podczas aktualizowania kalendarza, zastąpi istniejące etykiety wydarzeń.

Rozwiń listę, aby dodać nową etykietę wydarzenia, i usuń z niej elementy, aby usunąć etykietę z kalendarza.

Każdy kalendarz może mieć maksymalnie 200 etykiet.

 z możliwością zapisu,
labelProperties.eventLabels[].backgroundColor string Kolor tła etykiety w formacie szesnastkowym, np. "#039be5". Wydarzenia z tą etykietą są wyświetlane w tym kolorze. Wymagane. z możliwością zapisu,
labelProperties.eventLabels[].id string Identyfikator etykiety. Opcjonalne podczas wstawiania nowej etykiety. Jeśli nie podasz identyfikatora, zostanie on wygenerowany. Wymagane podczas aktualizowania etykiety.

Jeśli podasz identyfikator, musi on być unikalny w obrębie kalendarza i mieć format UUID.

 z możliwością zapisu,
labelProperties.eventLabels[].name string Nazwa etykiety. Opcjonalnie.

Jeśli podasz tę wartość, może ona zawierać maksymalnie 50 znaków.

 z możliwością zapisu,
location string Położenie geograficzne kalendarza w formacie dowolnego tekstu. Opcjonalnie. z możliwością zapisu,
summary string Tytuł kalendarza. z możliwością zapisu,
timeZone string Strefa czasowa kalendarza. (W formacie nazwy z bazy danych stref czasowych IANA, np. „Europe/Zurich”). Opcjonalnie. z możliwością zapisu,

Odpowiedź

Jeśli operacja się uda, metoda zwróci w treści odpowiedzi zasób Kalendarze.

Wypróbuj

Użyj narzędzia APIs Explorer poniżej, aby wywołać tę metodę na danych na żywo i zobaczyć odpowiedź.