Integracja Google Calendar <> AppSheet

Chodzi o to, że AppSheet pozwala podłączyć Kalendarz Google jako źródło danych i to jest w porządku, ale ja wolę coś bardziej zaawansowanego. Co powiesz na zagregowany widok wszystkich wydarzeń z różnych kalendarzy i możliwość aktualizacji wszystkich tych wydarzeń zarówno z interfejsu kalendarza Google, jak i aplikacji AppSheet? Brzmi interesująco? Zostań ze mną...

W skrócie, wszystkie niezbędne kalendarze są współdzielone z kontem Google właściciela aplikacji, który wykonuje operacje integracyjne napisane w Apps Script.

Główne punkty to:

1. Struktura danych dla tego rozwiązania zawiera obecnie 3 tabele:
   USERS - tutaj przechowujemy dane specyficzne dla użytkownika oraz relację pomiędzy użytkownikiem a synchronizowanym kalendarzem Google.
   SYNCED_GOOGLE_CALENDARS - tutaj przechowujemy informacje o zsynchronizowanych kalendarzach Google, takie jak calendarId, calendarName, calendarDescription itp.
   EVENTS - tutaj przechowujemy wszystkie wydarzenia ze wszystkich zsynchronizowanych Kalendarzy Google.

2. Projekt Apps Script, który działa jako pomost między API kalendarza a API AppSheet.

3. Instalowalne wyzwalacze Apps Script dla wszystkich Kalendarzy Google, które nasłuchują wszystkich zmian po stronie Kalendarza Google.

4. Właściwości skryptu, które przechowują pary klucz-wartość zawierające identyfikator Kalendarza Google i jego ostatni syncToken.

5. Boty AppSheet, które nasłuchują zdarzeń ADD, EDIT i DELETE w tabeli EVENTS i uruchamiają funkcję Apps Script, która wykonuje różne operacje na określonym kalendarzu za pomocą interfejsu API kalendarza.

6. Boty AppSheet, które nasłuchują zdarzeń ADD & DELETE w tabeli SYNCED_GOOGLE_CALENDARS i uruchamiają funkcję Apps Script, która tworzy lub usuwa instalowalny wyzwalacz dla określonego kalendarza i wykonuje pierwszą pełną synchronizację za pomocą interfejsu API kalendarza.

Nie podam tutaj całego kodu, ponieważ uważam, że GitHub jest lepszym miejscem do jego przechowywania, ale postaram się nakreślić kluczowe kwestie związane z tym projektem. Pewnego dnia w przyszłości utworzę również moje publiczne repozytoria na GitHubie. Daj mi trochę czasu, proszę.

Po pierwsze, jeśli chcesz wykonać jakiekolwiek operacje na dowolnym kalendarzu, potrzebujesz dostępu do tego kalendarza. Jeśli nie jesteś właścicielem, nadal możesz to zrobić, o ile uzyskasz najwyższy możliwy poziom uprawnień. Następną częścią jest zrozumienie CalendarAPI i wreszcie integracja z AppSheet, która obejmuje również zrozumienie AppSheet API. Gdy poczujesz się pewnie i zrozumiesz, jak pracować z tymi zasobami, możemy rozpocząć proces rozwoju 🙂

Te dwie funkcje są odpowiedzialne za tworzenie i usuwanie instalowalnych wyzwalaczy dla kalendarza określonego w zmiennej calId, która jest przekazywana do tych funkcji. Są one uruchamiane po dodaniu lub usunięciu rekordu z tabeli SYNCED_GOOGLE_CALEDARS. Tak może wyglądać widok aplikacji (gdzie zielone kółko ze strzałkami wskazuje, że wyzwalacz dla tego kalendarza został utworzony):

Jak widać, używam wartości zwracanej z funkcji Apps Script, która została uruchomiona w celu połączenia rekordu z tabeli EVENTS z nowo utworzonym wydarzeniem w Kalendarzu Google.

/**

* Logs an error to AppSheet and sends an email notification if AppSheet logging fails.

*

* This function attempts to create a new record in the "your_table_name" table of the specified AppSheet application

* to log the error. If this fails, an email is sent to the specified address with details about both errors.

*

* @param {string} aid The AppSheet application ID.

* @param {string} ak The AppSheet application access key.

* @param {Error} err The error object to be logged.

*/

function logErrorInAppSheet(aid, ak, err) {

   try {

       const url = `https://api.appsheet.com/api/v2/apps/${aid}/tables/${your_table_name}/Action`;

       const headers = {

           "ApplicationAccessKey": ak

       };

       const payload = {

           "Action": "Add",

           "Properties": {

               "Locale": "pl-PL",

               "Timezone": "Central European Standard Time",

           },

           "Rows": [{

               "your_column_name1": Utilities.getUuid(),

               "your_column_name2": err,

               "your_column_name3": "your_email@email.com",

               "your_column_name4": "your_email@email.com",

               "your_column_name5": "Error !!!",

               "your_column_name6": "your_email@email.com",

           }]

       }

       const response = UrlFetchApp.fetch(url, {

           method: "post",

           contentType: "application/json",

           headers: headers,

           payload: JSON.stringify(payload),

           muteHttpExceptions: true

       })

   } catch (e) {

       console.error("There was an error: ", err);

       MailApp.sendEmail("your_email@email.com", "[ERROR] your subject", `This is why the error notification API request didn't work: ${e}\nThis is the main error that happened before sending the error notification API request: ${err}`)

   }

}

Szczerze mówiąc, ten projekt jest dość złożony i naprawdę trudno go w pełni wyjaśnić w jednym artykule, ale mam nadzieję, że zainspiruje to kogoś do zgłębienia tematu, ponieważ moim zdaniem ta integracja może zaoszczędzić wiele niepotrzebnie zmarnowanego czasu.