Le service Propriétés vous permet de stocker Des données simples dans des paires clé-valeur limitées à un script, à un utilisateur d'un script Document dans lequel un module complémentaire est utilisé Il est généralement utilisé pour stocker la configuration du développeur ou les préférences utilisateur. Propriétés ne sont jamais partagés entre les scripts.
Pour afficher les quotas quotidiens et les limites de stockage du service Propriétés, consultez Quotas pour les services Google
Comparaison des magasins de propriétés
La
PropertiesService
global propose trois méthodes, chacune renvoyant un code
Properties
mais avec des droits d'accès différents, comme indiqué dans le tableau suivant:
Propriétés du script | Propriétés utilisateur | Propriétés du document | |
---|---|---|---|
Méthode d'accès | getScriptProperties() |
getUserProperties() |
getDocumentProperties() |
Données partagées entre | Tous les utilisateurs d'un script, d'un module complémentaire ou d'une application Web | L'utilisateur actuel d'un script, d'un module complémentaire ou d'une application Web | Tous les utilisateurs d'un module complémentaire dans le document ouvert |
Généralement utilisé pour | Les données de configuration de l'application, telles que le nom d'utilisateur et le mot de passe base de données externe du développeur | Paramètres spécifiques à l'utilisateur, comme les unités métriques ou impériales | Données spécifiques à un document, comme l'URL source d'un graphique intégré |
Format des données
Le service Propriétés stocke toutes les données sous forme de chaînes dans des paires clé/valeur. Types de données qui ne sont pas déjà des chaînes sont automatiquement converties en chaînes, y compris contenues dans les objets enregistrés.
Économie de données
Pour enregistrer une seule valeur, appelez la méthode Properties.setProperty(key,
value)
.
du magasin approprié, comme illustré dans l'exemple suivant:
Pour enregistrer des données de manière groupée, transmettez un mappage de paires clé-valeur
Properties.setProperties(properties)
Chaque paire clé-valeur de l'objet dans le paramètre est stockée sous la forme
:
Lire des données
Pour récupérer une valeur unique que vous avez enregistrée précédemment, appelez
Properties.getProperty(key)
:
Pour récupérer toutes les valeurs du magasin de propriétés actuel, appelez
Properties.getProperties()
:
Modifier les données
Les méthodes getProperty()
et getProperties()
renvoient une copie de la classe stockée
et non une vue en direct. Par conséquent, modifier l'objet renvoyé ne mettra pas à jour la valeur
dans le magasin de propriétés. Pour mettre à jour les données dans la boutique, enregistrez-les simplement à nouveau:
Supprimer des données
Pour supprimer une seule valeur, appelez
Properties.deleteProperty(key)
:
Pour supprimer toutes les propriétés du magasin actuel, appelez
Properties.deleteAllProperties()
:
Gérer manuellement les propriétés de script
Vous pouvez ajouter manuellement jusqu'à 50 propriétés personnalisées, sous forme de chaînes dans une clé-valeur. sur la page des paramètres du projet. Pour ajouter plus de 50 établissements, vous devez les ajouter par programmation à l'aide des méthodes décrites ci-dessus dans Enregistrement des données : Lorsque vous définissez des propriétés de script à partir de la page des paramètres du projet, vous ne pouvez pas les variables de script de référence.
Ajouter des propriétés de script
- Ouvrez votre projet Apps Script.
- Sur la gauche, cliquez sur Paramètres du projet .
- Pour ajouter la première propriété, sous Propriétés du script, cliquez sur Ajoutez une propriété de script.
- Pour ajouter une deuxième propriété et des propriétés suivantes, sous Propriétés du script, cliquez sur Modifier les propriétés de script > Ajouter une propriété de script.
- Dans le champ Propriété, saisissez le nom de la clé.
- Dans le champ Valeur, saisissez la valeur de la clé.
- (Facultatif) Pour ajouter d'autres propriétés, cliquez sur Ajouter une propriété de script.
- Cliquez sur Enregistrer les propriétés du script.
Modifier les propriétés de script
- Ouvrez votre projet Apps Script.
- Sur la gauche, cliquez sur Paramètres du projet .
- Sous Propriétés du script, cliquez sur Modifier les propriétés du script.
- Modifiez le nom et la valeur de la clé pour chaque propriété que vous souhaitez modifier.
- Cliquez sur Enregistrer les propriétés du script.
Supprimer les propriétés de script
- Ouvrez votre projet Apps Script.
- Sur la gauche, cliquez sur Paramètres du projet .
- Sous Propriétés du script, cliquez sur Modifier les propriétés du script.
- À côté de la propriété que vous souhaitez supprimer, cliquez sur Supprimer .
- Cliquez sur Enregistrer les propriétés du script.