Diese Seite wurde von der Cloud Translation API übersetzt.

Class DriveApp

Mit dieser Einstellung können Skripts Dateien und Ordner in Google Drive erstellen, suchen und ändern. Um auf Dateien zuzugreifen oder Ordner in geteilten Ablagen nutzen Sie den erweiterten Google Drive-Dienst.

// Logs the name of every file in the user's Drive.
var files = DriveApp.getFiles();
while (files.hasNext()) {
  var file = files.next();
  console.log(file.getName());
}

Attribute

Attribut	Typ	Beschreibung
`Access`	`Access`	Ein Enum-Wert, der Klassen von Nutzern darstellt, die auf eine Datei oder einen Ordner zugreifen können, neben einzelnen Nutzern, denen explizit Zugriff gewährt wurde.
`Permission`	`Permission`	Ein Enum-Wert, der die Berechtigungen darstellt, die Nutzern gewährt wurden, die auf eine Datei oder einen Ordner zugreifen können, neben Alle einzelnen Nutzer, denen explizit Zugriff gewährt wurde.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`continueFileIterator(continuationToken)`	`FileIterator`	Setzt eine Dateiiteration mit einem Fortsetzungstoken aus einem vorherigen Iterator fort.
`continueFolderIterator(continuationToken)`	`FolderIterator`	Setzt eine Ordneriteration mit einem Fortsetzungstoken aus einem vorherigen Iterator fort.
`createFile(blob)`	`File`	Erstellt im Stammverzeichnis des Drive-Kontos des Nutzers eine Datei aus einer bestimmten `Blob` mit beliebigen Daten.
`createFile(name, content)`	`File`	Erstellt im Stammverzeichnis des Nutzers in Google Drive eine Textdatei mit dem angegebenen Namen und Inhalt.
`createFile(name, content, mimeType)`	`File`	Erstellt im Stammverzeichnis des Nutzers in Google Drive eine Datei mit dem angegebenen Namen, Inhalt und MIME-Typ.
`createFolder(name)`	`Folder`	Es wird ein Ordner mit dem angegebenen Namen im Stammverzeichnis des Drive-Kontos des Nutzers erstellt.
`createShortcut(targetId)`	`File`	Erstellt eine Verknüpfung zur angegebenen Drive-Element-ID und gibt sie zurück.
`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`	`File`	Eine Verknüpfung zur angegebenen Drive-Element-ID und dem Ressourcenschlüssel wird erstellt und zurückgegeben.
`enforceSingleParent(value)`	`void`	Aktiviert oder deaktiviert dasforceSingleParent-Verhalten für alle Aufrufe, die sich auf übergeordnete Elemente auswirken.
`getFileById(id)`	`File`	Ruft die Datei mit der angegebenen ID ab.
`getFileByIdAndResourceKey(id, resourceKey)`	`File`	Ruft die Datei mit der angegebenen ID und dem Ressourcenschlüssel ab.
`getFiles()`	`FileIterator`	Ruft eine Sammlung aller Dateien im Google Drive des Nutzers ab.
`getFilesByName(name)`	`FileIterator`	Ruft eine Sammlung aller Dateien im Drive des Nutzers ab, die den angegebenen Namen haben.
`getFilesByType(mimeType)`	`FileIterator`	Ruft eine Sammlung aller Dateien im Drive des Nutzers ab, die den angegebenen MIME-Typ haben.
`getFolderById(id)`	`Folder`	Ruft den Ordner mit der angegebenen ID ab.
`getFolderByIdAndResourceKey(id, resourceKey)`	`Folder`	Ruft den Ordner mit der angegebenen ID und dem angegebenen Ressourcenschlüssel ab.
`getFolders()`	`FolderIterator`	Ruft eine Sammlung aller Ordner im Google Drive des Nutzers ab.
`getFoldersByName(name)`	`FolderIterator`	Ruft eine Sammlung aller Ordner in der Ablage des Nutzers ab, die den angegebenen Namen haben.
`getRootFolder()`	`Folder`	Es wird der Ordner im Stammverzeichnis des Drive-Kontos des Nutzers abgerufen.
`getStorageLimit()`	`Integer`	Ruft die Anzahl der Bytes ab, die der Nutzer in Drive speichern darf.
`getStorageUsed()`	`Integer`	Ruft die Anzahl der Bytes ab, die der Nutzer derzeit in Drive speichert.
`getTrashedFiles()`	`FileIterator`	Ruft eine Sammlung aller Dateien im Papierkorb des Google Drive des Nutzers ab.
`getTrashedFolders()`	`FolderIterator`	Ruft eine Sammlung aller Ordner im Papierkorb des Google Drive des Nutzers ab.
`searchFiles(params)`	`FileIterator`	Ruft eine Sammlung aller Dateien im Drive des Nutzers ab, die der angegebenen Suche entsprechen Kriterien.
`searchFolders(params)`	`FolderIterator`	Ruft eine Sammlung aller Ordner im Google Drive des Nutzers ab, die der angegebenen Suche entsprechen Kriterien.

