Mit CacheService können Sie auf einen Cache für die kurzfristige Speicherung von Daten zugreifen.
Mit dieser Klasse können Sie eine bestimmte Cacheinstanz abrufen. Öffentliche Caches gelten für Dinge, die nicht davon abhängen, wer auf Ihr Skript zugreift. Private Caches sind nutzerspezifisch, z. B. für Einstellungen oder letzte Aktivitäten.
Die Daten, die Sie in den Cache schreiben, können nicht garantiert werden, bis sie ablaufen. Sie müssen null aus allen Lesevorgängen zurückgeben.
Methoden
| Methode | Rückgabetyp | Kurzbeschreibung |
|---|---|---|
getDocumentCache() | Cache | Ruft die Cache-Instanz ab, die auf das aktuelle Dokument und Skript ausgerichtet ist. |
getScriptCache() | Cache | Ruft die auf das Skript beschränkte Cacheinstanz ab. |
getUserCache() | Cache | Ruft die Cache-Instanz ab, die auf den aktuellen Nutzer und das Skript beschränkt ist. |
Detaillierte Dokumentation
getDocumentCache()
Ruft die Cache-Instanz ab, die auf das aktuelle Dokument und Skript ausgerichtet ist. Dokument-Caches sind spezifisch für das aktuelle Dokument, das das Skript enthält. Damit können Sie Skriptinformationen speichern, die für das aktuelle Dokument spezifisch sind. Wenn diese Methode außerhalb des Kontexts eines zugehörigen Dokuments aufgerufen wird, z. B. von einem eigenständigen Skript oder einer Webanwendung, gibt diese Methode null zurück.
// Gets a cache that is specific to the current document containing the script var cache = CacheService.getDocumentCache();
Zurücksenden
Cache: eine Cache-Instanz für das Dokument oder null, wenn kein Dokument vorhanden ist
getScriptCache()
Ruft die auf das Skript beschränkte Cacheinstanz ab. Skriptcaches sind für alle Nutzer des Skripts gleich. Damit können Sie Informationen speichern, die nicht für den aktuellen Nutzer spezifisch sind.
// Gets a cache that is common to all users of the script var cache = CacheService.getScriptCache();
Zurücksenden
Cache: eine Skript-Cache-Instanz
getUserCache()
Ruft die Cache-Instanz ab, die auf den aktuellen Nutzer und das Skript beschränkt ist. Nutzercaches sind spezifisch für den aktuellen Nutzer des Skripts. Damit können Sie Skriptinformationen speichern, die für den aktuellen Nutzer spezifisch sind.
// Gets a cache that is specific to the current user of the script var cache = CacheService.getUserCache();
Zurücksenden
Cache: eine Nutzer-Cache-Instanz