Class PropertiesService

PropertiesService

允許指令碼在鍵/值組合中儲存簡單資料,此鍵/值組合的範圍限定為單一指令碼、一位使用者,或是使用外掛程式的文件。無法在指令碼之間共用屬性。如要進一步瞭解每種屬性的使用時機,請參閱屬性服務指南

// 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


getScriptProperties()

取得一個屬性儲存庫,供所有使用者存取,但僅限於此指令碼內。

回攻員

Properties:指令碼存放區,讓指令碼的所有使用者存取


getUserProperties()

取得僅限目前使用者可存取的屬性儲存庫,而且只能在此指令碼中存取。

回攻員

Properties:屬性存放區,只有指令碼目前的使用者可以存取