Dosyaları indirme ve dışa aktarma

Google Drive API, aşağıdaki tabloda listelendiği gibi çeşitli indirme ve dışa aktarma işlemlerini destekler:

İndirme işlemleri
alt=media URL parametresiyle files.get yöntemini kullanarak blob dosya içeriği.
revisions.get URL parametresiyle alt=media yöntemini kullanarak önceki bir sürümdeki blob dosyası içeriği.
webContentLink alanını kullanarak tarayıcıda blob dosyası içeriği.
Uzun süren işlemler sırasında files.download yöntemini kullanarak blob dosyası içeriği. Google Vids dosyalarını indirmenin tek yolu budur.
Dışa aktarma işlemleri
files.export yöntemini kullanarak uygulamanızın işleyebileceği bir biçimde Google Workspace doküman içeriği.
exportLinks alanını kullanarak tarayıcıdaki Google Workspace doküman içeriği
exportLinks alanını kullanarak Google Workspace doküman içeriğini tarayıcıda önceki bir sürümde görüntüleme
Uzun süren işlemler sırasında files.download yöntemini kullanarak Google Workspace doküman içeriği.

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

Blob ve Google Workspace dosyaları da dahil olmak üzere burada bahsedilen dosya türlerinin açıklamaları için Dosya türleri başlıklı makaleyi inceleyin.

Bu kılavuzun geri kalanında, bu tür indirme ve dışa aktarma işlemlerini gerçekleştirme ile ilgili ayrıntılı talimatlar verilmektedir.

Blob dosyası içeriğini indirme

Drive'da depolanan bir blob dosyasını indirmek için files.get yöntemini, indirilecek dosyanın kimliği ve alt=media URL parametresiyle birlikte kullanın. alt=media URL parametresi, sunucuya alternatif yanıt biçimi olarak içerik indirme isteğinde bulunulduğunu bildirir.

alt=media URL parametresi, tüm Google REST API'lerinde kullanılabilen bir sistem parametresidir. Drive API için bir istemci kitaplığı kullanıyorsanız bu parametreyi açıkça ayarlamanız gerekmez.

Aşağıdaki kod örneğinde, Drive API istemci kitaplıklarıyla bir dosyayı indirmek için files.get yönteminin nasıl kullanılacağı gösterilmektedir.

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, temel HTTP isteğine alt=media URL parametresini ekleyen bir kitaplık yöntemi kullanılmaktadır.

Uygulamanızdan başlatılan dosya indirme işlemleri, dosya içeriğine okuma erişimine izin veren bir kapsamla yetkilendirilmelidir. Örneğin, drive.readonly.metadata kapsamını kullanan bir uygulamanın dosya içeriklerini indirme yetkisi yoktur. Bu kod örneğinde, kullanıcıların tüm Drive dosyalarınızı görüntülemesine ve yönetmesine olanak tanıyan kısıtlanmış "drive" dosya kapsamı kullanılmaktadır. Drive kapsamları hakkında daha fazla bilgi edinmek için Google Drive API kapsamlarını seçme başlıklı makaleyi inceleyin.