Verworfene Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`addFile(child)`	`Folder`	Fügt die angegebene Datei zum Stammverzeichnis des Drive-Kontos des Nutzers hinzu.
`addFolder(child)`	`Folder`	Fügt den angegebenen Ordner zum Stammverzeichnis des Drive-Kontos des Nutzers hinzu.
`removeFile(child)`	`Folder`	Die angegebene Datei wird aus dem Stammverzeichnis des Google Drive-Kontos des Nutzers entfernt.
`removeFolder(child)`	`Folder`	Der angegebene Ordner wird aus dem Stammverzeichnis des Drive-Kontos des Nutzers entfernt.

Detaillierte Dokumentation

`continueFileIterator(continuationToken)`

Setzt eine Dateiiteration mit einem Fortsetzungstoken aus einem vorherigen Iterator fort. Diese Methode ist ist nützlich, wenn die Verarbeitung eines Iterators in einer Ausführung die maximale Ausführungszeit überschreitet. Fortsetzungs-Tokens sind in der Regel eine Woche lang gültig.

// Continues getting a list of all 'Untitled document' files in the user's Drive.
// Creates a file iterator named 'previousIterator'.
const previousIterator = DriveApp.getFilesByName('Untitled document');

// Gets continuation token from the previous file iterator.
const continuationToken = previousIterator.getContinuationToken();

// Creates a new iterator using the continuation token from the previous file iterator.
const newIterator = DriveApp.continueFileIterator(continuationToken);

// Resumes the file iteration using a continuation token from 'firstIterator' and
// logs the file name.
if (newIterator.hasNext()) {
  const file = newIterator.next();
  console.log(file.getName());
}

Parameter

Name	Typ	Beschreibung
`continuationToken`	`String`	Fortsetzungs-Token eines früheren Datei-Iterators.

Rückflug

FileIterator: Eine Sammlung von Dateien, die beim Fortsetzungstoken in einem früheren Iterator verblieben sind. generiert wurde.

`continueFolderIterator(continuationToken)`

Setzt eine Ordneriteration mit einem Fortsetzungstoken aus einem vorherigen Iterator fort. Diese Methode ist ist nützlich, wenn die Verarbeitung eines Iterators in einer Ausführung die maximale Ausführungszeit überschreitet. Fortsetzungs-Tokens sind in der Regel eine Woche lang gültig.

// Continues getting a list of all folders in user's Drive.
// Creates a folder iterator named 'previousIterator'.
const previousIterator = DriveApp.getFolders();

// Gets continuation token from the previous folder iterator.
const continuationToken = previousIterator.getContinuationToken();

// Creates a new iterator using the continuation token from the previous folder iterator.
const newIterator = DriveApp.continueFolderIterator(continuationToken);

// Resumes the folder iteration using a continuation token from the previous iterator and logs
// the folder name.
if (newIterator.hasNext()) {
  const folder = newIterator.next();
  console.log(folder.getName());
}

Parameter

Name	Typ	Beschreibung
`continuationToken`	`String`	Fortsetzungstoken eines vorherigen Ordner-Iterators.

Rückflug

