Erweiterter Drive-Dienst

zum Verwalten von Dateien und Ordnern, einschließlich benutzerdefinierter Attribute und Versionen.

Mit dem erweiterten Drive-Dienst können Sie die Google Drive API in Google Apps Script verwenden. Ähnlich wie beim integrierten Drive Dienst von Apps Script können Skripts mit dieser API Dateien und Ordner in Google Drive erstellen, suchen und ändern. In den meisten Fällen ist der integrierte Dienst einfacher zu verwenden, aber dieser erweiterte Dienst bietet einige zusätzliche Funktionen, darunter den Zugriff auf benutzerdefinierte Dateieigenschaften sowie auf Versionen für Dateien und Ordner.

Dies ist ein erweiterter Dienst, der vor der Verwendung aktiviert werden muss use.

Referenz

Ausführliche Informationen zu diesem Dienst finden Sie in der Referenz dokumentation zur Drive API. Wie alle erweiterten Dienste in Apps Script verwendet auch der erweiterte Drive-Dienst dieselben Objekte, Methoden und Parameter wie die öffentliche API. Weitere Informationen finden Sie unter Methoden-Signaturen ermitteln. Außerdem werden Methoden mit dem Namen delete in der Drive API im erweiterten Dienst remove genannt (z. B. Drive.Permissions.remove()), da delete ein reserviertes Wort in JavaScript ist.

Informationen zum Melden von Problemen und zu anderen Supportoptionen finden Sie im Supportleitfaden für die Drive API.

Beispielcode

In den Codebeispielen in diesem Abschnitt wird Version 3 der API verwendet.

Dateien hochladen

Im folgenden Codebeispiel wird gezeigt, wie Sie eine Datei im Drive eines Nutzers speichern.

advanced/drive.gs
/**
 * Uploads a new file to the user's Drive.
 */
function uploadFile() {
  try {
    // Makes a request to fetch a URL.
    const image = UrlFetchApp.fetch("http://goo.gl/nd7zjB").getBlob();
    let file = {
      name: "google_logo.png",
      mimeType: "image/png",
    };
    // Create a file in the user's Drive.
    file = Drive.Files.create(file, image, { fields: "id,size" });
    console.log("ID: %s, File size (bytes): %s", file.id, file.size);
  } catch (err) {
    // TODO (developer) - Handle exception
    console.log("Failed to upload file with error %s", err.message);
  }
}

Ordner erstellen

Im folgenden Codebeispiel wird gezeigt, wie Sie einen Ordner in Drive erstellen.

/**
 * Creates a new folder.
 */
function createFolder() {
  var folderMetadata = {
    'name': 'New Folder',
    'mimeType': 'application/vnd.google-apps.folder'
  };
  var folder = Drive.Files.create(folderMetadata);
  Logger.log('Folder ID: ' + folder.id);
}

Nach Dateien suchen

Im folgenden Codebeispiel wird gezeigt, wie Sie mit einer Suchanfrage nach Dateien suchen.

/**
 * Searches for files with a specific name.
 */
function searchFiles() {
  var query = 'name contains "Project Plan" and trashed = false';
  var files = Drive.Files.list({
    'q': query,
    'fields': 'files(id, name, mimeType)'
  });
  if (files.files && files.files.length > 0) {
    for (var i = 0; i < files.files.length; i++) {
      var file = files.files[i];
      Logger.log('%s (ID: %s)', file.name, file.id);
    }
  } else {
    Logger.log('No files found.');
  }
}

Ordner auflisten

Im folgenden Codebeispiel wird gezeigt, wie Sie die Ordner der obersten Ebene im Drive des Nutzers auflisten. Beachten Sie die Verwendung von Seitentokens, um auf die vollständige Liste der Ergebnisse zuzugreifen.

advanced/drive.gs
/**
 * Lists the top-level folders in the user's Drive.
 */
