Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Pobieranie i eksportowanie plików

Google Drive API obsługuje kilka typów działań związanych z pobieraniem i eksportowaniem, które są wymienione w tabeli poniżej:

Działania związane z pobieraniem

Zawartość pliku blob za pomocą metody files.get z parametrem alt=media.

Zawartość pliku blob w starszej wersji za pomocą metody revisions.get z parametrem alt=media.

Zawartość pliku blob w przeglądarce za pomocą pola webContentLink.

Zawartość pliku blob za pomocą metody files.download z użyciem operacji długotrwałych. Jest to jedyny sposób na pobranie plików Google Vids.

Działania związane z eksportowaniem

Zawartość dokumentu Google Workspace w formacie obsługiwanym przez aplikację za pomocą metody files.export.

Zawartość dokumentu Google Workspace w przeglądarce za pomocą pola exportLinks.

Zawartość dokumentu Google Workspace w starszej wersji w przeglądarce za pomocą pola exportLinks.

Zawartość dokumentu Google Workspace za pomocą metody files.download z użyciem operacji długotrwałych.

W Drive API plik blob to dowolny surowy plik binarny przechowywany na Dysku Google (np. obrazy, filmy i pliki PDF) w przeciwieństwie do dokumentu Google Workspace. Nie odnosi się do obiektu Blob w JavaScript. Szczegółowe opisy wymienionych tutaj typów plików, w tym plików blob i Google Workspace, znajdziesz w artykule Typy plików.

Zanim pobierzesz lub wyeksportujesz zawartość pliku, sprawdź, czy użytkownicy mogą pobrać plik za pomocą pola capabilities.canDownload w zasobie files.

W pozostałej części tego dokumentu znajdziesz szczegółowe instrukcje wykonywania tych typów działań związanych z pobieraniem i eksportowaniem.

Pobieranie zawartości pliku blob

Aby pobrać plik blob przechowywany na Dysku, użyj metody files.get z identyfikatorem pliku do pobrania i parametrem alt systemowym. Parametr alt=media informuje serwer, że żądanie pobrania treści jest alternatywnym formatem odpowiedzi.

Parametr systemowy alt jest dostępny we wszystkich interfejsach Google REST API. Jeśli używasz biblioteki klienta Drive API, nie musisz jawnie ustawiać tego parametru, ponieważ metoda biblioteki klienta dodaje parametr alt=media do podstawowego żądania HTTP.

Poniższe przykłady kodu pokazują, jak używać metody files.get do pobierania pliku:

Apps Script

/**
 * Downloads a file from Drive.
 * @param {string} fileId The ID of the file to download.
 * @return {Blob} The file content as a Blob.
 */
function downloadFile(fileId) {
  var url = 'https://www.googleapis.com/drive/v3/files/' + fileId + '?alt=media';
  var response = UrlFetchApp.fetch(url, {
    headers: {
      'Authorization': 'Bearer ' + ScriptApp.getOAuthToken()
    }
  });
  return response.getBlob();
}

Java

drive/snippets/drive_v3/src/main/java/DownloadFile.java

Wyświetl w GitHubie

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

Wyświetl w GitHubie

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

Wyświetl w GitHubie

import {GoogleAuth} from 'google-auth-library';
import {google} from 'googleapis';

/**
 * Downloads a file from Google Drive.
 * @param {string} fileId The ID of the file to download.
 * @return {Promise<number>} The status of the download.
 */
async function downloadFile(fileId) {
  // Authenticate with Google and get an authorized client.
  // TODO (developer): Use an appropriate auth mechanism for your app.
  const auth = new GoogleAuth({
    scopes: 'https://www.googleapis.com/auth/drive',
  });

  // Create a new Drive API client (v3).
  const service = google.drive({version: 'v3', auth});

  // Download the file.
  const file = await service.files.get({
    fileId,
    alt: 'media',
  });

  // Print the status of the download.
  console.log(file.status);
  return file.status;
}

PHP

drive/snippets/drive_v3/src/DriveDownloadFile.php

Wyświetl w GitHubie

<?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

Wyświetl w GitHubie

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

curl

curl -L "https://www.googleapis.com/drive/v3/files/FILE_ID?alt=media" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --output "FILE_NAME"

Zastąp te elementy:

FILE_ID: identyfikator pliku do pobrania.
ACCESS_TOKEN: token dostępu, który przyznaje dostęp do interfejsu API.
FILE_NAME: nazwa pliku wyjściowego.

