Komut dosyalarının, kapsamı tek bir komut dosyası, bir komut dosyası kullanıcısı veya eklentinin kullanıldığı bir doküman kapsamındaki anahtar/değer çiftlerinde basit verileri depolamasına olanak tanır. Özellikler, komut dosyaları arasında paylaşılamaz. Her bir mülk türünün ne zaman kullanılacağı hakkında daha fazla bilgi için Mülkler hizmeti kılavuzuna bakın.
// 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');
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
getDocumentProperties() | Properties | Tüm kullanıcıların açık doküman, e-tablo veya form içinde erişebileceği bir özellik deposu alır (yalnızca bu komut dosyası için). |
getScriptProperties() | Properties | Yalnızca bu komut dosyası aracılığıyla tüm kullanıcıların erişebileceği bir mülk deposu alır. |
getUserProperties() | Properties | Yalnızca geçerli kullanıcının ve yalnızca bu komut dosyasının içinde erişebileceği bir mülk deposu alır. |
Ayrıntılı belgeler
getDocumentProperties()
Tüm kullanıcıların açık doküman, e-tablo veya form içinde erişebileceği bir özellik deposu alır (yalnızca bu komut dosyası için). Yalnızca komut dosyası eklenti olarak yayınlanıp çalıştırılıyorsa veya bir Google dosya türüne bağlıysa kullanılabilir. Doküman özellikleri mevcut olmadığında bu yöntem null
değerini döndürür. Bir komut dosyası tarafından oluşturulan doküman özelliklerine, aynı dokümana erişen diğer komut dosyaları da dahil olmak üzere bu komut dosyasının dışında erişilemez.
Return
Properties
: Yalnızca geçerli dokümanın tüm kullanıcılarının erişebileceği, bu komut dosyası için bir özellik deposudur. Komut dosyası eklenti değilse veya bir Google Workspace dosyasına bağlı değilse null
getScriptProperties()
Yalnızca bu komut dosyası aracılığıyla tüm kullanıcıların erişebileceği bir mülk deposu alır.
Return
Properties
: Tüm komut dosyası kullanıcılarının erişebildiği bir mülk deposu
getUserProperties()
Yalnızca geçerli kullanıcının ve yalnızca bu komut dosyasının içinde erişebileceği bir mülk deposu alır.
Return
Properties
: Yalnızca komut dosyasının geçerli kullanıcısının erişebileceği mülk deposu