Mülkler Hizmeti

Tesisler hizmeti, kapsamı tek bir komut dosyası, bir komut dosyası kullanıcısı veya eklentinin kullanıldığı bir doküman. Evet genellikle geliştirici yapılandırmasını veya kullanıcı tercihlerini depolamak için kullanılır. Tesisler 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 Hizmetleri için Kotalar.

Emlak mağazalarının karşılaştırması

İlgili içeriği oluşturmak için kullanılan PropertiesService global nesne üç yöntem sunar. Bu yöntemlerin her biri, benzer bir Properties nesnesini tanımlar ancak aşağıdaki tabloda gösterildiği gibi farklı erişim haklarına sahiptir:

	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ı	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. Veri türleri önceden dize olmayanlar otomatik olarak dizelere dönüştürülür. yöntemleri içerir.

Veri tasarrufu

Tek bir değeri kaydetmek için Properties.setProperty(key, value) yöntemini çağırın aşağıdaki örnekte gösterildiği gibi, uygun mağazanın adını değiştirin:

service/propertyService.gs

GitHub'da göster

try {
  // Set a property in each of the three property stores.
  const scriptProperties = PropertiesService.getScriptProperties();
  const userProperties = PropertiesService.getUserProperties();
  const documentProperties = PropertiesService.getDocumentProperties();

  scriptProperties.setProperty('SERVER_URL', 'http://www.example.com/');
  userProperties.setProperty('DISPLAY_UNITS', 'metric');
  documentProperties.setProperty('SOURCE_DATA_ID',
      '1j3GgabZvXUF177W0Zs_2v--H6SPCQb4pmZ6HsTZYT5k');
} catch (err) {
  // TODO (developer) - Handle exception
  console.log('Failed with error %s', err.message);
}

Verileri toplu olarak kaydetmek için anahtar/değer çiftlerinin bir eşlemesini Properties.setProperties(properties). Parametredeki nesnenin her anahtar/değer çifti, ayrı bir mülk:

service/propertyService.gs

GitHub'da göster

try {
  // Set multiple script properties in one call.
  const scriptProperties = PropertiesService.getScriptProperties();
  scriptProperties.setProperties({
    'cow': 'moo',
    'sheep': 'baa',
    'chicken': 'cluck'
  });
} catch (err) {
  // TODO (developer) - Handle exception
  console.log('Failed with error %s', err.message);
}

Verileri okuma

Daha önce kaydettiğiniz tek bir değeri almak için şunu arayın: Properties.getProperty(key):

service/propertyService.gs

GitHub'da göster

try {
  // Get the value for the user property 'DISPLAY_UNITS'.
  const userProperties = PropertiesService.getUserProperties();
  const units = userProperties.getProperty('DISPLAY_UNITS');
  console.log('values of units %s', units);
} catch (err) {
  // TODO (developer) - Handle exception
  console.log('Failed with error %s', err.message);
}

Geçerli mülk mağazasındaki tüm değerleri almak için şunu çağırın: Properties.getProperties():

service/propertyService.gs

GitHub'da göster

try {
  // Get multiple script properties in one call, then log them all.
  const scriptProperties = PropertiesService.getScriptProperties();
  const data = scriptProperties.getProperties();
  for (const key in data) {
    console.log('Key: %s, Value: %s', key, data[key]);
  }
} catch (err) {
  // TODO (developer) - Handle exception
  console.log('Failed with error %s', err.message);
}

Verileri değiştirme

getProperty() ve getProperties() yöntemleri, depolanan verileri değil, canlı görünüm değildir; böylece döndürülen nesnenin değiştirilmesi, değeri güncellemez inceleyebilirsiniz. Mağazadaki verileri güncellemek için verileri tekrar kaydetmeniz yeterlidir:

service/propertyService.gs

GitHub'da göster

try {
  // Change the unit type in the user property 'DISPLAY_UNITS'.
  const userProperties = PropertiesService.getUserProperties();
  let units = userProperties.getProperty('DISPLAY_UNITS');
  units = 'imperial'; // Only changes local value, not stored value.
  userProperties.setProperty('DISPLAY_UNITS', units); // Updates stored value.
} catch (err) {
  // TODO (developer) - Handle exception
  console.log('Failed with error %s', err.message);
}

Veri silme

Tek bir değeri silmek için şunu arayın: Properties.deleteProperty(key):

service/propertyService.gs

GitHub'da göster

try {
  // Delete the user property 'DISPLAY_UNITS'.
  const userProperties = PropertiesService.getUserProperties();
  userProperties.deleteProperty('DISPLAY_UNITS');
} catch (err) {
  // TODO (developer) - Handle exception
  console.log('Failed with error %s', err.message);
}

Geçerli mağazadaki tüm mülkleri silmek için şunu arayın: Properties.deleteAllProperties():

service/propertyService.gs

GitHub'da göster

try {
  // Get user properties in the current script.
  const userProperties = PropertiesService.getUserProperties();
  // Delete all user properties in the current script.
  userProperties.deleteAllProperties();
} catch (err) {
  // TODO (developer) - Handle exception
  console.log('Failed with error %s', err.message);
}

Komut dosyası özelliklerini manuel olarak yönetme

Anahtar/değer çiftlerine dize olarak, manuel olarak en fazla elli özel özelliği ekleyebilirsiniz. çiftler, proje ayarları sayfasından. Elliden fazla mülk eklemek için bunları yukarıdaki Veri tasarrufu. Proje ayarları sayfasından komut dosyası özelliklerini belirlediğinizde referans komut dosyası değişkenlerine başvurur.

Komut dosyası özellikleri ekleyin

1. Apps Komut Dosyası projenizi açın.
2. Solda Proje Ayarları'nı tıklayın.
3. İlk özelliği eklemek için Komut Dosyası Özellikleri'nin altında Komut dosyası özelliği ekle.
4. İ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.
5. Mülk alanına anahtar adını girin.
6. Değer alanına anahtarın değerini girin.
7. (İsteğe bağlı) Daha fazla özellik eklemek için Komut dosyası özelliği ekle'yi tıklayın.
8. Komut dosyası özelliklerini kaydet'i tıklayın.

Komut dosyası özelliklerini düzenle

1. Apps Komut Dosyası projenizi açın.
2. Solda Proje Ayarları'nı tıklayın.
3. Komut Dosyası Özellikleri'nin altında Komut dosyası özelliklerini düzenle'yi tıklayın.
4. Değiştirmek istediğiniz her özellik için anahtar adında ve anahtar değerinde değişiklik yapın.
5. Komut dosyası özelliklerini kaydet'i tıklayın.

Komut dosyası özelliklerini silin

1. Apps Komut Dosyası projenizi açın.
2. Solda Proje Ayarları'nı tıklayın.
3. Komut Dosyası Özellikleri'nin altında Komut dosyası özelliklerini düzenle'yi tıklayın.
4. Silmek istediğiniz mülkün yanındaki Kaldır'ı tıklayın.
5. Komut dosyası özelliklerini kaydet'i tıklayın.