FolderIterator: Eine Sammlung von Ordnern, die bei der Fortsetzung in einem vorherigen Iterator verblieben sind. Token wurde generiert.

`createFile(blob)`

Erstellt im Stammverzeichnis des Drive-Kontos des Nutzers eine Datei aus einer bestimmten Blob mit beliebigen Daten.

// Create an image file in Google Drive using the Maps service.
var blob = Maps.newStaticMap().setCenter('76 9th Avenue, New York NY').getBlob();
DriveApp.createFile(blob);

Parameter

Name	Typ	Beschreibung
`blob`	`BlobSource`	Die Daten für die neue Datei.

Rückflug

File: Die neue Datei.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/drive

`createFile(name, content)`

Erstellt im Stammverzeichnis des Nutzers in Google Drive eine Textdatei mit dem angegebenen Namen und Inhalt. Wirf einen Ausnahme, wenn content größer als 50 MB ist.

// Create a text file with the content "Hello, world!"
DriveApp.createFile('New Text File', 'Hello, world!');

Parameter

Name	Typ	Beschreibung
`name`	`String`	Der Name der neuen Datei.
`content`	`String`	Der Inhalt der neuen Datei.

Rückflug

File: Die neue Datei.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/drive

`createFile(name, content, mimeType)`

Erstellt im Stammverzeichnis des Nutzers in Google Drive eine Datei mit dem angegebenen Namen, Inhalt und MIME-Typ. Wurfspiele Ausnahme, wenn content größer als 10 MB ist.

// Create an HTML file with the content "Hello, world!"
DriveApp.createFile('New HTML File', '<b>Hello, world!</b>', MimeType.HTML);

Parameter

Name	Typ	Beschreibung
`name`	`String`	Der Name der neuen Datei.
`content`	`String`	Der Inhalt der neuen Datei.
`mimeType`	`String`	Der MIME-Typ der neuen Datei.

Rückflug

File: Die neue Datei.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/drive

`createFolder(name)`

Es wird ein Ordner mit dem angegebenen Namen im Stammverzeichnis des Drive-Kontos des Nutzers erstellt.

Parameter

Name	Typ	Beschreibung
`name`	`String`	Der Name des neuen Ordners.

Rückflug

Folder: Der neue Ordner.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/drive

`createShortcut(targetId)`

Erstellt eine Verknüpfung zur angegebenen Drive-Element-ID und gibt sie zurück.

Parameter

Name	Typ	Beschreibung
`targetId`	`String`	Die Datei-ID der Zieldatei oder des Zielordners.

Rückflug

File: Die neue Tastenkombination.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/drive

`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`

Eine Verknüpfung zur angegebenen Drive-Element-ID und dem Ressourcenschlüssel wird erstellt und zurückgegeben. Eine Ressource Schlüssel ist ein zusätzlicher Parameter, der übergeben werden muss, um auf die Zieldatei oder den Zielordner zuzugreifen, die bzw. den wurde per Link freigegeben.

// Creates shortcuts for all folders in the user's drive that have a specific name.
// TODO(developer): Replace 'Test-Folder' with a valid folder name in your drive.
const folders = DriveApp.getFoldersByName('Test-Folder');

// Iterates through all folders named 'Test-Folder'.
while (folders.hasNext()) {
  const folder = folders.next();

  // Creates a shortcut to the provided Drive item ID and resource key, and returns it.
  DriveApp.createShortcutForTargetIdAndResourceKey(folder.getId(), folder.getResourceKey());
}

Parameter

Name	Typ	Beschreibung
`targetId`	`String`	Die ID der Zieldatei oder des Zielordners.
`targetResourceKey`	`String`	Der Ressourcenschlüssel der Zieldatei oder des Zielordners.

Rückflug

File: Die neue Tastenkombination.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/drive

`enforceSingleParent(value)`

Aktiviert oder deaktiviert dasforceSingleParent-Verhalten für alle Aufrufe, die sich auf übergeordnete Elemente auswirken.

Im Blog Einfachere Ordnerstruktur und Freigabemodelle in Google Drive finden Sie weitere Informationen. erhalten Sie weitere Informationen.

