Wprowadzenie

Interfejs Google Apps Script API umożliwia automatyzowanie tworzenia skryptów, zarządzania nimi i ich wykonywania w Google Apps Script. Możesz programowo tworzyć, modyfikować i wdrażać projekty Google Apps Script oraz zdalnie wykonywać funkcje Apps Script – czynności, które w innym przypadku wymagają użycia edytora skryptów Apps Script lub jego interfejsu.

Ten interfejs API jest często używany do:

  • Tworzenie projektów i wdrożeń Apps Script oraz zarządzanie nimi.
  • Dodawanie i aktualizowanie funkcji w projektach skryptów.
  • wykonywać funkcje Apps Script z innych aplikacji;
  • Monitoruj logi i stany wykonania skryptu.

Interfejs Apps Script API zastępuje też interfejs Apps Script Execution API i rozszerza jego funkcje. Za pomocą interfejsu Apps Script API możesz zdalnie wykonywać funkcje Apps Script, tak jak w przypadku interfejsu Execution API.

Aby używać tego interfejsu API w aplikacjach, musisz włączyć go.

Aby umożliwić innym aplikacjom zarządzanie skryptami, musisz przyznać im dostęp.

Omówienie interfejsu API

Interfejs Apps Script API jest podzielony na kilka zasobów, z których każdy ma określone przeznaczenie i zestaw żądań, które możesz wysyłać. Są to:

  • projects – reprezentacja projektu skryptu. Interfejs API udostępnia metody tworzenia, odczytywania, monitorowania i modyfikowania projektów. Za pomocą tego zasobu możesz zarządzać plikami skryptów i metadanymi projektu.
  • projects.deployments – reprezentacja wdrożenia skryptu. Interfejs API udostępnia metody tworzenia, wyświetlania, aktualizowania i usuwania wdrożeń projektów skryptów. Używaj wdrożeń, aby udostępniać skrypt jako aplikację internetową, dodatek lub plik wykonywalny.
  • projects.versions – reprezentacja wersji projektu skryptu. Interfejs API udostępnia metody tworzenia i odczytywania wersji projektu. Używaj wersji, aby śledzić różne iteracje projektu skryptu.
  • processes – reprezentacja wykonania funkcji skryptu. Interfejs API udostępnia metody wyświetlania listy istniejących procesów i zbierania informacji o nich, takich jak typ i bieżący stan. Za pomocą tego zasobu możesz monitorować wykonywanie skryptów zainicjowane metodą scripts.run.
  • scripts – punkt końcowy, który udostępnia metody zdalnego wykonywania funkcji Apps Script. Za pomocą tego zasobu możesz uruchamiać funkcje w projekcie skryptu z poziomu aplikacji.