Class PropertiesService

UsługiUsługa

Umożliwia skryptom przechowywanie prostych danych w postaci par klucz-wartość w zakresie jednego skryptu, jednego użytkownika skryptu lub jednego dokumentu, w którym używany jest dodatek. Właściwości nie można udostępniać między skryptami. Więcej informacji o tym, kiedy 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()PropertiesZwraca magazyn właściwości (tylko dla tego skryptu), do którego wszyscy użytkownicy mają dostęp w otwartym dokumencie, arkuszu kalkulacyjnym lub formularzu.
getScriptProperties()PropertiesPobiera magazyn właściwości, do którego wszyscy użytkownicy mają dostęp, ale tylko w ramach tego skryptu.
getUserProperties()PropertiesPobiera pamięć usługi, do której dostęp ma tylko bieżący lub efektywny użytkownik i tylko w tym skrypcie.

Szczegółowa dokumentacja

getDocumentProperties()

Zwraca magazyn właściwości (tylko dla tego skryptu), do którego wszyscy użytkownicy mają dostęp w otwartym dokumencie, arkuszu kalkulacyjnym lub formularzu. Jest ona dostępna tylko wtedy, gdy skrypt jest opublikowany i wykonywany jako dodatek lub gdy jest powiązany z plikiem Google. Jeśli właściwości dokumentu są niedostępne, ta metoda zwraca wartość null. Do właściwości dokumentu utworzonych przez skrypt nie można uzyskać dostępu poza tym skryptem, nawet za pomocą innych skryptów, które mają dostęp do tego samego dokumentu.

Powrót

Properties – magazyn właściwości tylko dla tego skryptu, do którego 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 magazyn właściwości, do którego wszyscy użytkownicy mają dostęp, ale tylko w ramach tego skryptu.

Powrót

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

getUserProperties()

Pobiera pamięć usługi, do której dostęp ma tylko bieżący lub efektywny użytkownik i tylko w tym skrypcie.

Powrót

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