Class ScriptProperties

ScriptProperties

Obsolète. Cette classe est obsolète et ne doit pas être utilisée dans de nouveaux scripts.

Les propriétés de script sont des paires clé/valeur stockées par un script dans un stockage persistant. Les propriétés de script s'appliquent à chaque script, quel que soit l'utilisateur qui l'exécute.

Méthodes obsolètes

Méthode	Type renvoyé	Brève description
deleteAllProperties()	ScriptProperties	Supprime toutes les propriétés.
deleteProperty(key)	ScriptProperties	Supprime la propriété associée à la clé donnée.
getKeys()	String[]	Récupérez toutes les clés disponibles.
getProperties()	Object	Obtenez toutes les propriétés disponibles en même temps.
getProperty(key)	String	Renvoie la valeur associée à la clé fournie, ou la valeur "null" si aucune valeur n'existe.
setProperties(properties)	ScriptProperties	Définit de façon groupée toutes les propriétés extraites de l'objet donné.
setProperties(properties, deleteAllOthers)	ScriptProperties	Définit de façon groupée toutes les propriétés extraites de l'objet donné.
setProperty(key, value)	ScriptProperties	Conservera la valeur spécifiée avec la clé fournie.

Méthodes obsolètes

deleteAllProperties()

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans de nouveaux scripts.

Supprime toutes les propriétés.

ScriptProperties.deleteAllProperties();

Renvois

ScriptProperties : cet objet, pour le chaînage

Voir aussi

• deleteProperty(key)

---

deleteProperty(key)

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans de nouveaux scripts.

Supprime la propriété associée à la clé donnée.

ScriptProperties.deleteProperty('special');

Paramètres

Nom	Type	Description
key	String	clé de la propriété à supprimer

Renvois

ScriptProperties : cet objet, pour le chaînage

Voir aussi

• deleteAllProperties()

---

getKeys()

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans de nouveaux scripts.

Récupérez toutes les clés disponibles.

Renvois

String[]

---

getProperties()

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans de nouveaux scripts.

Obtenez toutes les propriétés disponibles en même temps.

Cela donne une copie, et non une vue en direct. Par conséquent, la modification des propriétés de l'objet renvoyé ne les met pas à jour dans le stockage, et inversement.

ScriptProperties.setProperties({
  "cow"     : "moo",
  "sheep"   : "baa",
  "chicken" : "cluck"
});

// Logs "A cow goes: moo"
Logger.log("A cow goes: %s", ScriptProperties.getProperty("cow"));

// This makes a copy. Any changes that happen here will not
// be written back to properties.
var animalSounds = ScriptProperties.getProperties();

// Logs:
// A chicken goes cluck!
// A cow goes moo!
// A sheep goes baa!
for(var kind in animalSounds) {
  Logger.log("A %s goes %s!", kind, animalSounds[kind]);
}

Renvois

Object : copie des propriétés contenant des paires clé/valeur

---

getProperty(key)

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans de nouveaux scripts.

Renvoie la valeur associée à la clé fournie, ou la valeur "null" si aucune valeur n'existe.

var specialValue = ScriptProperties.getProperty('special');

Paramètres

Nom	Type	Description
key	String	pour la valeur à récupérer.

Renvois

String : valeur associée à la clé

Voir aussi

• setProperty(key, value)

---

setProperties(properties)

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans de nouveaux scripts.

Définit de façon groupée toutes les propriétés extraites de l'objet donné.

ScriptProperties.setProperties({special: 'sauce', 'meaning': 42});

Paramètres

Nom	Type	Description
properties	Object	un objet contenant les propriétés à définir.

Renvois

ScriptProperties : cet objet, pour le chaînage

Voir aussi

• setProperty(key, value)

---

setProperties(properties, deleteAllOthers)

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans de nouveaux scripts.

Définit de façon groupée toutes les propriétés extraites de l'objet donné.

// This deletes all other properties
ScriptProperties.setProperties({special: 'sauce', 'meaning': 42}, true);

Paramètres

Nom	Type	Description
properties	Object	un objet contenant les propriétés à définir.
deleteAllOthers	Boolean	ou non toutes les propriétés existantes.

Renvois

ScriptProperties : cet objet, pour le chaînage

Voir aussi

• setProperty(key, value)

---

setProperty(key, value)

Obsolète. Cette fonction est obsolète et ne doit pas être utilisée dans de nouveaux scripts.

Conservera la valeur spécifiée avec la clé fournie. Toute valeur existante associée à cette clé sera écrasée.

ScriptProperties.setProperty('special', 'sauce');

Paramètres

Nom	Type	Description
key	String	pour la propriété
value	String	à associer à la clé

Renvois

ScriptProperties : cet objet, pour le chaînage

Voir aussi

• getProperty(key)