Zaawansowana usługa Dysku

Zaawansowana usługa Dysk umożliwia korzystanie z interfejsu Google Drive API w Apps Script. Ten interfejs API, podobnie jak wbudowana usługa Dysk w Apps Script, umożliwia skryptom tworzenie, znajdowanie oraz modyfikowanie plików i folderów na Dysku Google. W większości przypadków usługa wbudowana jest łatwiejsza w użyciu, ale ta zaawansowana usługa udostępnia kilka dodatkowych funkcji, w tym dostęp do niestandardowych właściwości plików oraz wersji plików i folderów.

Dokumentacja

Szczegółowe informacje o tej usłudze znajdziesz w dokumentacji interfejsu Google Drive API. Podobnie jak wszystkie usługi zaawansowane w Apps Script, zaawansowana usługa Dysk korzysta z tych samych obiektów, metod i parametrów co publiczny interfejs API. Więcej informacji znajdziesz w artykule Jak określane są podpisy metod.

Aby zgłosić problemy i znaleźć inną pomoc, zapoznaj się z przewodnikiem po interfejsie Drive API.

Przykładowy kod

Przykładowe fragmenty kodu w tej sekcji korzystają z wersji 3 interfejsu API.

Prześlij pliki

Poniższy przykładowy kod pokazuje, jak zapisać plik na Dysku użytkownika.

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świetlanie listy folderów

Poniższy przykładowy kod pokazuje, jak wyświetlić listę folderów najwyższego poziomu na Dysku użytkownika. Zwróć uwagę na użycie tokenów stron, aby mieć 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. Niektóre pliki mogą mieć kilka wersji. Aby uzyskać dostęp do pełnej listy wyników, użyj tokenów stron.

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

Poniższy przykładowy kod zawiera pole appProperties, aby dodać do pliku właściwość niestandardową. Właściwość niestandardowa jest widoczna tylko dla skryptu. Aby dodać do pliku właściwość niestandardową, która jest też widoczna dla innych aplikacji, użyj zamiast tego pola properties. Więcej informacji znajdziesz w artykule Dodawanie niestandardowych właściwości pliku.

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