Class PropertiesService

Usługi

Umożliwia skryptom przechowywanie prostych danych w parach klucz-wartość ograniczonych do jednego skryptu, jednego użytkownika skryptu lub jednego dokumentu, w którym używany jest dodatek. Właściwości nie mogą być współdzielone przez skrypty. Więcej informacji o tym, kiedy należy używać poszczególnych typów właściwości, znajdziesz w przewodniku po usłudze Properties.

// Sets three properties of different types.
const documentProperties = PropertiesService.getDocumentProperties();
const scriptProperties = PropertiesService.getScriptProperties();
const userProperties = PropertiesService.getUserProperties();

documentProperties.setProperty('DAYS_TO_FETCH', '5');
scriptProperties.setProperty(
    'SERVER_URL',
    'http://www.example.com/MyWeatherService/',
);
userProperties.setProperty('DISPLAY_UNITS', 'metric');

Metody

MetodaZwracany typKrótki opis
getDocumentProperties()PropertiesPobiera z otwartego dokumentu, arkusza kalkulacyjnego lub formularza magazyn właściwości (tylko w przypadku tego skryptu), do którego mają dostęp wszyscy użytkownicy.
getScriptProperties()PropertiesPobiera z magazynu usługi dane, do których mają dostęp wszyscy użytkownicy, ale tylko w ramach tego skryptu.
getUserProperties()PropertiesPobiera magazyn właściwości, do którego dostęp ma tylko bieżący użytkownik i tylko w ramach tego skryptu.

Szczegółowa dokumentacja

getDocumentProperties()

Pobiera z otwartego dokumentu, arkusza kalkulacyjnego lub formularza magazyn właściwości (tylko w przypadku tego skryptu), do którego mają dostęp wszyscy użytkownicy. Jest on dostępny tylko wtedy, gdy skrypt jest opublikowany i wykonuje się jako dodatek lub jest powiązany z typem pliku Google. Gdy właściwości dokumentu są niedostępne, ta metoda zwraca null. Właściwości dokumentu utworzone przez skrypt są niedostępne poza tym skryptem, nawet przez inne skrypty, które mają dostęp do tego samego dokumentu.

Powrót

Properties – przechowalnia właściwości tylko dla tego skryptu, do której mają dostęp wszyscy użytkownicy bieżącego dokumentu, lub null, jeśli skrypt nie jest dodatkiem ani nie jest powiązany z plikiem Google Workspace;


getScriptProperties()

Pobiera z magazynu usługi dane, do których mają dostęp wszyscy użytkownicy, ale tylko w ramach tego skryptu.

Powrót

Properties – repozytorium właściwości, do którego mają dostęp wszyscy użytkownicy skryptu.


getUserProperties()

Pobiera magazyn właściwości, do którego dostęp ma tylko bieżący użytkownik i tylko w ramach tego skryptu.

Powrót

Properties – repozytorium właściwości, do którego dostęp ma tylko bieżący użytkownik skryptu.