Zaawansowana usługa Kalendarz pozwala na korzystanie z publicznego interfejsu Google Calendar API w Apps Script. Ten interfejs API, podobnie jak wbudowana usługa Kalendarz w Apps Script, umożliwia skryptom dostęp do Kalendarza Google użytkownika, w tym dodatkowych kalendarzy, które subskrybuje, oraz modyfikowanie go. W większości przypadków usługa wbudowana jest łatwiejsza w użyciu, ale ta zaawansowana usługa ma kilka dodatkowych funkcji, w tym możliwość ustawienia koloru tła poszczególnych wydarzeń.
Dokumentacja
Szczegółowe informacje o tej usłudze znajdziesz w dokumentacji publicznego interfejsu Google Calendar API. Podobnie jak wszystkie usługi zaawansowane w Apps Script zaawansowana usługa Kalendarz korzysta z tych samych obiektów, metod i parametrów co publiczny interfejs API. Więcej informacji znajdziesz w artykule Jak określane są podpisy metod.
Aby zgłosić problemy i znaleźć inną pomoc, zapoznaj się z przewodnikiem po Kalendarzu.
Nagłówki żądań HTTP
Zaawansowana usługa Kalendarz może akceptować nagłówki żądań HTTP If-Match
i If-None-Match
. Więcej informacji znajdziesz w dokumentacji referencyjnej.
Przykładowy kod
Przykładowy kod poniżej wykorzystuje wersję 3 interfejsu API.
Tworzenie zdarzeń
Z przykładu poniżej dowiesz się, jak utworzyć wydarzenie w domyślnym kalendarzu użytkownika.
Kalendarze z informacjami o produktach
Poniższy przykład pokazuje, jak pobrać informacje o kalendarzach widocznych na liście kalendarzy użytkownika.
Zdarzenia na stronie z informacjami
Poniższy przykład pokazuje, jak wyświetlić 10 następnych nadchodzących wydarzeń w domyślnym kalendarzu użytkownika.
Warunkowe modyfikowanie zdarzenia
Z przykładu poniżej dowiesz się, jak warunkowo zaktualizować wydarzenie w Kalendarzu za pomocą nagłówka If-Match
. Skrypt tworzy nowe zdarzenie, czeka 30 sekund, a potem aktualizuje je tylko wtedy, gdy od czasu jego utworzenia nie zmieniły się żadne jego szczegóły.
Warunkowe pobieranie zdarzenia
Z przykładu poniżej dowiesz się, jak warunkowo pobrać wydarzenie w Kalendarzu za pomocą nagłówka If-None-Match
. Skrypt tworzy nowe zdarzenie, a potem przez 30 sekund wysyła do niego zapytania pod kątem zmian. Po każdej zmianie zdarzenia pobierana jest nowa wersja.
Synchronizowanie wydarzeń
Poniższy przykład pokazuje, jak pobierać zdarzenia za pomocą tokenów synchronizacji. Gdy uwzględnisz token synchronizacji w żądaniu usługi zaawansowanej Kalendarza, wynikowa odpowiedź będzie zawierać tylko elementy, które zmieniły się od czasu jego wygenerowania, co umożliwi wydajniejsze przetwarzanie. Więcej informacji na temat procesu synchronizacji zawiera artykuł na temat skutecznego synchronizowania zasobów.
W tym przykładzie użyto metody getRelativeDate(daysOffset, hour)
zdefiniowanej w powyższych przykładach.