Pobieranie plików rozpoczęte w aplikacji musi być autoryzowane za pomocą zakresu, który umożliwia odczyt zawartości pliku. Na przykład aplikacja korzystająca z zakresu drive.readonly.metadata nie jest uprawniona do pobierania zawartości pliku. Przykłady kodu biblioteki klienta używają ograniczonego zakresu plików drive, który umożliwia użytkownikom wyświetlanie wszystkich plików na Dysku i zarządzanie nimi. Więcej informacji o zakresach Dysku znajdziesz w artykule Wybieranie zakresów interfejsu Google Drive API.

Użytkownicy z uprawnieniami owner (w przypadku plików na Moim dysku) lub organizer (w przypadku plików na dysku współdzielonym) mogą ograniczyć pobieranie za pomocą DownloadRestrictionsMetadata obiektu. Więcej informacji znajdziesz w artykule Uniemożliwianie użytkownikom pobierania, drukowania i kopiowania pliku.

Pliki uznane za obraźliwe (np. szkodliwe oprogramowanie) mogą być pobierane tylko przez właściciela pliku. Dodatkowo parametr zapytania acknowledgeAbuse musi być ustawiony na true, aby wskazać, że użytkownik zdaje sobie sprawę z ryzyka pobrania potencjalnie niechcianego oprogramowania lub innych obraźliwych plików. Przed użyciem tego parametru zapytania aplikacja powinna interaktywnie ostrzec użytkownika.

Dostęp do danych pliku w pamięci

Jeśli aplikacja musi mieć dostęp do danych pliku bezpośrednio w pamięci (np. jako bufor bajtów), a nie zapisywać ich na dysku lokalnym, możesz dostosować żądanie biblioteki klienta lub przetworzyć zwrócony strumień:

Node.js: domyślnie biblioteka klienta Node.js zwraca zawartość pliku jako strumień Readable. Aby zapisać plik na dysku lokalnym:

const fs = require('fs');

const dest = fs.createWriteStream('/path/to/dest/file.ext');
const response = await service.files.get(
  { fileId, alt: 'media' },
  { responseType: 'stream' }
);
response.data
  .on('end', () => {
    console.log('Download complete.');
  })
  .on('error', (err) => {
    console.error('Error downloading file.', err);
  })
  .pipe(dest);

Możesz też ustawić parametr responseType w opcjach żądania, aby dane były zwracane bezpośrednio w pamięci jako ArrayBuffer zamiast strumienia:

const file = await service.files.get({
  fileId,
  alt: 'media',
}, { responseType: 'arraybuffer' });

// Convert the ArrayBuffer to a Node.js Buffer object.
const buffer = Buffer.from(file.data);

Python: przykładowy kod w Pythonie do pobierania pliku blob już zapisuje pobrane fragmenty w obiekcie io.BytesIO() w pamięci. Aby uzyskać dostęp do surowych bajtów, wywołaj file.getvalue().
Java: przykładowy kod w Javie do pobierania pliku blob używa java.io.ByteArrayOutputStream do przechwytywania pobranych bajtów w pamięci. Aby uzyskać dostęp do surowej tablicy bajtów, użyj outputStream.toByteArray().
.NET: Przykładowy kod w C# do pobierania pliku blob używa System.IO.MemoryStream. Aby uzyskać dostęp do podstawowej tablicy bajtów, użyj stream.ToArray().
Apps Script: Przykładowy kod w Apps Script do pobierania pliku blob używa metody response.getBlob() do zwracania obiektu Blob. Aby przekonwertować go na tablicę bajtów, użyj metody getBytes().

Pobieranie częściowe

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

Range: bytes=500-999

Pobieranie zawartości 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 alt parametrem systemowym. Parametr alt=media informuje serwer, że żądanie pobrania treści jest alternatywnym formatem odpowiedzi. Podobnie jak files.get, metoda revisions.get akceptuje też parametr zapytania acknowledgeAbuse i nagłówek Range.

Możesz pobierać tylko wersje zawartości plików blob, które są oznaczone jako „Zachowaj na zawsze”. Jeśli chcesz pobrać wersję, najpierw ustaw ją na „Zachowaj na zawsze”. Więcej informacji znajdziesz w artykule Określanie wersji, które mają być zapisywane przed automatycznym usunięciem.

