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. Strona Zarządzanie projektami zawiera przykłady żądań zarządzania interfejsami API. Szczegółowe informacje o implementacji znajdziesz w dokumentacji referencyjnej każdej metody.

Omówienie metod interfejsu API
Tworzenie projektów

project.create

Wyniki: utwórz podstawowy, pusty projekt bez plików projektu i domyślny plik manifestu projektu.

Opcje: możesz podać tytuł projektu. Możesz też utworzyć skrypt powiązany, podając identyfikator pliku Dokumentów, Arkuszy, Formularzy lub Prezentacji Google na Dysku Google, który będzie pełnił rolę elementu nadrzędnego skryptu.

Odczytywanie metadanych projektu

project.get

Wyniki: pobiera obiekt Project, który reprezentuje metadane projektu. Dane te obejmują tytuł projektu, identyfikator skryptu, czas utworzenia użytkownika, czas utworzenia i inne szczegóły.

Odczytywanie treści projektu

project.getContent

Wyniki: zwraca tablicę obiektów File, po 1 na każdy kod i plik HTML w projekcie. Lista zawiera też plik manifestu projektu w postaci pliku JSON. Obiekty File zawierają źródłową treść 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

project.updateContent

Wyniki: zmienia zawartość pliku w projekcie skryptu. Nowe treści podajesz w postaci tablicy obiektów File. Jeden z tych obiektów File musi być typu JSON i reprezentować nowy plik manifestu projektu skryptu. Nowa treść jest przechowywana jako wersja HEAD projektu. Jest on używany, gdy skrypt jest uruchamiany jako wyzwalacz, w edytorze skryptów, w trybie podglądu dodatku albo jako aplikacja internetowa lub interfejs Apps Script API w trybie programisty.

Uwaga: podczas aktualizowania zawartości projektu skryptu często należy najpierw wysłać żądanie project.getContent, aby pobrać tablicę istniejących obiektów File, określić potrzeby tych obiektów, a następnie użyć File jako danych wejściowych dla żądania project.updateContent.

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

Odczytywanie wskaźników projektu

project.getMetrics

Wyniki: możesz odczytać określone wskaźniki dotyczące projektu. Te wskaźniki obejmują liczbę użytkowników, łączną liczbę wykonań, łączną liczbę błędów wykonania i inne szczegóły. Użyj MetricType, by określić informacje, których dotyczy Twoje żądanie.

Opcje: ogranicz wyniki do konkretnych wdrożeń lub funkcji skryptów za pomocą narzędzia MetricsFilter. Interwał wskaźników możesz też określić za pomocą metody MetricsIntervalConfig.