Calendars: update

Aktualizuje metadane kalendarza. Wypróbuj go 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 poświęconej uwierzytelnianiu i autoryzacji.

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 etykiet zdefiniowane w tym kalendarzu. Jeśli jest określona, zastępuje istniejące właściwości etykiety. Jeśli nie określisz tej wartości, właściwości etykiety pozostaną niezmienione. z możliwością zapisu
labelProperties.eventLabels[] list Etykiety wydarzeń zdefiniowane w tym kalendarzu. Jeśli ta opcja jest obecna podczas aktualizowania kalendarza, zastąpi ona istniejące etykiety wydarzeń.

Rozwiń listę, aby dodać nową etykietę wydarzenia, i usuń elementy z listy, 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 wygenerowany unikalny identyfikator. Wymagane podczas aktualizowania etykiety.

Jeśli podasz identyfikator, musi on być unikalny w kalendarzu i mieć format UUID.

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

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

 z możliwością zapisu
location string Położenie geograficzne kalendarza w postaci tekstu w dowolnym formacie. Opcjonalnie. z możliwością zapisu
summary string Nazwa kalendarza. z możliwością zapisu
timeZone string Strefa czasowa kalendarza. (Sformatowana jako nazwa bazy danych stref czasowych IANA, np. „Europe/Zurich”). Opcjonalnie. z możliwością zapisu
workingHours object Reprezentuje informacje o godzinach pracy użytkownika. Ta funkcja jest dostępna tylko w przypadku kalendarzy głównych użytkowników Google Workspace. Aby zaktualizować godziny pracy, należy przekazać cały obiekt godzin pracy. Jeśli nie zostanie określona (lub zostanie przekazana jako wartość null lub pusty obiekt), dotychczasowe godziny pracy pozostaną bez zmian. Aby wyłączyć godziny pracy lub wyczyścić harmonogram, ustaw właściwość workingHoursEnabled na wartość false (i pomiń właściwość availableTimes lub przekaż pustą listę). z możliwością zapisu
workingHours.availableTimes[] list Godziny pracy. Każdy okres dostępności reprezentuje blok godzin pracy użytkownika w ciągu jednego dnia. z możliwością zapisu
workingHours.availableTimes[].dayOfWeek string Dzień tygodnia. Wymagane. Możliwe wartości:
  • „monday”
  • „tuesday”
  • „wednesday”
  • „thursday”
  • „friday”
  • „saturday”
  • „sunday”
z możliwością zapisu
workingHours.availableTimes[].periodEnd integer Koniec okresu, w minutach od początku dnia, bez uwzględniania tej wartości. Wymagane. z możliwością zapisu
workingHours.availableTimes[].periodStart integer Początek okresu, w minutach od początku dnia, włącznie. Wymagane. z możliwością zapisu
workingHours.workingHoursEnabled boolean Określa, czy godziny pracy są włączone w tym kalendarzu. Nie można ustawić wartości „true”, gdy pole availableTimes jest puste. z możliwością zapisu

Odpowiedź

Jeśli operacja się powiedzie, ta metoda zwróci w treści odpowiedzi zasób Calendars.

Wypróbuj

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