CacheService ermöglicht Ihnen den Zugriff auf einen Cache zur kurzfristigen Speicherung von Daten.
Mit dieser Klasse können Sie eine bestimmte Cache-Instanz abrufen. Öffentliche Caches sind für Dinge gedacht, die nicht davon abhängen, welcher Nutzer auf Ihr Skript zugreift. Private Caches sind für nutzerspezifische Dinge wie Einstellungen oder letzte Aktivitäten gedacht.
Es ist nicht garantiert, dass die Daten, die Sie in den Cache schreiben, bis zu ihrer Ablaufzeit erhalten bleiben. Sie müssen in der Lage sein, null
von allen Lesevorgängen zurückzugeben.
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
getDocumentCache() | Cache | Ruft die Cache-Instanz für das aktuelle Dokument und Skript ab. |
getScriptCache() | Cache | Ruft die Cache-Instanz auf, die dem Skript zugewiesen ist. |
getUserCache() | Cache | Ruft die Cache-Instanz für den aktuellen Nutzer und das aktuelle Skript ab. |
Detaillierte Dokumentation
getDocumentCache()
Ruft die Cache-Instanz für das aktuelle Dokument und Skript ab. Dokument-Caches sind spezifisch für das aktuelle Dokument, das das Skript enthält. Verwenden Sie diese, um Skriptinformationen zu speichern, die für das aktuelle Dokument spezifisch sind. Wenn diese Methode außerhalb des Kontexts eines 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();
Return
Cache
: Eine Dokument-Cache-Instanz oder null
, wenn kein Dokument enthalten ist
getScriptCache()
Ruft die Cache-Instanz auf, die dem Skript zugewiesen ist. Skript-Caches sind für alle Nutzer des Skripts gleich. Speichern Sie damit Informationen, die nicht spezifisch für den aktuellen Nutzer sind.
// Gets a cache that is common to all users of the script var cache = CacheService.getScriptCache();
Return
Cache
: eine Skript-Cache-Instanz
getUserCache()
Ruft die Cache-Instanz für den aktuellen Nutzer und das aktuelle Skript ab. Nutzer-Caches sind spezifisch für den aktuellen Nutzer des Skripts. Verwenden Sie diese zum Speichern von Skriptinformationen, 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();
Return
Cache
: Eine Nutzer-Cache-Instanz