Pobieranie i eksportowanie plików

Interfejs Google Drive API obsługuje kilka typów działań związanych z pobieraniem i eksportowaniem. Ich listę znajdziesz w tej tabeli:

Pobieranie
Zawartość pliku blob metodą files.get z parametrem adresu URL alt=media.
Zawartość pliku Blob w starszej wersji przy użyciu metody revisions.get z parametrem adresu URL alt=media.
zawartość pliku bloba w przeglądarce przy użyciu pola webContentLink,
Eksporty
treści dokumentów w Google Workspace w formacie obsługiwanym przez Twoją aplikację przy użyciu files.export.
treści dokumentu Google Workspace w przeglądarce za pomocą pola exportLinks,
treści dokumentów Google Workspace w starszej wersji w przeglądarce za pomocą pola exportLinks,

W pozostałej części tego przewodnika znajdziesz szczegółowe instrukcje wykonywania tego typu działań dotyczących pobierania i eksportowania.

Pobierz zawartość pliku bloba

Aby pobrać plik blob zapisany na Dysku, użyj metody files.get z identyfikatorem pliku do pobrania i parametrem adresu URL alt=media. Parametr adresu URL alt=media informuje serwer, że w ramach alternatywnego formatu odpowiedzi zażądano pobrania treści.

Parametr adresu URL alt=media to parametr systemowy dostępny we wszystkich interfejsach API Google typu REST. Jeśli dla interfejsu Drive API używasz biblioteki klienta, nie musisz ustawiać tego parametru bezpośrednio.

Poniższy przykładowy kod pokazuje, jak za pomocą metody files.get pobrać plik z bibliotekami klienta interfejsu Drive API.

Java

drive/snippets/drive_v3/src/main/java/DownloadFile.java
import com.google.api.client.googleapis.json.GoogleJsonResponseException;
import com.google.api.client.http.HttpRequestInitializer;
import com.google.api.client.http.javanet.NetHttpTransport;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.drive.Drive;
import com.google.api.services.drive.DriveScopes;
import com.google.auth.http.HttpCredentialsAdapter;
import com.google.auth.oauth2.GoogleCredentials;
import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.io.OutputStream;
import java.util.Arrays;

/* Class to demonstrate use-case of drive's download file. */
public class DownloadFile {

  /**
   * Download a Document file in PDF format.
   *
   * @param realFileId file ID of any workspace document format file.
   * @return byte array stream if successful, {@code null} otherwise.
   * @throws IOException if service account credentials file not found.
   */
  public static ByteArrayOutputStream downloadFile(String realFileId) throws IOException {
        /* Load pre-authorized user credentials from the environment.
           TODO(developer) - See https://developers.google.com/identity for
          guides on implementing OAuth2 for your application.*/
    GoogleCredentials credentials = GoogleCredentials.getApplicationDefault()
        .createScoped(Arrays.asList(DriveScopes.DRIVE_FILE));
    HttpRequestInitializer requestInitializer = new HttpCredentialsAdapter(
        credentials);

    // Build a new authorized API client service.
    Drive service = new Drive.Builder(new NetHttpTransport(),
        GsonFactory.getDefaultInstance(),
        requestInitializer)
        .setApplicationName("Drive samples")
        .build();

    try {
      OutputStream outputStream = new ByteArrayOutputStream();

      service.files().get(realFileId)
          .executeMediaAndDownloadTo(outputStream);

      return (ByteArrayOutputStream) outputStream;
    } catch (GoogleJsonResponseException e) {
      // TODO(developer) - handle error appropriately
      System.err.println("Unable to move file: " + e.getDetails());
      throw e;
    }
  }
}

Python

drive/snippets/drive-v3/file_snippet/download_file.py
from __future__ import print_function

import io

import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError
from googleapiclient.http import MediaIoBaseDownload


