Calendars

Zbiór wszystkich istniejących kalendarzy. Zobacz też Kalendarze a CalendarList.

Listę metod dotyczących tego zasobu znajdziesz na końcu tej strony.

Prezentacje zasobów

{
  "kind": "calendar#calendar",
  "etag": etag,
  "id": string,
  "summary": string,
  "description": string,
  "location": string,
  "timeZone": string,
  "dataOwner": string,
  "conferenceProperties": {
    "allowedConferenceSolutionTypes": [
      string
    ]
  },
  "autoAcceptInvitations": boolean
}
Nazwa usługi Wartość Opis Uwagi
autoAcceptInvitations boolean Czy ten kalendarz automatycznie akceptuje zaproszenia. Dotyczy tylko kalendarzy zasobów.
conferenceProperties nested object Właściwości rozmowy wideo w tym kalendarzu, np. jakie typy rozmów wideo są dozwolone.
conferenceProperties.allowedConferenceSolutionTypes[] list Typy rozwiązań konferencyjnych obsługiwane w tym kalendarzu.

Dostępne wartości:

  • "eventHangout"
  • "eventNamedHangout"
  • "hangoutsMeet"
Opcjonalnie.
dataOwner string Adres e-mail właściciela kalendarza. Ustaw tylko w przypadku kalendarzy pomocniczych. Tylko do odczytu.
description string Opis kalendarza. Opcjonalnie. Z możliwością zapisu
etag etag ETag zasobu.
id string Identyfikator kalendarza. Aby pobrać identyfikatory, wywołaj metodę calendarList.list().
kind string Typ zasobu („calendar#calendar”).
location string Położenie geograficzne kalendarza w postaci tekstu. Opcjonalnie. Z możliwością zapisu
summary string Tytuł kalendarza. Z możliwością zapisu
timeZone string Strefa czasowa kalendarza. (Sformatowana jako nazwa z bazy danych stref czasowych IANA, np. „Europe/Zurich”). Opcjonalnie. Z możliwością zapisu

Metody

clear
Czyści kalendarz główny. Ta operacja usuwa wszystkie wydarzenia powiązane z kalendarzem głównym konta.
delete
Usuwa kalendarz pomocniczy. Aby wyczyścić wszystkie wydarzenia w kalendarzach głównych, użyj metody calendars.clear.
get
Zwraca metadane kalendarza.
insert
Tworzy kalendarz pomocniczy.

Uwierzytelniony użytkownik żądania staje się właścicielem danych nowego kalendarza.

patch
Aktualizuje metadane kalendarza. Ta metoda obsługuje semantykę poprawki. Pamiętaj, że każde żądanie poprawki zużywa 3 jednostki limitu. Zalecamy używanie metody get przed metodą update. Wartości pól, które określisz, zastąpią dotychczasowe wartości. Pola, których nie określisz w żądaniu, pozostaną bez zmian. Jeśli określisz pola tablicowe, zastąpią one dotychczasowe tablice. Spowoduje to odrzucenie wszystkich poprzednich elementów tablicy.
transferOwnership
Przenosi kalendarz pomocniczy między użytkownikami w organizacji Google Workspace. Wymaga uwierzytelnienia użytkownika z uprawnieniami administratora Zarządzanie kalendarzami oraz jednego z tych zakresów autoryzacji:
  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.calendars
W żądaniu ustaw wartość useAdminAccess na true. Aby można było przenieść kalendarz pomocniczy, musi on być aktywny. Przenoszenie wyłączonych lub usuniętych kalendarzy nie jest obsługiwane.
update
Aktualizuje metadane kalendarza.