Erweiterter Drive-Dienst

Mit dem erweiterten Drive-Dienst können Sie die Google Drive API in Apps Script verwenden. Ähnlich wie der integrierte Drive-Dienst von Apps Script ermöglicht diese API Skripts das Erstellen, Suchen und Ändern von Dateien und Ordnern in Google Drive. In den meisten Fällen ist der integrierte Dienst einfacher zu verwenden. Dieser erweiterte Dienst bietet jedoch einige zusätzliche Funktionen, einschließlich Zugriff auf benutzerdefinierte Dateieigenschaften sowie Überarbeitungen von Dateien und Ordnern.

Referenz

Ausführliche Informationen zu diesem Dienst finden Sie in der Referenzdokumentation für die Google Drive API. Wie alle erweiterten Dienste in Apps Script verwendet der erweiterte Drive-Dienst dieselben Objekte, Methoden und Parameter wie die öffentliche API. Weitere Informationen finden Sie unter Wie Methodensignaturen ermittelt werden.

Im Supportleitfaden für die Drive API erfahren Sie, wie Sie Probleme melden und weiteren Support erhalten.

Beispielcode

Die Codebeispiele in diesem Abschnitt beziehen sich auf Version 3 der API.

Dateien hochladen

Im folgenden Codebeispiel wird gezeigt, wie eine Datei im Google Drive eines Nutzers gespeichert wird.

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 auflisten

Im folgenden Codebeispiel wird gezeigt, wie Sie die Ordner der obersten Ebene im Drive-Konto 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);
}

Überarbeitungen auflisten

Das folgende Codebeispiel zeigt, wie die Überarbeitungen einer bestimmten Datei aufgelistet werden. Beachten Sie, dass einige Dateien mehrere Überarbeitungen haben können und Sie Seitentokens verwenden sollten, 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;
  const 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);
}

Dateieigenschaften hinzufügen

Im folgenden Codebeispiel wird das Feld appProperties verwendet, um einer Datei eine benutzerdefinierte Eigenschaft hinzuzufügen. Die benutzerdefinierte Eigenschaft 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 Dateiattribute hinzufügen.

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);
  }
}