Dodatkowe informacje o pobieraniu wersji znajdziesz w artykule Zarządzanie operacjami długotrwałymi.

curl

curl -L "https://www.googleapis.com/drive/v3/files/FILE_ID/revisions/REVISION_ID?alt=media" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --output "FILE_NAME"

Zastąp te elementy:

FILE_ID: identyfikator pliku do pobrania.
REVISION_ID: identyfikator wersji do pobrania.
ACCESS_TOKEN: token dostępu, który przyznaje dostęp do interfejsu API.
FILE_NAME: nazwa pliku wyjściowego.

Pobieranie zawartości pliku blob w przeglądarce

Aby pobrać zawartość plików blob przechowywanych na Dysku w przeglądarce, a nie za pomocą interfejsu API, użyj pola webContentLink zasobu files. Jeśli użytkownik ma dostęp do pobierania pliku, zwracany jest link do pobrania pliku i jego zawartości. Możesz przekierować użytkownika na ten adres URL lub udostępnić go jako link, który można kliknąć.

curl

curl "https://www.googleapis.com/drive/v3/files/FILE_ID?fields=webContentLink" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json"

Zastąp te elementy:

FILE_ID: identyfikator pliku, dla którego chcesz uzyskać link do pobrania.
ACCESS_TOKEN: token dostępu, który przyznaje dostęp do interfejsu API.

Pobieranie zawartości pliku blob za pomocą operacji długotrwałych

Aby pobrać zawartość plików blob za pomocą operacji długotrwałych (LRO), użyj metody files.download z identyfikatorem pliku do pobrania. Opcjonalnie możesz ustawić identyfikator wersji.

Jest to jedyny sposób na pobranie plików Google Vids. Jeśli spróbujesz wyeksportować pliki Google Vids, otrzymasz fileNotExportable błąd. Więcej informacji znajdziesz w artykule Zarządzanie operacjami długotrwałymi.

curl

To polecenie curl inicjuje LRO i zwraca odpowiedź JSON. Aby pobrać plik lub sprawdzić stan tej LRO, musisz wysłać kolejne żądanie z zwróconym identyfikatorem, aby uzyskać adres URL treści. Następnie możesz wysłać ostateczne żądanie curl na ten adres URL, aby pobrać plik. Więcej informacji znajdziesz w artykule Zarządzanie operacjami długotrwałymi.

curl --request POST "https://www.googleapis.com/drive/v3/files/FILE_ID/download?mimeType=video/mp4" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Content-Length: 0" \
  --header "Accept: application/json"

Zastąp te elementy:

FILE_ID: identyfikator pliku do pobrania.
ACCESS_TOKEN: token dostępu, który przyznaje dostęp do interfejsu API.

Eksportowanie zawartości dokumentu Google Workspace

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

Poniższe przykłady kodu pokazują, jak używać metody files.export do eksportowania dokumentu Google Workspace w formacie PDF:

Apps Script

/**
 * Exports a Google Workspace document.
 * @param {string} fileId The ID of the file to export.
 * @param {string} mimeType The MIME type to export to.
 * @return {Blob} The exported content as a Blob.
 */
function exportPdf(fileId, mimeType) {
  var url = 'https://www.googleapis.com/drive/v3/files/' + fileId + '/export?mimeType=' + encodeURIComponent(mimeType);
  var response = UrlFetchApp.fetch(url, {
    headers: {
      'Authorization': 'Bearer ' + ScriptApp.getOAuthToken()
    }
  });
  return response.getBlob();
}

Java

drive/snippets/drive_v3/src/main/java/ExportPdf.java

Wyświetl w GitHubie

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

Wyświetl w GitHubie

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

Wyświetl w GitHubie

import {GoogleAuth} from 'google-auth-library';
import {google} from 'googleapis';

/**
 * Exports a Google Doc as a PDF.
 * @param {string} fileId The ID of the file to export.
 * @return {Promise<number>} The status of the export request.
 */
async function exportPdf(fileId) {
  // Authenticate with Google and get an authorized client.
  // TODO (developer): Use an appropriate auth mechanism for your app.
  const auth = new GoogleAuth({
    scopes: 'https://www.googleapis.com/auth/drive',
  });

  // Create a new Drive API client (v3).
  const service = google.drive({version: 'v3', auth});

  // Export the file as a PDF.
  const result = await service.files.export({
    fileId,
    mimeType: 'application/pdf',
  });

  // Print the status of the export.
  console.log(result.status);
  return result.status;
}

