Özellikler hizmeti, basit verileri tek bir komut dosyası, bir komut dosyası kullanıcısı veya eklentinin kullanıldığı bir doküman kapsamında anahtar/değer çiftlerinde 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.
Mülkler hizmetinin günlük kotalarını ve depolama alanı sınırlarını görmek için Google Hizmetleri Kotalar sayfasını inceleyin.
Emlak mağazalarının karşılaştırması
PropertiesService
global nesnesi, aşağıdaki tabloda gösterildiği gibi her biri benzer bir Properties
nesnesi döndüren ancak 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() |
Şu kullanıcılar arasında paylaşılan veriler: | Bir komut dosyası, eklenti veya web uygulamasının tüm kullanıcıları | Bir komut dosyası, eklenti veya web uygulamasının geçerli kullanıcısı | Açık dokümandaki bir eklentinin tüm kullanıcıları |
Tipik kullanım alanı | Geliştiricinin harici veritabanının kullanıcı adı ve şifresi gibi uygulama genelindeki yapılandırma verileri | Metrik veya İngiliz ölçü birimleri gibi kullanıcıya özel ayarlar | Yerleştirilmiş bir grafiğin kaynak URL'si gibi dokümana özgü veriler |
Veri biçimi
Özellikler hizmeti, tüm verileri anahtar/değer çiftlerinde dize olarak depolar. Halihazırda dize olmayan veri türleri, kaydedilen nesnelerde yer alan yöntemler dahil olmak üzere 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 bir eşlemesini Properties.setProperties(properties)
hizmetine 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)
numaralı telefonu arayın:
Geçerli mülk mağazasındaki tüm değerleri almak için Properties.getProperties()
çağrısı yapın:
Verileri değiştirme
getProperty()
ve getProperties()
yöntemleri canlı görüntüleme değil, depolanan verilerin bir kopyasını döndürür. Bu nedenle, döndürülen nesnenin değiştirilmesi, mülk 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)
numaralı telefonu arayın:
Geçerli mağazadaki tüm mülkleri silmek için Properties.deleteAllProperties()
çağrısı yapın:
Komut dosyası özelliklerini manuel olarak yönetme
Proje ayarları sayfasından manuel olarak en fazla elli özel özelliği anahtar/değer çiftlerine dize olarak ekleyebilirsiniz. Elliden fazla özellik eklemek için bunları yukarıdaki Verileri kaydetme bölümünde açıklanan yöntemleri kullanarak programatik olarak eklemeniz gerekir. Proje ayarları sayfasından komut dosyası özelliklerini ayarladığınızda komut dosyası değişkenlerine referans veremezsiniz.
Komut dosyası özellikleri ekleyin
- Apps Komut Dosyası projenizi açın.
- Solda Proje Ayarları'nı tıklayın.
- İlk özelliği eklemek için Komut Dosyası Özellikleri altında Komut dosyası özelliği ekle'yi tıklayın.
- İkinci ve sonraki özellikleri eklemek için Komut Dosyası Özellikleri'nin altında Komut dosyası özelliklerini düzenle > Komut dosyası özelliği ekle'yi tıklayın.
- Mülk alanına 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üzenle
- Apps Komut Dosyası projenizi açın.
- Solda Proje Ayarları'nı tıklayın.
- Komut Dosyası Özellikleri'nin altında Komut dosyası özelliklerini düzenle'yi tıklayın.
- Değiştirmek istediğiniz her özellik 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 silin
- Apps Komut Dosyası projenizi açın.
- Solda Proje Ayarları'nı tıklayın.
- Komut Dosyası Özellikleri'nin altında 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.