Zaawansowana usługa Dysku

Zaawansowana usługa Dysk umożliwia korzystanie z Google Drive API w Apps Script. Podobne Wbudowany dysk Apps Script usługi, pozwala on skryptom tworzyć, znajdować oraz modyfikować pliki i foldery na Dysku Google. W większości przypadków wbudowany jest łatwiejsza w użyciu, ale ta zaawansowana usługa zapewnia funkcji, w tym dostępu do niestandardowych właściwości plików oraz wersji pliki i foldery.

Dokumentacja

Szczegółowe informacje o tej usłudze można znaleźć w odwołaniach dokumentacjiGoogle Drive API. Jak wszystkie i usługach zaawansowanych w Apps Script, Usługa Dysku używa tych samych obiektów, metod i parametrów co publicznego interfejsu API. Więcej informacji znajdziesz w artykule Na czym polegają podpisy metod określonych.

Aby zgłosić problemy i uzyskać pomoc, zapoznaj się z informacjami na stronie pomocy dotyczącej interfejsu Drive API .

Przykładowy kod

Przykładowe fragmenty kodu w tej sekcji używają wersji 3. i konkretnego interfejsu API.

Prześlij pliki

Poniższa próbka kodu pokazuje, jak zapisać plik w Dysk.

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

Wyświetlenie listy folderów

Poniższy przykładowy kod pokazuje, jak wyświetlić listę folderów najwyższego poziomu w folderze Dysk. Zwróć uwagę na użycie tokenów strony, aby uzyskać dostęp do pełnej listy wyników.

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

Wyświetlenie listy wersji

Poniższy przykładowy kod pokazuje, jak wyświetlić listę wersji danego pliku. Notatka że niektóre pliki mogą mieć kilka wersji. Tokenów stron należy używać przejdź do pełnej listy wyników.

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

Dodaj właściwości pliku

Następujący przykładowy kod korzysta z pola appProperties, aby dodać niestandardowy do pliku. Właściwość niestandardowa jest widoczna tylko dla skryptu. Aby dodać do pliku, który jest też widoczny dla innych aplikacji, użyj properties. Więcej informacji znajdziesz w sekcji Dodawanie pliku niestandardowego usługi.

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