允許指令碼在鍵/值組合中儲存簡單資料,此鍵/值組合的範圍限定為單一指令碼、一位使用者,或是使用外掛程式的文件。無法在指令碼之間共用屬性。如要進一步瞭解每種屬性的使用時機,請參閱屬性服務指南。
// Sets three properties of different types. var documentProperties = PropertiesService.getDocumentProperties(); var scriptProperties = PropertiesService.getScriptProperties(); var userProperties = PropertiesService.getUserProperties(); documentProperties.setProperty('DAYS_TO_FETCH', '5'); scriptProperties.setProperty('SERVER_URL', 'http://www.example.com/MyWeatherService/'); userProperties.setProperty('DISPLAY_UNITS', 'metric');
方法
方法 | 傳回類型 | 簡短說明 |
---|---|---|
getDocumentProperties() | Properties | 取得一個屬性存放區 (僅適用於這個指令碼),所有使用者可在開啟文件、試算表或表單中存取。 |
getScriptProperties() | Properties | 取得一個屬性儲存庫,供所有使用者存取,但僅限於此指令碼內。 |
getUserProperties() | Properties | 取得僅限目前使用者可存取的屬性儲存庫,而且只能在此指令碼中存取。 |
內容詳盡的說明文件
getDocumentProperties()
取得一個屬性存放區 (僅適用於這個指令碼),所有使用者可在開啟文件、試算表或表單中存取。只有在指令碼以外掛程式形式發布並執行,或已繫結至 Google 檔案類型時,才能使用這個函式。沒有可用的文件屬性時,這個方法會傳回 null
。即使其他指令碼存取同一份文件,透過指令碼建立的文件屬性也無法在該指令碼外存取。
回攻員
Properties
:這個指令碼的屬性儲存庫,僅供目前文件的所有使用者存取,如果指令碼不是外掛程式或與 Google Workspace 檔案繫結,則為 null