// Enables enforceSingleParent behavior for all calls affecting item parents.
DriveApp.enforceSingleParent(true);

Parameter

Name	Typ	Beschreibung
`value`	`Boolean`	Der neue Status des FlagsforceSingleParent.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/drive

`getFileById(id)`

Ruft die Datei mit der angegebenen ID ab. Löst eine Skriptausnahme aus, wenn die Datei nicht vorhanden ist oder der Nutzer hat keine Zugriffsberechtigung.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace 'Test' with your file name.
const files = DriveApp.getFilesByName('Test');

if (files.hasNext()) {
  // Gets the ID of each file in the list.
  const fileId = files.next().getId();

  // Gets the file name using its ID and logs it to the console.
  console.log(DriveApp.getFileById(fileId).getName());
}

Parameter

Name	Typ	Beschreibung
`id`	`String`	Die ID der Datei.

Rückflug

File: Die Datei mit der angegebenen ID.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getFileByIdAndResourceKey(id, resourceKey)`

Ruft die Datei mit der angegebenen ID und dem Ressourcenschlüssel ab. Ressourcenschlüssel sind ein zusätzlicher Parameter, die übergeben werden müssen, um auf Dateien zuzugreifen, die über einen Link freigegeben wurden.

Löst eine Skriptausnahme aus, wenn die Datei nicht vorhanden ist oder der Nutzer keine Berechtigung hat um darauf zuzugreifen.

// Gets a list of all files in Drive with the given name.
// TODO(developer): Replace 'Test' with your file name.
const files = DriveApp.getFilesByName('Test');
if (files.hasNext()) {

  // Gets the first file in the list.
  const file = files.next();

  // Gets the ID and resource key.
  const key = file.getResourceKey();
  const id = file.getId();

  // Logs the file name to the console using its ID and resource key.
  console.log(DriveApp.getFileByIdAndResourceKey(id, key).getName());
}

Parameter

Name	Typ	Beschreibung
`id`	`String`	Die ID der Datei.
`resourceKey`	`String`	Der Ressourcenschlüssel des Ordners.

Rückflug

File: Die Datei mit der angegebenen ID.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getFiles()`

Ruft eine Sammlung aller Dateien im Google Drive des Nutzers ab.

Rückflug

FileIterator: Eine Sammlung aller Dateien im Google Drive des Nutzers.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getFilesByName(name)`

Ruft eine Sammlung aller Dateien im Drive des Nutzers ab, die den angegebenen Namen haben.

Parameter

Name	Typ	Beschreibung
`name`	`String`	Der Name der zu suchenden Dateien.

Rückflug

FileIterator: Eine Sammlung aller Dateien im Drive des Nutzers, die den angegebenen Namen haben.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getFilesByType(mimeType)`

Ruft eine Sammlung aller Dateien im Drive des Nutzers ab, die den angegebenen MIME-Typ haben.

Parameter

Name	Typ	Beschreibung
`mimeType`	`String`	Der MIME-Typ der zu suchenden Dateien.

Rückflug

FileIterator: Eine Sammlung aller Dateien im Drive-Konto des Nutzers, die das angegebene MIME haben Typ.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getFolderById(id)`

Ruft den Ordner mit der angegebenen ID ab. Löst eine Skriptausnahme aus, wenn der Ordner nicht vorhanden ist oder Der Nutzer hat keine Zugriffsberechtigung.

Parameter

Name	Typ	Beschreibung
`id`	`String`	Die ID des Ordners.

Rückflug

Folder: Der Ordner mit der angegebenen ID.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getFolderByIdAndResourceKey(id, resourceKey)`

Ruft den Ordner mit der angegebenen ID und dem angegebenen Ressourcenschlüssel ab. Ressourcenschlüssel sind ein zusätzlicher Parameter, die an den Zugriff auf Ordner weitergegeben werden müssen, die über einen Link freigegeben wurden.

Löst eine Skriptausnahme aus, wenn der Ordner nicht vorhanden ist oder der Nutzer keine Berechtigung hat um darauf zuzugreifen.

Parameter

