Class CacheService

CacheService

Mit dem 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 sind für Dinge gedacht, die nicht davon abhängen, welcher Nutzer auf Ihr Skript zugreift. Private Caches sind für nutzerspezifische Elemente wie Einstellungen oder letzte Aktivitäten vorgesehen.

Es gibt keine Garantie dafür, dass die Daten, die Sie in den Cache schreiben, bis zum Ablaufdatum erhalten bleiben. Sie müssen bereit sein, null für alle Aufrufe zurückzuerhalten.

Methoden

MethodeRückgabetypKurzbeschreibung
getDocumentCache()Cache|nullRuft die Cache-Instanz ab, die auf das aktuelle Dokument und Skript beschränkt ist.
getScriptCache()CacheRuft die Cache-Instanz ab, die auf das Skript beschränkt ist.
getUserCache()CacheRuft die Cache-Instanz ab, die auf den aktuellen Nutzer und das aktuelle Skript beschränkt ist.

Detaillierte Dokumentation

getDocumentCache()

Ruft die Cache-Instanz ab, die auf das aktuelle Dokument und Skript beschränkt ist. Dokumentcaches 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 enthaltenden Dokuments aufgerufen wird (z. B. über ein eigenständiges Skript oder eine Webanwendung), gibt sie null zurück. 

// Gets a cache that is specific to the current document containing the script
const cache = CacheService.getDocumentCache();

Rückflug

Cache|null – eine Dokumentcache-Instanz oder null, wenn kein enthaltendes Dokument vorhanden ist

getScriptCache()

Ruft die Cache-Instanz ab, die auf das Skript beschränkt ist. Script-Caches sind für alle Nutzer des Skripts gleich. Verwenden Sie diese, um Informationen zu speichern, die nicht spezifisch für den aktuellen Nutzer sind. 

// Gets a cache that is common to all users of the script
const cache = CacheService.getScriptCache();

Rückflug

Cache – eine Script-Cache-Instanz

getUserCache()

Ruft die Cache-Instanz ab, die auf den aktuellen Nutzer und das aktuelle Skript beschränkt ist. Nutzer-Caches 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
const cache = CacheService.getUserCache();

Rückflug

Cache – eine Nutzercache-Instanz