Zaawansowana usługa Kalendarz umożliwia korzystanie z publicznych Google Calendar API w Apps Script. Podobnie jak wbudowana usługa Kalendarz Apps Script, ten interfejs API zezwala skryptom na uzyskiwanie dostępu do Kalendarza Google użytkownika i modyfikowanie jego zawartości, w tym Kalendarze dodatkowe, które użytkownik subskrybuje. W większości przypadków wbudowany jest łatwiejsza w użyciu, ale ta zaawansowana usługa zapewnia takie jak ustawianie koloru tła dla poszczególnych wydarzeń.
Dokumentacja
Szczegółowe informacje o tej usłudze można znaleźć w dokumentacji referencyjnej dostępnej publicznie. Interfejs API Kalendarza Google. Podobnie jak w przypadku wszystkich usług zaawansowanych w Apps Script, funkcje zaawansowane Usługa Kalendarz używa tych samych obiektów, metod i parametrów co usługa publiczna API. Więcej informacji znajdziesz w artykule na temat określania podpisów metod.
Aby zgłosić problemy i uzyskać pomoc, zapoznaj się z Przewodnik po konfiguracji Kalendarza
Nagłówki żądań HTTP
Zaawansowana usługa Kalendarz może akceptować nagłówki żądań HTTP
If-Match
i If-None-Match
. Więcej informacji:
dokumentacji referencyjnej.
Przykładowy kod
Przykładowy kod poniżej korzysta z wersji 3 interfejs API.
Tworzenie zdarzeń
Ten przykład pokazuje, jak utworzyć zdarzenie w domyślnej wartości użytkownika kalendarz.
Kalendarze wizytówek
Poniższy przykład pokazuje, jak pobrać szczegóły kalendarzy widoczne na liście kalendarzy użytkownika.
Lista zdarzeń
Poniższy przykład pokazuje, jak wyświetlić listę następnych 10 nadchodzących wydarzeń w w domyślnym kalendarzu użytkownika.
Warunkowe modyfikowanie zdarzenia
Poniższy przykład pokazuje, jak warunkowo zaktualizować wydarzenie w Kalendarzu za pomocą
nagłówek If-Match
. Skrypt tworzy nowe zdarzenie, czeka 30 sekund, po czym
aktualizuje wydarzenie tylko wtedy, gdy od momentu jego utworzenia żadne szczegóły wydarzenia nie uległy zmianie
Utworzono.
Warunkowe pobieranie zdarzenia
Poniższy przykład pokazuje, jak warunkowo pobrać wydarzenie z Kalendarza za pomocą funkcji
nagłówek If-None-Match
. Skrypt tworzy nowe zdarzenie, a następnie przeprowadza
w przypadku zmian przez 30 sekund. Za każdym razem, gdy wydarzenie się zmieni, nowa wersja będzie dostępna
.
Synchronizowanie wydarzeń
Poniższy przykład pokazuje, jak pobierać zdarzenia przy użyciu tokenów synchronizacji. Gdy dodasz token synchronizacji do żądania usługi zaawansowanej Kalendarza, wynikowa odpowiedź zawiera tylko elementy, które zmieniły się od czasu otrzymania tego tokena co pozwoliło usprawnić przetwarzanie. Zobacz Efektywnie synchronizuj zasoby, aby dowiedzieć się więcej na temat: proces synchronizacji.
W poniższym przykładzie użyto tego samego atrybutu getRelativeDate(daysOffset, hour)
zdefiniowaną w powyższych przykładach.