Name	Typ	Beschreibung
`id`	`String`	Die ID des Ordners.
`resourceKey`	`String`	Der Ressourcenschlüssel des Ordners.

Rückflug

Folder: Der Ordner mit der angegebenen ID.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getFolders()`

Ruft eine Sammlung aller Ordner im Google Drive des Nutzers ab.

Rückflug

FolderIterator: Eine Sammlung aller Ordner in der Ablage des Nutzers.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getFoldersByName(name)`

Ruft eine Sammlung aller Ordner in der Ablage des Nutzers ab, die den angegebenen Namen haben.

Parameter

Name	Typ	Beschreibung
`name`	`String`	Der Name des zu suchenden Ordners.

Rückflug

FolderIterator: Eine Sammlung aller Ordner in der Ablage des Nutzers, die den angegebenen Namen haben.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getRootFolder()`

Es wird der Ordner im Stammverzeichnis des Drive-Kontos des Nutzers abgerufen.

// Gets the user's My Drive folder and logs its name to the console.
console.log(DriveApp.getRootFolder().getName());

// Logs the Drive owner's name to the console.
console.log(DriveApp.getRootFolder().getOwner().getName());

Rückflug

Folder: Der Stammordner des Google Drive-Kontos des Nutzers.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getStorageLimit()`

Ruft die Anzahl der Bytes ab, die der Nutzer in Drive speichern darf.

// Gets the number of bytes the user can store in Drive and logs it to the console.
console.log(DriveApp.getStorageLimit());

Rückflug

Integer: Die Anzahl der Byte, die der Nutzer in Drive speichern darf.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getStorageUsed()`

Ruft die Anzahl der Bytes ab, die der Nutzer derzeit in Drive speichert.

// Gets the number of bytes the user is currently storing in Drive and logs it to the console.
console.log(DriveApp.getStorageUsed());

Rückflug

Integer: Die Anzahl der Byte, die der Nutzer derzeit in Drive speichert.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getTrashedFiles()`

Ruft eine Sammlung aller Dateien im Papierkorb des Google Drive des Nutzers ab.

// Gets a list of all the files in the trash of the user's Drive.
const trashFiles = DriveApp.getTrashedFiles();

// Logs the trash file names to the console.
while (trashFiles.hasNext()) {
  const file = trashFiles.next();
  console.log(file.getName());
}

Rückflug