function listRootFolders() {
  const query =
    '"root" in parents and trashed = false and ' +
    'mimeType = "application/vnd.google-apps.folder"';
  let folders;
  let pageToken = null;
  do {
    try {
      folders = Drive.Files.list({
        q: query,
        pageSize: 100,
        pageToken: pageToken,
      });
      if (!folders.files || folders.files.length === 0) {
        console.log("All folders found.");
        return;
      }
      for (let i = 0; i < folders.files.length; i++) {
        const folder = folders.files[i];
        console.log("%s (ID: %s)", folder.name, folder.id);
      }
      pageToken = folders.nextPageToken;
    } catch (err) {
      // TODO (developer) - Handle exception
      console.log("Failed with error %s", err.message);
    }
  } while (pageToken);
}

Versionen auflisten

Im folgenden Codebeispiel wird gezeigt, wie Sie die Versionen einer bestimmten Datei auflisten. Einige Dateien können mehrere Versionen haben. Verwenden Sie Seitentokens, um auf die vollständige Liste der Ergebnisse zuzugreifen.

advanced/drive.gs
/**
 * Lists the revisions of a given file.
 * @param {string} fileId The ID of the file to list revisions for.
 */
function listRevisions(fileId) {
  let revisions;
  let pageToken = null;
  do {
    try {
      revisions = Drive.Revisions.list(fileId, {
        fields: "revisions(modifiedTime,size),nextPageToken",
      });
      if (!revisions.revisions || revisions.revisions.length === 0) {
        console.log("All revisions found.");
        return;
      }
      for (let i = 0; i < revisions.revisions.length; i++) {
        const revision = revisions.revisions[i];
        const date = new Date(revision.modifiedTime);
        console.log(
          "Date: %s, File size (bytes): %s",
          date.toLocaleString(),
          revision.size,
        );
      }
      pageToken = revisions.nextPageToken;
    } catch (err) {
      // TODO (developer) - Handle exception
      console.log("Failed with error %s", err.message);
    }
  } while (pageToken);
}

Dateiattribute hinzufügen

Im folgenden Codebeispiel wird das Feld appProperties verwendet, um einer Datei ein benutzerdefiniertes Attribut hinzuzufügen. Das benutzerdefinierte Attribut ist nur für das Skript sichtbar. Wenn Sie der Datei ein benutzerdefiniertes Attribut hinzufügen möchten, das auch für andere Apps sichtbar ist, verwenden Sie stattdessen das Feld properties. Weitere Informationen finden Sie unter Benutzerdefinierte Datei attribute.

advanced/drive.gs
/**
 * Adds a custom app property to a file. Unlike Apps Script's DocumentProperties,
 * Drive's custom file properties can be accessed outside of Apps Script and
 * by other applications; however, appProperties are only visible to the script.
 * @param {string} fileId The ID of the file to add the app property to.
 */
function addAppProperty(fileId) {
  try {
    let file = {
      appProperties: {
        department: "Sales",
      },
    };
    // Updates a file to add an app property.
    file = Drive.Files.update(file, fileId, null, {
      fields: "id,appProperties",
    });
    console.log(
      "ID: %s, appProperties: %s",
      file.id,
      JSON.stringify(file.appProperties, null, 2),
    );
  } catch (err) {
    // TODO (developer) - Handle exception
    console.log("Failed with error %s", err.message);
  }
}

Nutzer zu einer Datei hinzufügen

Im folgenden Codebeispiel wird gezeigt, wie Sie einen Nutzer als Bearbeiter zu einer Datei hinzufügen und die E-Mail-Benachrichtigung unterdrücken.

/**
 * Adds a user to a file as an editor without sending an email notification.
 */
function addEditor() {
  var fileId = '1234567890abcdefghijklmnopqrstuvwxyz';
  var userEmail = 'bob@example.com';
  var request = {
    'role': 'writer',
    'type': 'user',
    'emailAddress': userEmail
  };
  Drive.Permissions.create(request, fileId, {
    'sendNotificationEmail': false
  });
}