Zarządzanie projektami

W tej sekcji znajdziesz omówienie metod interfejsu Apps Script API, których możesz używać do tworzenia, odczytywania, modyfikowania i monitorowania projektów Apps Script. Na stronie Zarządzanie projektem znajdziesz przykłady żądań interfejsu API. Szczegółowe informacje o wdrożeniu znajdziesz w dokumentacji referencyjnej dotyczącej poszczególnych metod.

Omówienie metody interfejsu API
Tworzenie projektów

projects.create

Wyniki: utwórz podstawowy, pusty projekt 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 ma być nadrzędnym dla skryptu.

Czytanie metadanych projektu

projects.get

Wyniki: zwraca 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.

Przeczytaj treść projektu

projects.getContent

Wyniki: zwraca tablicę obiektów File, po jednym dla każdego kodu i pliku HTML w projekcie. Lista zawiera również plik manifestu projektu w formacie JSON. Obiekty plików zawierają treść źródłową pliku (File.source) i inne metadane, takie jak lista funkcji w pliku (File.functionSet).

Opcje: za pomocą parametru zapytania możesz określić, jaką wersję treści chcesz pobrać.

Aktualizowanie treści projektu

projects.updateContent

Wyniki: zmienia zawartość pliku w projekcie skryptu. Nowe treści należy podać jako tablicę obiektów File. Jeden z tych obiektów File musi być typu JSON i reprezentować nowy manifest projektu projektu skryptu. Nowe treści są przechowywane jako wersja HEAD projektu. Jest on używany, gdy skrypt jest wykonywany jako element uruchamiający w trybie podglądu edytora skryptu, w trybie podglądu dodatku lub jako aplikacja internetowa lub interfejs Apps Script API w trybie programowania.

Uwaga: podczas aktualizowania treści projektu skryptu należy najpierw przesłać żądanie projects.getContent, aby pobrać tablicę istniejących obiektów File, a następnie użyć tych obiektów jako danych wejściowych do żądania projects.updateContent.File

Ostrzeżenie: nowa zawartość zastąpi wszystkie istniejące pliki w projekcie skryptu. Pliki, które nie zostały zaktualizowane przez prośbę, zostaną usunięte.

Czytanie danych projektu

projects.getMetrics

Wyniki: możesz odczytać określone dane dotyczące projektu. Te dane obejmują liczbę użytkowników, łączną liczbę uruchomień, łączną liczbę błędów wykonania i inne szczegóły. Użyj parametru MetricType , aby określić informacje, których szukasz.

Opcje: możesz ograniczyć wyniki do określonych wdrożeń lub funkcji skryptu za pomocą filtru danych. Możesz też zdefiniować konkretny przedział danych za pomocą elementu MetricsIntervalConfig.