CalendarList

Zbiór kalendarzy na liście kalendarzy użytkownika. Zobacz też Kalendarze a CalendarList.

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

Prezentacje zasobów

{
  "kind": "calendar#calendarListEntry",
  "etag": etag,
  "id": string,
  "summary": string,
  "description": string,
  "location": string,
  "timeZone": string,
  "dataOwner": string,
  "summaryOverride": string,
  "colorId": string,
  "backgroundColor": string,
  "foregroundColor": string,
  "hidden": boolean,
  "selected": boolean,
  "accessRole": string,
  "defaultReminders": [
    {
      "method": string,
      "minutes": integer
    }
  ],
  "notificationSettings": {
    "notifications": [
      {
        "type": string,
        "method": string
      }
    ]
  },
  "primary": boolean,
  "deleted": boolean,
  "conferenceProperties": {
    "allowedConferenceSolutionTypes": [
      string
    ]
  },
  "autoAcceptInvitations": boolean
}
Nazwa usługi Wartość Opis Uwagi
accessRole string Rola dostępu, którą uwierzytelniony użytkownik ma w kalendarzu. Tylko do odczytu. Możliwe wartości:
  • „freeBusyReader” – zapewnia dostęp do informacji o dostępności.
  • „reader” – zapewnia dostęp do kalendarza. Wydarzenia prywatne będą widoczne dla użytkowników z dostępem do odczytu, ale szczegóły wydarzeń będą ukryte.
  • „writerWithoutPrivateAccess” – zapewnia dostęp do odczytu i zapisu w kalendarzu. Wydarzenia prywatne będą widoczne dla użytkowników z dostępem do zapisu bez dostępu do prywatnych wydarzeń, ale szczegóły wydarzeń będą ukryte.
  • „writer” – zapewnia dostęp do odczytu i zapisu w kalendarzu. Wydarzenia prywatne będą widoczne dla użytkowników z dostępem do zapisu, a szczegóły wydarzeń będą widoczne.
  • „owner” – zapewnia dostęp do zarządzania kalendarzem. Ta rola ma wszystkie uprawnienia roli zapisującego oraz dodatkową możliwość wyświetlania i modyfikowania poziomów dostępu innych użytkowników.

autoAcceptInvitations boolean Czy ten kalendarz automatycznie akceptuje zaproszenia. Dotyczy tylko kalendarzy zasobów. Tylko do odczytu.
backgroundColor string Główny kolor kalendarza w formacie szesnastkowym „#0088aa”. Ta właściwość zastępuje właściwość colorId opartą na indeksie. Aby ustawić lub zmienić tę właściwość, musisz w parametrach metod insert, update i patch określić colorRgbFormat=true. Opcjonalnie. z możliwością zapisu
colorId string Kolor kalendarza. Jest to identyfikator odwołujący się do wpisu w sekcji calendar definicji kolorów (patrz punkt końcowy colors). Ta właściwość jest zastępowana przez właściwości backgroundColor i foregroundColor i można ją ignorować podczas korzystania z tych właściwości. Opcjonalnie. z możliwością zapisu
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.

Możliwe wartości:

  • "eventHangout"
  • "eventNamedHangout"
  • "hangoutsMeet"
Opcjonalnie.
dataOwner string Adres e-mail właściciela kalendarza. Ustaw tylko w przypadku kalendarzy pomocniczych. Tylko do odczytu.
defaultReminders[] list Domyślne przypomnienia, które uwierzytelniony użytkownik ma w tym kalendarzu. z możliwością zapisu
defaultReminders[].method string Metoda używana przez to przypomnienie. Możliwe wartości:
  • „email” – przypomnienia są wysyłane e-mailem.
  • „popup” – przypomnienia są wysyłane w wyskakującym okienku interfejsu użytkownika.

Wymagane podczas dodawania przypomnienia.

 z możliwością zapisu
defaultReminders[].minutes integer Liczba minut przed rozpoczęciem wydarzenia, po upływie których ma się pojawić przypomnienie. Prawidłowe wartości to liczby od 0 do 40320 (4 tygodnie w minutach).