owner izinlerine (Drive'ım dosyaları için) veya organizer izinlerine (ortak Drive dosyaları için) sahip kullanıcılar, DownloadRestrictionsMetadata nesnesi aracılığıyla indirmeyi kısıtlayabilir. Daha fazla bilgi için Kullanıcıların dosyanızı indirmesini, yazdırmasını veya kopyalamasını engelleme başlıklı makaleyi inceleyin.

Kötüye kullanım olarak tanımlanan dosyalar (ör. zararlı yazılımlar) yalnızca dosya sahibi tarafından indirilebilir. Ayrıca, kullanıcının istenmeyen yazılım veya diğer kötüye kullanım amaçlı dosyaları indirme riskini kabul ettiğini belirtmek için get sorgu parametresi acknowledgeAbuse=true de eklenmelidir. Uygulamanız, bu sorgu parametresini kullanmadan önce kullanıcıyı etkileşimli olarak uyarmalıdır.

Kısmi indirme

Kısmi indirme, bir dosyanın yalnızca belirtilen bölümünün indirilmesini ifade eder. Range üstbilgisiyle bayt aralığı kullanarak dosyanın indirmek istediğiniz bölümünü belirtebilirsiniz. Örneğin:

Range: bytes=500-999

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

Yalnızca "Daima sakla" olarak işaretlenen blob dosyası içeriği düzeltmelerini indirebilirsiniz. Bir revizyonu indirmek istiyorsanız önce "Daima sakla" olarak ayarlayın. Daha fazla bilgi için Otomatik silme işleminden kurtarmak üzere kaydedilecek düzeltmeleri belirtme başlıklı makaleyi inceleyin.

Blob dosyalarının içeriğini daha önceki bir sürümde indirmek için revisions.get yöntemini kullanın. Bu yöntemde, indirilecek dosyanın kimliği, düzeltmenin kimliği ve alt=media URL parametresi yer alır. alt=media URL parametresi, sunucuya alternatif yanıt biçimi olarak içerik indirme isteğinde bulunulduğunu bildirir. files.get yöntemine benzer şekilde, revisions.get yöntemi de isteğe bağlı sorgu parametresi acknowledgeAbuse ve Range başlığını kabul eder. Daha fazla bilgi için Uzun süren işlemleri yönetme başlıklı makaleyi inceleyin.

İstek protokolü burada gösterilir.

GET https://www.googleapis.com/drive/v3/files/{FILE_ID}/revisions/{REVISION_ID}?alt=media

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

Drive'da depolanan blob dosyalarının içeriğini API üzerinden değil, tarayıcıda indirmek için files kaynağının webContentLink alanını kullanın. Kullanıcının dosyaya indirme erişimi varsa dosyanın ve içeriğinin indirme bağlantısı döndürülür. Kullanıcıyı bu URL'ye yönlendirebilir veya tıklanabilir bir bağlantı olarak sunabilirsiniz.

Uzun süren işlemler sırasında blob dosyası içeriğini indirme

Uzun süren işlemler sırasında blob dosyalarının içeriğini indirmek için indirilecek dosyanın kimliğiyle birlikte files.download yöntemini kullanın. İsteğe bağlı olarak düzeltmenin kimliğini ayarlayabilirsiniz. Google Vids dosyalarını indirmenin tek yolu budur. Daha fazla bilgi için Uzun süren işlemleri yönetme başlıklı makaleyi inceleyin.

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ği ve doğru MIME türü ile files.export yöntemini kullanın. Dışa aktarılan içerik 10 MB ile sınırlıdır.

Aşağıdaki kod örneğinde, Drive API istemci kitaplıklarını kullanarak bir Google Workspace belgesini PDF biçiminde dışa aktarmak için files.export yönteminin nasıl kullanılacağı gösterilmektedir:

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 tüm Drive dosyalarınızı görüntülemesine ve yönetmesine olanak tanıyan kısıtlanmış drive kapsamı kullanılır. Drive kapsamları hakkında daha fazla bilgi edinmek için Google Drive API kapsamlarını seçme başlıklı makaleyi inceleyin.

Kod örneğinde, dışa aktarma MIME türü de application/pdf olarak bildirilir. Her Google Workspace belgesi için desteklenen tüm dışa aktarma MIME türlerinin eksiksiz listesi için Google Workspace belgeleri için dışa aktarma MIME türleri başlıklı makaleyi inceleyin.

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

Google Workspace doküman içeriğini tarayıcıdan dışa aktarmak için files kaynağının exportLinks alanını kullanın. Doküman türüne bağlı olarak, kullanılabilir her MIME türü için dosyanın ve içeriğinin indirilebileceği bir bağlantı döndürülür. Kullanıcıyı bir URL'ye yönlendirebilir veya tıklanabilir bir bağlantı olarak sunabilirsiniz.

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

Google Workspace doküman içeriğini tarayıcıda daha eski bir sürümde dışa aktarmak için revisions.get yöntemini kullanın. Bu yöntemde, indirilecek dosyanın kimliği ve dışa aktarma bağlantısı oluşturulacak düzeltmenin kimliği kullanılır. Bu bağlantıdan indirme işlemini gerçekleştirebilirsiniz. Kullanıcının dosyayı indirme erişimi varsa dosyanın ve içeriğinin indirme bağlantısı döndürülür. Kullanıcıyı bu URL'ye yönlendirebilir veya tıklanabilir bir bağlantı olarak sunabilirsiniz.

Uzun süren işlemler sırasında Google Workspace doküman içeriğini dışa aktarma

Uzun süren işlemler sırasında Google Workspace doküman içeriğini dışa aktarmak için files.download yöntemini kullanın. Bu yöntemde, indirilecek dosyanın kimliği ve düzeltme kimliği belirtilir. Daha fazla bilgi için Uzun süren işlemleri yönetme başlıklı makaleyi inceleyin.

Dosyaların paylaşımını sınırlandırma