Dosyaları indirme ve dışa aktarma

Google Drive API'si, aşağıdakiler de dahil olmak üzere çeşitli indirme ve dışa aktarma işlemi türlerini destekler: aşağıdaki tabloda listelenmiştir:

İndirmeler
alt=media URL parametresiyle files.get yöntemini kullanan Blob dosyası içeriği.
alt=media URL parametresiyle revisions.get yöntemini kullanarak önceki bir sürümdeki Blob dosya içeriği.
Bir tarayıcıda webContentLink alanını kullanan Blob dosyası içeriği.
Dışa aktarma işlemleri
Uygulamanızın files.export kullanarak işleyebileceği biçimde Google Workspace dokümanı içeriği.
Tarayıcıda exportLinks alanı kullanılarak Google Workspace doküman içeriği.
Tarayıcıda exportLinks alanı kullanılarak Google Workspace doküman içeriği.

Dosya içeriğini indirmeden veya dışa aktarmadan önce kullanıcıların capabilities.canDownload alanını kullanarak dosyayı files kaynak.

Bu kılavuzun geri kalanında, bu türlerin gerçekleştirilmesine ilişkin ayrıntılı talimatlar sunulmaktadır. indirme ve dışa aktarma işlemleri.

Blob dosyası içeriğini indir

Drive'da depolanan bir blob dosyasını indirmek için indirilecek dosyanın kimliğiyle birlikte files.get yöntemini kullanın ve alt=media URL parametresi. alt=media URL parametresi alternatif yanıt olarak içerik indirilmesinin istendiği sunucu biçimindedir.

alt=media URL parametresi bir sistem parametresini tüm Google REST API'lerinde kullanılabilir. Bir dosya için istemci kitaplığı kullanıyorsanız Drive API'de bu parametreyi açık şekilde ayarlamanız gerekmez.

Aşağıdaki kod örneğinde, birfiles.get dosyasını yükleyin.

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

Bu kod örneğinde, alt=media URL parametresini ekleyen bir kitaplık yöntemi kullanılmaktadır. bağlamayı seviyorum.

Uygulamanızdan başlatılan dosya indirme işlemleri, okuma erişimine sahip olursunuz. Örneğin, drive.readonly.metadata kapsamı, dosya içeriklerini indirme yetkisine sahip değil. Bu kod örneğinde, kullanıcıların şunları yapmasına olanak tanıyan kısıtlanmış "drive" dosya kapsamı kullanılmaktadır: tüm Drive dosyalarınızı görüntüleyebilir ve yönetebilirsiniz. Şu konu hakkında daha fazla bilgi edinmek için: Drive kapsamları, bkz. Google Drive API'yi seçme kapsamlarını inceleyin.

Düzenleme izinlerine sahip kullanıcılar, indirme işlemini salt okuma erişimine sahip kullanıcılar tarafından copyRequiresWriterPermission ayarlanıyor alanını false olarak ayarlayın.

Dosyalar şu şekilde tanımlandı: kötüye kullanım (zararlı yazılımlar gibi) yalnızca dosya sahibi tarafından indirilebilir. Ayrıca, get sorgu parametresi acknowledgeAbuse=true dahil edilmelidir. kullanıcının potansiyel olarak indirme riskini kabul ettiğini belirtmek için istenmeyen yazılımlar veya kötüye kullanım amaçlı diğer dosyalar. Uygulamanız etkileşimli olarak bu sorgu parametresini kullanmadan önce kullanıcıyı uyarır.

Kısmi indirme

Kısmi indirme, bir dosyanın yalnızca belirli bir bölümünün indirilmesini içerir. Siz dosyanın indirmek istediğiniz bölümünü bir bayt aralık Range üstbilgisi. Örneğin:

Range: bytes=500-999

Blob dosyası içeriğini önceki bir sürümde indirme

Blob dosyalarının içeriğini önceki bir sürümde indirmek için Şu kimliğe sahip revisions.get yöntemi: indirilecek dosyayı, düzeltmenin kimliğini ve alt=media URL parametresini içermelidir. alt=media URL parametresi, sunucuya içerik indirme işleminin soruluyor. files.get özelliğine benzer şekilde, revisions.get yöntemi, isteğe bağlı sorgu parametresini de kabul eder acknowledgeAbuse ve Range başlığı. İndirme hakkında daha fazla bilgi için Dosya indirme ve yayınlama düzeltme.

Blob dosyası içeriğini bir tarayıcıda indirme

Drive'da depolanan blob dosyalarının içeriğini web tarayıcısında Google Etiket Yöneticisi ile webContentLink files kaynak. Kullanıcı indirme işlemi yapmışsa dosyayı ve içeriğini indirmek için kullanabileceğiniz bir bağlantı geri döndü. Kullanıcıları bu URL'ye yönlendirebilir veya tıklanabilir olarak sunabilirsiniz. bağlantısını tıklayın.

Google Workspace doküman içeriğini dışa aktarma

Google Workspace doküman baytı içeriğini dışa aktarmak için dışa aktarılacak dosyanın kimliğiyle files.export yöntemini kullanın. ve doğru MIME türü olduğundan emin olun. Dışa aktarıldı içerik 10 MB ile sınırlıdır.

Aşağıdaki kod örneğinde, bir dışa aktarma işlemi için files.export yönteminin nasıl kullanılacağı Drive API istemcisi kullanılarak PDF biçiminde Google Workspace dokümanı kitaplıklar:

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

Bu kod örneğinde, kullanıcıların görüntülemesine vedrive tüm Drive dosyalarınızı yönetmenizi sağlar. Şu konu hakkında daha fazla bilgi edinmek için: Drive kapsamları, bkz. Google Drive API'yi seçme kapsamlarını inceleyin.

Kod örneği, dışa aktarma MIME türünü de application/pdf olarak tanımlar. Örneğin, Her Google Workspace için desteklenen tüm dışa aktarma MIME türlerinin tam listesi Google Workspace için MIME türlerini dışa aktarma dokümanlar için de ekleyebilirsiniz.

Google Workspace doküman içeriğini tarayıcıda dışa aktarma

Google Workspace doküman içeriğini tarayıcıda dışa aktarmak için exportLinks files kaynak. Dokümana bağlı olarak her MIME için dosyayı ve içeriğini indirmek için bir bağlantı döndürülür kullanabilirsiniz. Kullanıcıyı bir URL'ye yönlendirebilir veya URL'ye tıklanabilir bağlantı.

Google Workspace doküman içeriğini tarayıcıda önceki bir sürümde dışa aktarma

Google Workspace doküman içeriğini bir tarayıcı için revisions.get yöntemini kullanın indirilecek dosyanın kimliği ve düzeltmenin kimliği. Kullanıcı indirme erişimi; dosyayı ve içeriğini indirmek için kullanabileceğiniz bir bağlantı geri döndü. Kullanıcıları bu URL'ye yönlendirebilir veya tıklanabilir olarak sunabilirsiniz. bağlantısını tıklayın.