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 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 postaci 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: za pomocą parametru zapytania możesz określić, którą wersję treści chcesz pobrać.

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. Nowa treść jest przechowywana jako wersja HEAD projektu. Jest używany, gdy skrypt jest wykonywany jako wyzwalacz, w edytorze skryptów, w trybie podglądu dodatku lub jako aplikacja internetowa lub interfejs Apps Script API w trybie programowania.

Uwaga: podczas aktualizowania treści projektu skryptu najpierw wyślij żądanie projects.getContent, aby pobrać tablicę istniejących obiektów File, wprowadź w nich zmiany, a następnie użyj tych obiektów jako danych wejściowych w żądaniu projects.updateContent.File

Ostrzeżenie: nowe treści zastąpią wszystkie istniejące pliki w projekcie skryptu. Pliki, które nie zostały zaktualizowane przez żądanie, są usuwane.

Odczytywanie danych projektu

projects.getMetrics

Wyniki: odczytywanie określonych danych 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.