Zaawansowana usługa Kalendarz umożliwia korzystanie z publicznego interfejsu Google Calendar API w Apps Script. Podobnie jak wbudowana usługa Kalendarz Apps Script ten interfejs API umożliwia skryptom uzyskiwanie dostępu do Kalendarza Google użytkownika i modyfikowanie jego subskrypcji, w tym dodatkowych kalendarzy subskrybowanych przez użytkownika. W większości przypadków usługa wbudowana jest łatwiejsza w użyciu, ale ta zaawansowana usługa oferuje kilka dodatkowych funkcji, w tym ustawianie koloru tła dla poszczególnych wydarzeń.
Dokumentacja
Szczegółowe informacje o tej usłudze znajdziesz w dokumentacji referencyjnej publicznego interfejsu Google Calendar API. Podobnie jak wszystkie usługi zaawansowane w Apps Script, zaawansowana usługa Kalendarza używa tych samych obiektów, metod i parametrów co publiczny interfejs API. Więcej informacji znajdziesz w artykule na temat określania podpisów metod.
Aby zgłosić problemy i uzyskać pomoc, zapoznaj się z przewodnikiem na temat Kalendarza.
Nagłówki żądań HTTP
Zaawansowana usługa Kalendarz akceptuje nagłówki żądań HTTP If-Match
i If-None-Match
. Szczegółowe informacje znajdziesz w dokumentacji referencyjnej.
Przykładowy kod
Przykładowy kod poniżej korzysta z wersji 3 interfejsu API.
Tworzenie zdarzeń
Poniższy przykład pokazuje, jak utworzyć wydarzenie w domyślnym kalendarzu użytkownika.
Kalendarze wizytówek
Ten przykład pokazuje, jak pobrać szczegółowe informacje o kalendarzach wyświetlanych na liście kalendarzy użytkownika.
Lista zdarzeń
Ten przykład pokazuje, jak wyświetlić listę następnych 10 nadchodzących wydarzeń w domyślnym kalendarzu użytkownika.
Warunkowe modyfikowanie zdarzenia
Poniższy przykład pokazuje, jak warunkowo zaktualizować wydarzenie w Kalendarzu za pomocą nagłówka If-Match
. Skrypt tworzy nowe zdarzenie, czeka 30 sekund, a następnie aktualizuje zdarzenie tylko wtedy, gdy od czasu jego utworzenia żadne szczegóły zdarzenia nie uległy zmianie.
Warunkowe pobieranie zdarzenia
Poniższy przykład pokazuje, jak warunkowo pobrać wydarzenie z Kalendarza za pomocą nagłówka If-None-Match
. Skrypt tworzy nowe zdarzenie, a następnie przez 30 sekund sonduje zdarzenie pod kątem zmian. Za każdym razem, gdy wydarzenie się zmieni,
pobrana jest nowa wersja.
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, otrzymana odpowiedź będzie zawierać tylko elementy, które zmieniły się od czasu wygenerowania tego tokena, co usprawnia przetwarzanie. Więcej informacji o procesie synchronizacji znajdziesz w artykule Efektywna synchronizacja zasobów.
Poniższy przykład korzysta z tej samej metody getRelativeDate(daysOffset, hour)
zdefiniowanej w powyższych przykładach.