Class DriveApp

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

Rückflug

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

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

Rückflug

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

Erstellt eine Datei im Stammverzeichnis des Drive-Kontos des Nutzers 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

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

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

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

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

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

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

Parameter

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

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

Parameter

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

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

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

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

Autorisierung

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

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

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

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

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

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

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

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

Parameter

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

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

Parameter

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

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

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

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

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

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

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

Parameter

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

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

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

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

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

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

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

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

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.

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 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

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