FileIterator: Eine Sammlung der Dateien im Papierkorb.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getTrashedFolders()`

Ruft eine Sammlung aller Ordner im Papierkorb des Google Drive des Nutzers ab.

// Gets a collection of all the folders in the trash of the user's Drive.
const trashFolders = DriveApp.getTrashedFolders();

// Logs the trash folder names to the console.
while (trashFolders.hasNext()) {
  const folder = trashFolders.next();
  console.log(folder.getName());
}

Rückflug

FolderIterator: Eine Sammlung von Ordnern im Papierkorb.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`searchFiles(params)`

Ruft eine Sammlung aller Dateien im Drive des Nutzers ab, die der angegebenen Suche entsprechen Kriterien. Die Suchkriterien sind in der Google Drive SDK-Dokumentation ausführlich beschrieben. Beachten Sie, dass die Drive-Datei Der Dienst verwendet Version 2 der Drive API. Einige Abfragefelder unterscheiden sich von Version 3. Überprüfen Sie das Feld Unterschiede zwischen v2 und v3.

Das Argument params ist ein Abfragestring, der Stringwerte enthalten kann. um Anführungszeichen korrekt mit Escapezeichen zu versehen (z. B. "title contains 'Gulliver\\'s Travels'" oder 'title contains "Gulliver\'s Travels"').

// Logs the name of every file in the user's Drive that modified after February 28,
// 2022 whose name contains "untitled.""
var files = DriveApp.searchFiles(
    'modifiedDate > "2022-02-28" and title contains "untitled"');
while (files.hasNext()) {
  var file = files.next();
  console.log(file.getName());
}

Parameter

Name	Typ	Beschreibung
`params`	`String`	Die Suchkriterien, wie in der Google Drive SDK-Dokumentation beschrieben.

Rückflug

FileIterator: Eine Sammlung aller Dateien im Drive des Nutzers, die mit der Suche übereinstimmen Kriterien.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`searchFolders(params)`

Ruft eine Sammlung aller Ordner im Google Drive des Nutzers ab, die der angegebenen Suche entsprechen Kriterien. Die Suchkriterien sind in der Google Drive SDK-Dokumentation ausführlich beschrieben. Beachten Sie, dass die Drive-Datei Der Dienst verwendet Version 2 der Drive API. Einige Abfragefelder unterscheiden sich von Version 3. Überprüfen Sie das Feld Unterschiede zwischen v2 und v3.

// Logs the name of every folder in the user's Drive that you own and is starred.
var folders = DriveApp.searchFolders('starred = true and "me" in owners');
while (folders.hasNext()) {
  var folder = folders.next();
  console.log(folder.getName());
}

Parameter

Name	Typ	Beschreibung
`params`	`String`	Die Suchkriterien, wie in der Google Drive SDK-Dokumentation beschrieben.

Rückflug

FolderIterator: Eine Sammlung aller Ordner im Google Drive des Nutzers, die mit der Suche übereinstimmen Kriterien.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

Verworfene Methoden

`addFile(child)`

Veraltet. Verwende stattdessen File.moveTo(destination) oder Folder.createShortcut(targetId).

Fügt die angegebene Datei zum Stammverzeichnis des Drive-Kontos des Nutzers hinzu. Diese Methode verschiebt die Datei nicht aus ihrer vorhandener übergeordneter Ordner; eine Datei kann mehrere übergeordnete Elemente haben.

Parameter

Name	Typ	Beschreibung
`child`	`File`	Die untergeordnete Datei, die hinzugefügt werden soll.

Rückflug

Folder: Das neue übergeordnete Element der Datei, das als untergeordnetes Element hinzugefügt wurde.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/drive

`addFolder(child)`

Veraltet. Verwende stattdessen Folder.moveTo(destination) oder Folder.createShortcut(targetId).

Fügt den angegebenen Ordner zum Stammverzeichnis des Drive-Kontos des Nutzers hinzu. Mit dieser Methode wird der Ordner nicht aus seinem vorhandenen übergeordneten Ordner. Ein Ordner kann mehrere übergeordnete Elemente haben.

Parameter

Name	Typ	Beschreibung
`child`	`Folder`	Der untergeordnete Ordner, der hinzugefügt werden soll.

Rückflug

Folder: Das neue übergeordnete Element, das dem Ordner als untergeordnetes Element hinzugefügt wurde.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/drive

`removeFile(child)`

Veraltet. Verwende stattdessen File.moveTo(destination).

Die angegebene Datei wird aus dem Stammverzeichnis des Google Drive-Kontos des Nutzers entfernt. Mit dieser Methode wird die Datei zwar nicht gelöscht, Wenn eine Datei aus allen übergeordneten Elementen entfernt wird, kann sie in Google Drive nur über eine Suche angezeigt werden. oder mithilfe der Option "Alle Artikel" Ansicht.

Parameter

Name	Typ	Beschreibung
`child`	`File`	Die untergeordnete Datei, die entfernt werden soll.

Rückflug

Folder: vorheriges übergeordnetes Element des untergeordneten Elements.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/drive

`removeFolder(child)`

Veraltet. Verwende stattdessen Folder.moveTo(destination).

Der angegebene Ordner wird aus dem Stammverzeichnis des Drive-Kontos des Nutzers entfernt. Mit dieser Methode wird der Ordner nicht gelöscht. oder seines Inhalts. Wenn ein Ordner jedoch aus allen übergeordneten Elementen entfernt wird, ist er in Google Drive nicht sichtbar. es sei denn, Sie suchen danach oder die Option "Alle Artikel" Ansicht.

Parameter

Name	Typ	Beschreibung
`child`	`Folder`	Der untergeordnete Ordner, der entfernt werden soll.

Rückflug

Folder: vorheriges übergeordnetes Element des untergeordneten Elements.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/drive