Class FolderIterator
FolderIterator
Obiekt, który umożliwia skryptom przeszukiwanie potencjalnie dużej kolekcji folderów. Do folderów iteracji można uzyskać dostęp z poziomu DriveApp
, File
lub Folder
.
// Log the name of every folder in the user's Drive.
const folders = DriveApp.getFolders();
while (folders.hasNext()) {
const folder = folders.next();
Logger.log(folder.getName());
}
Metody
Metoda | Zwracany typ | Krótki opis |
getContinuationToken() | String | Pobiera token, który można wykorzystać do wznowienia tej iteracji w późniejszym czasie. |
hasNext() | Boolean | Określa, czy wywołanie next() spowoduje zwrot produktu. |
next() | Folder | Pobiera następny element z kolekcji plików lub folderów. |
Szczegółowa dokumentacja
getContinuationToken()
Pobiera token, który można wykorzystać do wznowienia tej iteracji w późniejszym czasie. Ta metoda jest przydatna, jeśli przetworzenie iteratora w jednym wykonaniu przekroczy maksymalny czas wykonania.
Tokeny kontynuacji są zwykle ważne przez tydzień.
Powrót
String
– token kontynuacji, który można wykorzystać do wznowienia iteracji z elementami, które pozostały w iteratorze w momencie wygenerowania tokena.
hasNext()
Określa, czy wywołanie next()
spowoduje zwrot produktu.
Powrót
Boolean
– true
, jeśli next()
zwróci element; false
, jeśli nie.
next()
Pobiera następny element z kolekcji plików lub folderów. Wyjątek jest zgłaszany, jeśli nie ma żadnych elementów.
Powrót
Folder
– następny element w kolekcji.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2024-12-22 UTC.
[null,null,["Ostatnia aktualizacja: 2024-12-22 UTC."],[[["`FolderIterator` enables scripts to iterate through a large collection of folders within Google Drive."],["It provides methods like `hasNext()` to check for more folders, `next()` to retrieve the next folder, and `getContinuationToken()` for handling lengthy iterations."],["Developers can utilize `FolderIterator` with `DriveApp`, `File`, or `Folder` objects to access and process folders programmatically."]]],["FolderIterator allows iterating over a large collection of folders. Key actions include using `hasNext()` to check for the next item and `next()` to retrieve it. `getContinuationToken()` provides a token to resume iteration later, helpful for large collections. The example shows how to log every folder's name in a user's Drive, demonstrating iteration through the folder collection. The iterator returns folder objects and can throw an exception if no items remain.\n"]]