def download_file(real_file_id):
    """Downloads a file
    Args:
        real_file_id: ID of the file to download
    Returns : IO object with location.

    Load pre-authorized user credentials from the environment.
    TODO(developer) - See https://developers.google.com/identity
    for guides on implementing OAuth2 for the application.
    """
    creds, _ = google.auth.default()

    try:
        # create drive api client
        service = build('drive', 'v3', credentials=creds)

        file_id = real_file_id

        # pylint: disable=maybe-no-member
        request = service.files().get_media(fileId=file_id)
        file = io.BytesIO()
        downloader = MediaIoBaseDownload(file, request)
        done = False
        while done is False:
            status, done = downloader.next_chunk()
            print(F'Download {int(status.progress() * 100)}.')

    except HttpError as error:
        print(F'An error occurred: {error}')
        file = None

    return file.getvalue()


if __name__ == '__main__':
    download_file(real_file_id='1KuPmvGq8yoYgbfW74OENMCB5H0n_2Jm9')

Node.js

drive/snippets/drive_v3/file_snippets/download_file.js
/**
 * Downloads a file
 * @param{string} realFileId file ID
 * @return{obj} file status
 * */
async function downloadFile(realFileId) {
  // Get credentials and build service
  // TODO (developer) - Use appropriate auth mechanism for your app

  const {GoogleAuth} = require('google-auth-library');
  const {google} = require('googleapis');

  const auth = new GoogleAuth({
    scopes: 'https://www.googleapis.com/auth/drive',
  });
  const service = google.drive({version: 'v3', auth});

  fileId = realFileId;
  try {
    const file = await service.files.get({
      fileId: fileId,
      alt: 'media',
    });
    console.log(file.status);
    return file.status;
  } catch (err) {
    // TODO(developer) - Handle error
    throw err;
  }
}

PHP

drive/snippets/drive_v3/src/DriveDownloadFile.php
use Google\Client;
use Google\Service\Drive;
function downloadFile()
 {
    try {

      $client = new Client();
      $client->useApplicationDefaultCredentials();
      $client->addScope(Drive::DRIVE);
      $driveService = new Drive($client);
      $realFileId = readline("Enter File Id: ");
      $fileId = '0BwwA4oUTeiV1UVNwOHItT0xfa2M';
      $fileId = $realFileId;
      $response = $driveService->files->get($fileId, array(
          'alt' => 'media'));
      $content = $response->getBody()->getContents();
      return $content;

    } catch(Exception $e) {
      echo "Error Message: ".$e;
    }

}

.NET

drive/snippets/drive_v3/DriveV3snippets/DownloadFile.cs
using Google.Apis.Auth.OAuth2;
using Google.Apis.Download;
using Google.Apis.Drive.v3;
using Google.Apis.Services;

namespace DriveV3Snippets
{
    // Class to demonstrate use-case of drive's download file.
    public class DownloadFile
    {
        /// <summary>
        /// Download a Document file in PDF format.
        /// </summary>
        /// <param name="fileId">file ID of any workspace document format file.</param>
        /// <returns>byte array stream if successful, null otherwise.</returns>
        public static MemoryStream DriveDownloadFile(string fileId)
        {
            try
            {
                /* Load pre-authorized user credentials from the environment.
                 TODO(developer) - See https://developers.google.com/identity for 
                 guides on implementing OAuth2 for your application. */
                GoogleCredential credential = GoogleCredential
                    .GetApplicationDefault()
                    .CreateScoped(DriveService.Scope.Drive);

                // Create Drive API service.
                var service = new DriveService(new BaseClientService.Initializer
                {
                    HttpClientInitializer = credential,
                    ApplicationName = "Drive API Snippets"
                });

                var request = service.Files.Get(fileId);
                var stream = new MemoryStream();

                // Add a handler which will be notified on progress changes.
                // It will notify on each chunk download and when the
                // download is completed or failed.
                request.MediaDownloader.ProgressChanged +=
                    progress =>
                    {
                        switch (progress.Status)
                        {
                            case DownloadStatus.Downloading:
                            {
                                Console.WriteLine(progress.BytesDownloaded);
                                break;
                            }
                            case DownloadStatus.Completed:
                            {
                                Console.WriteLine("Download complete.");
                                break;
                            }
                            case DownloadStatus.Failed:
                            {
                                Console.WriteLine("Download failed.");
                                break;
                            }
                        }
                    };
                request.Download(stream);

                return stream;
            }
            catch (Exception e)
            {
                // TODO(developer) - handle error appropriately
                if (e is AggregateException)
                {
                    Console.WriteLine("Credential Not found");
                }
                else
                {
                    throw;
                }
            }
            return null;
        }
    }
}