PHP

drive/snippets/drive_v3/src/DriveExportPdf.php

Wyświetl w GitHubie

<?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

Wyświetl w GitHubie

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

curl

curl -L "https://www.googleapis.com/drive/v3/files/FILE_ID/export?mimeType=application/pdf" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --output "FILE_NAME.pdf"

Zastąp te elementy:

FILE_ID: identyfikator pliku do pobrania.
ACCESS_TOKEN: token dostępu, który przyznaje dostęp do interfejsu API.
FILE_NAME: nazwa pliku wyjściowego.

Przykłady kodu biblioteki klienta używają ograniczonego zakresu drive, który umożliwia użytkownikom wyświetlanie wszystkich plików na Dysku i zarządzanie nimi. Więcej informacji o zakresach Dysku znajdziesz w artykule Wybieranie zakresów interfejsu Google Drive API.

Przykłady kodu deklarują też typ MIME eksportu jako application/pdf. Pełną listę wszystkich typów MIME eksportu obsługiwanych w przypadku każdego dokumentu Google Workspace znajdziesz w artykule Typy MIME eksportu w przypadku dokumentów Google Workspace.

Eksportowanie zawartości dokumentu Google Workspace w przeglądarce

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

curl

curl "https://www.googleapis.com/drive/v3/files/FILE_ID?fields=id,name,exportLinks" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json"

Zastąp te elementy:

FILE_ID: identyfikator pliku, dla którego chcesz uzyskać link do pobrania.
ACCESS_TOKEN: token dostępu, który przyznaje dostęp do interfejsu API.

Eksportowanie zawartości dokumentu Google Workspace w starszej wersji w przeglądarce

Aby wyeksportować zawartość dokumentu Google Workspace w starszej wersji w przeglądarce, użyj metody revisions.get z identyfikatorem pliku do pobrania i identyfikatorem wersji, aby wygenerować link do eksportu, z którego możesz pobrać plik. Jeśli użytkownik ma dostęp do pobierania pliku, zwracany jest link do pobrania pliku i jego zawartości. Możesz przekierować użytkownika na ten adres URL lub udostępnić go jako link, który można kliknąć.

curl

curl "https://www.googleapis.com/drive/v3/files/FILE_ID/revisions/REVISION_ID?fields=id,name,exportLinks" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json"

Zastąp te elementy:

FILE_ID: identyfikator pliku do pobrania.
REVISION_ID: identyfikator wersji do pobrania.
ACCESS_TOKEN: token dostępu, który przyznaje dostęp do interfejsu API.

Eksportowanie zawartości dokumentu Google Workspace za pomocą operacji długotrwałych

Aby wyeksportować zawartość dokumentu Google Workspace za pomocą operacji długotrwałych (LRO), użyj metody files.download z identyfikatorem pliku do pobrania i identyfikatorem wersji. Więcej informacji znajdziesz w artykule Zarządzanie operacjami długotrwałymi.

curl

curl --request POST "https://www.googleapis.com/drive/v3/files/FILE_ID/download?mimeType=MIME_TYPE&revisionId=REVISION_ID" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Content-Length: 0" \
  --header "Accept: application/json"

Zastąp te elementy:

FILE_ID: identyfikator pliku do pobrania.
MIME_TYPE: typ MIME, do którego chcesz wyeksportować plik.
REVISION_ID: identyfikator wersji do pobrania.
ACCESS_TOKEN: token dostępu, który przyznaje dostęp do interfejsu API.

Pobieranie i eksportowanie plików Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Pobieranie zawartości pliku blob

Apps Script

Java

Python

Node.js

PHP

.NET

curl

Dostęp do danych pliku w pamięci

Pobieranie częściowe

Pobieranie zawartości pliku blob w starszej wersji

curl

Pobieranie zawartości pliku blob w przeglądarce

curl

Pobieranie zawartości pliku blob za pomocą operacji długotrwałych

curl

Eksportowanie zawartości dokumentu Google Workspace

Apps Script

Java

Python

Node.js

PHP

.NET

curl

Eksportowanie zawartości dokumentu Google Workspace w przeglądarce

curl

Eksportowanie zawartości dokumentu Google Workspace w starszej wersji w przeglądarce

curl

Eksportowanie zawartości dokumentu Google Workspace za pomocą operacji długotrwałych

curl

Powiązane artykuły

Pobieranie i eksportowanie plików