Wymagane podczas dodawania przypomnienia.

 z możliwością zapisu
deleted boolean Czy ten wpis na liście kalendarzy został usunięty z listy kalendarzy. Tylko do odczytu. Opcjonalnie. Wartość domyślna to False (fałsz).
description string Opis kalendarza. Opcjonalnie. Tylko do odczytu.
etag etag ETag zasobu.
foregroundColor string Kolor pierwszego planu kalendarza w formacie szesnastkowym „#ffffff”. Ta właściwość zastępuje właściwość colorId opartą na indeksie. Aby ustawić lub zmienić tę właściwość, musisz w parametrach metod insert, update i patch określić colorRgbFormat=true. Opcjonalnie. z możliwością zapisu
hidden boolean Czy kalendarz został ukryty na liście. Opcjonalnie. Atrybut jest zwracany tylko wtedy, gdy kalendarz jest ukryty. W takim przypadku wartość to true. z możliwością zapisu
id string Identyfikator kalendarza.
kind string Typ zasobu („calendar#calendarListEntry”).
location string Położenie geograficzne kalendarza w postaci tekstu. Opcjonalnie. Tylko do odczytu.
notificationSettings object Powiadomienia, które uwierzytelniony użytkownik otrzymuje z tego kalendarza. z możliwością zapisu
notificationSettings.notifications[] list Lista powiadomień ustawionych dla tego kalendarza.
notificationSettings.notifications[].method string Metoda dostarczania powiadomienia. Możliwa wartość:
  • „email” – powiadomienia są wysyłane e-mailem.

Wymagane podczas dodawania powiadomienia.

 z możliwością zapisu
notificationSettings.notifications[].type string Typ powiadomienia. Możliwe wartości:
  • „eventCreation” – powiadomienie wysyłane, gdy w kalendarzu pojawi się nowe wydarzenie.
  • „eventChange” – powiadomienie wysyłane, gdy wydarzenie zostanie zmienione.
  • „eventCancellation” – powiadomienie wysyłane, gdy wydarzenie zostanie odwołane.
  • „eventResponse” – powiadomienie wysyłane, gdy uczestnik odpowie na zaproszenie na wydarzenie.
  • „agenda” – harmonogram z wydarzeniami dnia (wysyłany rano).

Wymagane podczas dodawania powiadomienia.

 z możliwością zapisu
primary boolean Czy kalendarz jest kalendarzem głównym uwierzytelnionego użytkownika. Tylko do odczytu. Opcjonalnie. Wartość domyślna to False (fałsz).
selected boolean Czy zawartość kalendarza jest wyświetlana w interfejsie Kalendarza. Opcjonalnie. Wartość domyślna to False (fałsz). z możliwością zapisu
summary string Nazwa kalendarza. Tylko do odczytu.
summaryOverride string Podsumowanie ustawione przez uwierzytelnionego użytkownika dla tego kalendarza. Opcjonalnie. z możliwością zapisu
timeZone string Strefa czasowa kalendarza. Opcjonalnie. Tylko do odczytu.

Metody

usuń
Usuwa kalendarz z listy kalendarzy użytkownika.
zacznij korzystać z
Zwraca kalendarz z listy kalendarzy użytkownika.
wstaw
Wstawia istniejący kalendarz na listę kalendarzy użytkownika.
list
Zwraca kalendarze na liście kalendarzy użytkownika.
poprawka
Aktualizuje istniejący kalendarz na liście kalendarzy użytkownika. 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 podane w żądaniu zastępują dotychczasowe wartości. Pola, których nie określisz w żądaniu, pozostaną bez zmian. Pola tablicowe, jeśli zostaną określone, zastępują istniejące tablice. Spowoduje to odrzucenie wszystkich poprzednich elementów tablicy.
aktualizacja
Aktualizuje istniejący kalendarz na liście kalendarzy użytkownika.
obserwuj
Obserwuj zmiany w zasobach CalendarList.