W tym przykładowym kodzie użyto metody biblioteki, która dodaje parametr adresu URL alt=media do bazowego żądania HTTP.

Pliki pobierane z Twojej aplikacji muszą być autoryzowane za pomocą zakresu umożliwiającego odczyt zawartości pliku. Na przykład aplikacja używająca zakresu drive.readonly.metadata nie jest autoryzowana do pobierania zawartości pliku. W tym przykładowym kodzie użyto ograniczonego zakresu plików „drive”, który umożliwia użytkownikom wyświetlanie wszystkich Twoich plików na Dysku i zarządzanie nimi. Więcej informacji o zakresach Dysku znajdziesz w artykule na temat autoryzacji i uwierzytelniania w przypadku interfejsów API.

Użytkownicy z uprawnieniami do edycji mogą ograniczać pobieranie przez użytkowników z dostępem tylko do odczytu, ustawiając w polu copyRequiresWriterPermission wartość false.

Pliki zidentyfikowane jako nieodpowiednie (np. szkodliwe oprogramowanie) mogą pobrać tylko ich właściciele. Dodatkowo trzeba uwzględnić parametr zapytania acknowledgeAbuse=true get, aby wskazać, że użytkownik zaakceptował ryzyko pobrania potencjalnie niechcianego oprogramowania lub innych plików naruszających nasze zasady. Przed użyciem tego parametru zapytania aplikacja powinna interaktywnie ostrzegać użytkownika.

Częściowo pobrane

Pobieranie częściowe polega na pobraniu tylko określonej części pliku. Aby określić część pliku, którą chcesz pobrać, możesz użyć zakresu bajtów z nagłówkiem Range. Na przykład:

Range: bytes=500-999

Pobierz zawartość pliku blob w starszej wersji

Aby pobrać zawartość plików blob w starszej wersji, użyj metody revisions.get z identyfikatorem pliku do pobrania, identyfikatorem wersji i parametrem adresu URL alt=media. Parametr adresu URL alt=media informuje serwer, że w ramach alternatywnego formatu odpowiedzi wysyłane jest żądanie pobrania treści. Podobnie jak files.get, metoda revisions.get akceptuje też opcjonalny parametr zapytania acknowledgeAbuse i nagłówek Range. Więcej informacji na temat pobierania wersji znajdziesz w artykule Pobieranie i publikowanie wersji plików.

Pobieranie zawartości pliku bloba w przeglądarce

Aby pobrać zawartość plików blob przechowywanych na Dysku w przeglądarce, zamiast przez interfejs API użyj pola webContentLink zasobu Files. Jeśli użytkownik ma dostęp do pobierania pliku, zwracany jest link umożliwiający jego pobranie wraz z zawartością. Możesz przekierować użytkownika na ten adres URL lub zaoferować go jako link, który można kliknąć.

Eksportowanie treści dokumentów z Google Workspace

Aby wyeksportować zawartość bajtową dokumentu z Google Workspace, użyj metody files.export z identyfikatorem wyeksportowanego pliku i prawidłowym typem MIME. Wyeksportowana treść może mieć maksymalnie 10 MB.

Poniższy przykładowy kod pokazuje, jak za pomocą metody files.export wyeksportować dokument Google Workspace w formacie PDF za pomocą bibliotek klienckich interfejsu Drive API:

Java

drive/snippets/drive_v3/src/main/java/ExportPdf.java
import com.google.api.client.googleapis.json.GoogleJsonResponseException;
import com.google.api.client.http.HttpRequestInitializer;
import com.google.api.client.http.javanet.NetHttpTransport;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.drive.Drive;
import com.google.api.services.drive.DriveScopes;
import com.google.auth.http.HttpCredentialsAdapter;
import com.google.auth.oauth2.GoogleCredentials;
import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.io.OutputStream;
import java.util.Arrays;

