Le service Properties vous permet de stocker des données simples sous forme de paires clé/valeur limitées à un script, à l'utilisateur d'un script ou à un document dans lequel un module complémentaire est utilisé. Il est généralement utilisé pour stocker la configuration des développeurs ou les préférences utilisateur. Les propriétés ne sont jamais partagées entre les scripts.
Pour connaître les quotas quotidiens et les limites de stockage du service Propriétés, consultez la page Quotas pour les services Google.
Comparaison des magasins de propriétés
L'objet global PropertiesService
propose trois méthodes, chacune renvoyant un objet Properties
similaire, 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 | 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 |
Utilisation la plus courante | Données de configuration à l'échelle de l'application, telles que le nom d'utilisateur et le mot de passe de la base de données externe du développeur | Les paramètres propres à l'utilisateur, comme les unités métriques ou impériales | Données spécifiques à un document, telles que 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. Les types de données qui ne sont pas déjà des chaînes sont automatiquement convertis en chaînes, y compris les méthodes contenues dans des objets enregistrés.
Enregistrement des données...
Pour enregistrer une seule valeur, appelez la méthode Properties.setProperty(key,
value)
du magasin approprié, comme indiqué 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 en tant que propriété distincte:
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 des données stockées, et non une vue en direct. Par conséquent, la modification de l'objet renvoyé ne met pas à jour la valeur dans le magasin de propriétés. Pour mettre à jour les données du magasin, il vous suffit de les enregistrer à 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 des paires clé/valeur, à partir de la page des paramètres du projet. Pour ajouter plus de 50 propriétés, vous devez les ajouter de manière programmatique à l'aide des méthodes décrites ci-dessus dans la section Enregistrer des données. Lorsque vous définissez les propriétés de script à partir de la page des paramètres du projet, vous ne pouvez pas référencer de variables de script.
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 de script, cliquez sur Ajouter une propriété de script.
- Pour ajouter des propriétés secondaires et les suivantes, sous Propriétés de 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 du 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é de chaque propriété que vous souhaitez modifier.
- Cliquez sur Enregistrer les propriétés du script.
Supprimer les propriétés du 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.