Erweiterter Drive-Dienst

Mit dem erweiterten Drive-Dienst können Sie die Google Drive API in Apps Script verwenden. Ähnlich wie Das integrierte Drive von Apps Script verwenden, können Skripts und ändern Sie Dateien und Ordner in Google Drive. In den meisten Fällen werden die ist einfacher zu nutzen. Dieser erweiterte Dienst bietet jedoch ein paar zusätzliche einschließlich des Zugriffs auf benutzerdefinierte Dateieigenschaften sowie Überarbeitungen von Dateien und Ordner.

Referenz

Detaillierte Informationen zu diesem Dienst finden Sie in der Referenz Dokumentation für die Google Drive API. Wie alle erweiterte Dienste in Apps Script, die erweiterte Der Drive-Dienst verwendet dieselben Objekte, Methoden und Parameter wie der öffentlichen API. Weitere Informationen finden Sie unter Methodensignaturen bestimmt.

Informationen zum Melden von Problemen und zum Erhalt anderer Supportoptionen finden Sie im Drive API-Supportleitfaden.

Beispielcode

Die Codebeispiele in diesem Abschnitt basieren auf Version 3. der API.

Dateien hochladen

Das folgende Codebeispiel zeigt, wie Sie eine Datei Drive

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

Das folgende Codebeispiel zeigt, wie die Ordner der obersten Ebene im Ordner Drive Beachten Sie, dass Seitentokens verwendet werden, um auf die vollständige Liste der Ergebnisse.

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 für eine bestimmte Datei aufgelistet werden. Hinweis dass manche Dateien mehrere Versionen haben können und Sie Seitentokens verwenden sollten, um auf die vollständige Ergebnisliste 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 Property hinzuzufügen. Die benutzerdefinierte Eigenschaft ist nur für das Skript sichtbar. So fügen Sie ein benutzerdefinierte Eigenschaft für die Datei an, die auch für andere Apps sichtbar ist, verwenden Sie die Methode properties. Weitere Informationen finden Sie unter Benutzerdefinierte Datei hinzufügen Eigenschaften.

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