/* Class to demonstrate use-case of drive's export pdf. */
public class ExportPdf {

  /**
   * Download a Document file in PDF format.
   *
   * @param realFileId file ID of any workspace document format file.
   * @return byte array stream if successful, {@code null} otherwise.
   * @throws IOException if service account credentials file not found.
   */
  public static ByteArrayOutputStream exportPdf(String realFileId) throws IOException {
    // Load pre-authorized user credentials from the environment.
    // TODO(developer) - See https://developers.google.com/identity for
    // guides on implementing OAuth2 for your application.
    GoogleCredentials credentials = GoogleCredentials.getApplicationDefault()
        .createScoped(Arrays.asList(DriveScopes.DRIVE_FILE));
    HttpRequestInitializer requestInitializer = new HttpCredentialsAdapter(
        credentials);

    // Build a new authorized API client service.
    Drive service = new Drive.Builder(new NetHttpTransport(),
        GsonFactory.getDefaultInstance(),
        requestInitializer)
        .setApplicationName("Drive samples")
        .build();

    OutputStream outputStream = new ByteArrayOutputStream();
    try {
      service.files().export(realFileId, "application/pdf")
          .executeMediaAndDownloadTo(outputStream);

      return (ByteArrayOutputStream) outputStream;
    } catch (GoogleJsonResponseException e) {
      // TODO(developer) - handle error appropriately
      System.err.println("Unable to export file: " + e.getDetails());
      throw e;
    }
  }
}

Python

drive/snippets/drive-v3/file_snippet/export_pdf.py
from __future__ import print_function

import io

import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError
from googleapiclient.http import MediaIoBaseDownload


def export_pdf(real_file_id):
    """Download a Document file in PDF format.
    Args:
        real_file_id : file ID of any workspace document format file
    Returns : IO object with location

    Load pre-authorized user credentials from the environment.
    TODO(developer) - See https://developers.google.com/identity
    for guides on implementing OAuth2 for the application.
    """
    creds, _ = google.auth.default()

    try:
        # create drive api client
        service = build('drive', 'v3', credentials=creds)

        file_id = real_file_id

        # pylint: disable=maybe-no-member
        request = service.files().export_media(fileId=file_id,
                                               mimeType='application/pdf')
        file = io.BytesIO()
        downloader = MediaIoBaseDownload(file, request)
        done = False
        while done is False:
            status, done = downloader.next_chunk()
            print(F'Download {int(status.progress() * 100)}.')

    except HttpError as error:
        print(F'An error occurred: {error}')
        file = None

    return file.getvalue()


if __name__ == '__main__':
    export_pdf(real_file_id='1zbp8wAyuImX91Jt9mI-CAX_1TqkBLDEDcr2WeXBbKUY')

Node.js

drive/snippets/drive_v3/file_snippets/export_pdf.js
/**
 * Download a Document file in PDF format
 * @param{string} fileId file ID
 * @return{obj} file status
 * */
async function exportPdf(fileId) {
  const {GoogleAuth} = require('google-auth-library');
  const {google} = require('googleapis');

  // Get credentials and build service
  // TODO (developer) - Use appropriate auth mechanism for your app
  const auth = new GoogleAuth({
    scopes: 'https://www.googleapis.com/auth/drive',
  });
  const service = google.drive({version: 'v3', auth});

  try {
    const result = await service.files.export({
      fileId: fileId,
      mimeType: 'application/pdf',
    });
    console.log(result.status);
    return result;
  } catch (err) {
    // TODO(developer) - Handle error
    throw err;
  }
}

PHP

drive/snippets/drive_v3/src/DriveExportPdf.php
use Google\Client;
use Google\Service\Drive;
function exportPdf()
{
    try {
        $client = new Client();
        $client->useApplicationDefaultCredentials();
        $client->addScope(Drive::DRIVE);
        $driveService = new Drive($client);
        $realFileId = readline("Enter File Id: ");
        $fileId = '1ZdR3L3qP4Bkq8noWLJHSr_iBau0DNT4Kli4SxNc2YEo';
        $fileId = $realFileId;
        $response = $driveService->files->export($fileId, 'application/pdf', array(
            'alt' => 'media'));
        $content = $response->getBody()->getContents();
        return $content;

    }  catch(Exception $e) {
         echo "Error Message: ".$e;
    }

}

