Properties hizmeti, basit verileri bir komut dosyası, bir komut dosyası kullanıcısı veya bir eklentinin kullanıldığı bir dokümanla sınırlı anahtar/değer çiftleri olarak depolamanıza olanak tanır. Genellikle geliştirici yapılandırmasını veya kullanıcı tercihlerini depolamak için kullanılır. Özellikler hiçbir zaman komut dosyaları arasında paylaşılmaz.
Properties hizmetinin günlük kotalarını ve depolama alanı sınırlarını görüntülemek için Google hizmetlerinin kotaları başlıklı makaleyi inceleyin.
Mülk mağazalarının karşılaştırılması
PropertiesService
global nesnesi, her biri benzer bir Properties
nesnesi döndüren ancak aşağıdaki tabloda gösterildiği gibi farklı erişim haklarına sahip üç yöntem sunar:
Komut Dosyası Özellikleri | Kullanıcı Özellikleri | Doküman Özellikleri | |
---|---|---|---|
Erişim yöntemi | getScriptProperties() |
getUserProperties() |
getDocumentProperties() |
Şunlar arasında paylaşılan veriler: | Bir komut dosyasının, eklentinin veya web uygulamasının tüm kullanıcıları | Bir komut dosyasının, eklentinin veya web uygulamasının mevcut kullanıcısı | Açık belgedeki bir eklentinin tüm kullanıcıları |
Genellikle kullanıldığı yer | Uygulama genelinde yapılandırma verileri (ör. geliştiricinin harici veritabanı için kullanıcı adı ve şifre) | Kullanıcıya özel ayarlar (ör. metrik veya İngiliz birimleri) | Dokümana özgü veriler (ör. yerleştirilmiş bir grafiğin kaynak URL'si) |
Veri biçimi
Properties hizmeti, tüm verileri anahtar/değer çiftlerinde dize olarak depolar. Kaydedilmiş nesnelerde bulunan yöntemler de dahil olmak üzere, henüz dize olmayan veri türleri otomatik olarak dizelere dönüştürülür.
Veri tasarrufu
Tek bir değeri kaydetmek için aşağıdaki örnekte gösterildiği gibi uygun mağazanın Properties.setProperty(key,
value)
yöntemini çağırın:
Verileri toplu olarak kaydetmek için anahtar/değer çiftlerinin haritasını Properties.setProperties(properties)
öğesine iletin.
Parametredeki nesnenin her anahtar/değer çifti ayrı bir özellik olarak depolanır:
Verileri okuma
Daha önce kaydettiğiniz tek bir değeri almak için Properties.getProperty(key)
işlevini çağırın:
Mevcut özellik deposundaki tüm değerleri almak için Properties.getProperties()
işlevini çağırın:
Verileri değiştirme
getProperty()
ve getProperties()
yöntemleri, canlı görünüm değil, depolanan verilerin bir kopyasını döndürür. Bu nedenle, döndürülen nesnenin değiştirilmesi, özellik deposundaki değeri güncellemez. Mağazadaki verileri güncellemek için verileri tekrar kaydetmeniz yeterlidir:
Veri silme
Tek bir değeri silmek için Properties.deleteProperty(key)
işlevini çağırın:
Mevcut mağazadaki tüm mülkleri silmek için Properties.deleteAllProperties()
işlevini çağırın:
Komut dosyası özelliklerini manuel olarak yönetme
Proje ayarları sayfasından anahtar/değer çiftleri olarak en fazla elli özel özelliği manuel olarak ekleyebilirsiniz. Elli adetten fazla özellik eklemek için Verileri kaydetme bölümünde yukarıda açıklanan yöntemleri kullanarak bu özellikleri programlı bir şekilde eklemeniz gerekir. Proje ayarları sayfasından komut dosyası özelliklerini ayarladığınızda komut dosyası değişkenlerine başvuramazsınız.
Komut dosyası özellikleri ekleme
- Apps Komut Dosyası projenizi açın.
- Sol tarafta Proje Ayarları'nı
tıklayın.
- İlk özelliği eklemek için Komut Dosyası Özellikleri bölümünde Komut dosyası özelliği ekle'yi tıklayın.
- İkinci ve sonraki özellikleri eklemek için Komut Dosyası Özellikleri bölümünde Komut dosyası özelliklerini düzenle > Komut dosyası özelliği ekle'yi tıklayın.
- Özellik için anahtar adını girin.
- Değer alanına anahtarın değerini girin.
- (İsteğe bağlı) Daha fazla özellik eklemek için Komut dosyası özelliği ekle'yi tıklayın.
- Komut dosyası özelliklerini kaydet'i tıklayın.
Komut dosyası özelliklerini düzenleme
- Apps Komut Dosyası projenizi açın.
- Sol tarafta Proje Ayarları'nı
tıklayın.
- Komut Dosyası Özellikleri bölümünde Komut dosyası özelliklerini düzenle'yi tıklayın.
- Değiştirmek istediğiniz her mülk için anahtar adında ve anahtar değerinde değişiklik yapın.
- Komut dosyası özelliklerini kaydet'i tıklayın.
Komut dosyası özelliklerini silme
- Apps Komut Dosyası projenizi açın.
- Sol tarafta Proje Ayarları'nı
tıklayın.
- Komut Dosyası Özellikleri bölümünde Komut dosyası özelliklerini düzenle'yi tıklayın.
- Silmek istediğiniz mülkün yanındaki Kaldır'ı tıklayın.
- Komut dosyası özelliklerini kaydet'i tıklayın.