Service Drive avancé

Le service Drive avancé vous permet d'utiliser API Google Drive dans Apps Script. Semblable à Drive intégré à Apps Script service, cette API permet aux scripts de créer, de rechercher et modifier des fichiers et des dossiers dans Google Drive. Dans la plupart des cas, l'API intégrée est plus facile à utiliser, mais ce service avancé offre quelques fonctionnalités supplémentaires y compris l'accès aux propriétés de fichier personnalisées ainsi que les révisions des des fichiers et des dossiers.

Référence

Pour en savoir plus sur ce service, consultez la documentation de référence documentation de l'API Google Drive. Comme tous services avancés d'Apps Script, la plate-forme Le service Drive utilise les mêmes objets, méthodes et paramètres que l'API publique. Pour en savoir plus, consultez la section Fonctionnement des signatures de méthode déterminé.

Pour signaler des problèmes et obtenir d'autres informations d'assistance, consultez le guide d'assistance de l'API Drive.

Exemple de code

Les exemples de code présentés dans cette section utilisent la version 3. de l'API.

Importer des fichiers

L'exemple de code suivant montre comment enregistrer un fichier 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);
  }
}

Répertorier les dossiers

L'exemple de code suivant montre comment répertorier les dossiers de premier niveau dans le dossier Drive. Notez l'utilisation de jetons de page pour accéder à la liste complète résultats.

avancé/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);
}

Lister les révisions

L'exemple de code suivant montre comment répertorier les révisions d'un fichier donné. Notez que certains fichiers peuvent avoir plusieurs révisions et que vous devez utiliser des jetons de page pour accéder à la liste complète des résultats.

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

Ajouter des propriétés de fichier

L'exemple de code suivant utilise le champ appProperties pour ajouter un à un fichier. La propriété personnalisée n'est visible que par le script. Pour ajouter un personnalisée au fichier, qui est également visible par d'autres applications, utilisez la propriété properties. Pour en savoir plus, consultez la section Ajouter un fichier personnalisé propriétés.

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