Zarządzanie projektami

W tej sekcji znajdziesz omówienie metod interfejsu Google Apps Script API, których możesz używać do tworzenia, odczytywania, modyfikowania i monitorowania projektów Google Apps Script. Na stronie z przykładami zarządzania projektami znajdziesz przykłady żądań do interfejsu API. Szczegółowe informacje o wdrażaniu znajdziesz w dokumentacji referencyjnej każdej metody.

Omówienie metod API
Tworzenie projektów	projects.create Wyniki: utworzenie podstawowego, pustego projektu bez plików projektu i domyślnego pliku manifestu projektu. Opcje: możesz podać tytuł projektu. Możesz też utworzyć skrypt powiązany, podając identyfikator Dysku Google pliku Dokumentów, Arkuszy, Formularzy lub Prezentacji Google, który będzie pełnić rolę elementu nadrzędnego skryptu.
Odczytywanie metadanych projektu	projects.get Wyniki: pobiera obiekt Project, który reprezentuje metadane projektu. Te dane obejmują tytuł projektu, identyfikator skryptu, użytkownika, który go utworzył, czas utworzenia i inne szczegóły.
Czytanie treści projektu	projects.getContent Wyniki: zwraca tablicę obiektów File, po jednym dla każdego pliku kodu i HTML w projekcie. Lista zawiera też manifest projektu w formacie pliku JSON. Obiekty plików zawierają treść źródłową pliku (File.source) i inne metadane, takie jak lista funkcji w pliku (File.functionSet). Opcje: możesz określić, która wersja treści ma zostać pobrana za pomocą parametru zapytania.
Aktualizowanie treści projektu	projects.updateContent Wyniki: zmienia zawartość pliku w projekcie skryptu. Nowe treści podajesz jako tablicę obiektów File. Jeden z tych obiektów File musi mieć typ JSON i reprezentować nowy plik manifestu projektu skryptu. Nowe treści są przechowywane jako wersja HEAD projektu. Jest używany, gdy skrypt jest wykonywany jako wyzwalacz, w edytorze skryptów, w trybie podglądu dodatku do Google Workspace lub jako aplikacja internetowa bądź interfejs Apps Script API w trybie programowania. Uwaga: aby zaktualizować zawartość projektu skryptu, najpierw wyślij żądanie projects.getContent , aby pobrać tablicę istniejących obiektów File, wprowadź w nich zamierzone zmiany, a następnie użyj tych obiektów jako danych wejściowych w żądaniu projects.updateContent.File Ostrzeżenie: nowa treść zastąpi wszystkie istniejące pliki w projekcie skryptu. Pliki, które nie zostały zaktualizowane przez żądanie, są usuwane.
Odczytywanie wskaźników projektu	projects.getMetrics Wyniki: odczytywanie określonych wskaźników o projekcie. Obejmują one liczbę użytkowników, łączną liczbę uruchomień, łączną liczbę błędów wykonania i inne szczegóły. Użyj elementu MetricType , aby określić informacje, o które prosisz. Opcje: ogranicz wyniki do określonych wdrożeń lub funkcji skryptu za pomocą MetricsFilter. Możesz też zdefiniować konkretny interwał danych za pomocą elementu MetricsIntervalConfig.