.NET

drive/snippets/drive_v3/DriveV3snippets/ExportPdf.cs
using Google.Apis.Auth.OAuth2;
using Google.Apis.Download;
using Google.Apis.Drive.v3;
using Google.Apis.Services;

namespace DriveV3Snippets
{
    // Class to demonstrate use of Drive export pdf
    public class ExportPdf
    {
        /// <summary>
        /// Download a Document file in PDF format.
        /// </summary>
        /// <param name="fileId">Id of the file.</param>
        /// <returns>Byte array stream if successful, null otherwise</returns>
        public static MemoryStream DriveExportPdf(string fileId)
        {
            try
            {
                /* Load pre-authorized user credentials from the environment.
                 TODO(developer) - See https://developers.google.com/identity for 
                 guides on implementing OAuth2 for your application. */
                GoogleCredential credential = GoogleCredential.GetApplicationDefault()
                    .CreateScoped(DriveService.Scope.Drive);

                // Create Drive API service.
                var service = new DriveService(new BaseClientService.Initializer
                {
                    HttpClientInitializer = credential,
                    ApplicationName = "Drive API Snippets"
                });

                var request = service.Files.Export(fileId, "application/pdf");
                var stream = new MemoryStream();
                // Add a handler which will be notified on progress changes.
                // It will notify on each chunk download and when the
                // download is completed or failed.
                request.MediaDownloader.ProgressChanged +=
                    progress =>
                    {
                        switch (progress.Status)
                        {
                            case DownloadStatus.Downloading:
                            {
                                Console.WriteLine(progress.BytesDownloaded);
                                break;
                            }
                            case DownloadStatus.Completed:
                            {
                                Console.WriteLine("Download complete.");
                                break;
                            }
                            case DownloadStatus.Failed:
                            {
                                Console.WriteLine("Download failed.");
                                break;
                            }
                        }
                    };
                request.Download(stream);
                return stream;
            }
            catch (Exception e)
            {
                // TODO(developer) - handle error appropriately
                if (e is AggregateException)
                {
                    Console.WriteLine("Credential Not found");
                }
                else
                {
                    throw;
                }
            }
            return null;
        }
    }
}

W tym przykładowym kodzie używany jest ograniczony zakres drive, który umożliwia użytkownikom wyświetlanie wszystkich Twoich plików na Dysku i zarządzanie nimi. Więcej informacji o zakresach Dysku znajdziesz w artykule Informacje o autoryzacji i uwierzytelnianiu w odniesieniu do interfejsów API.

W przykładowym kodzie deklaruje się również typ MIME eksportu jako application/pdf. Pełną listę wszystkich typów MIME eksportowanych plików obsługiwanych w przypadku poszczególnych dokumentów Google Workspace znajdziesz w artykule Eksportowanie typów MIME dokumentów Google Workspace.

Eksportowanie treści dokumentów z Google Workspace w przeglądarce

Aby wyeksportować zawartość dokumentów z Google Workspace w przeglądarce, użyj pola exportLinks zasobu Files. W zależności od typu dokumentu dla każdego dostępnego typu MIME zwracany jest link do pobrania pliku wraz z jego zawartością. Możesz przekierować użytkownika na adres URL lub oferować go jako link, który można kliknąć.

Eksportowanie w przeglądarce treści dokumentu z Google Workspace we wcześniejszej wersji

Aby wyeksportować w przeglądarce treść dokumentów z Google Workspace we wcześniejszej wersji, użyj metody revisions.get z identyfikatorem pliku do pobrania i identyfikatorem wersji. Jeśli użytkownik ma dostęp do pobierania pliku, zwracany jest link umożliwiający jego pobranie wraz z zawartością. Możesz przekierować użytkownika na ten adres URL lub zaoferować go jako link, który można kliknąć.