Bu sayfa, Cloud Translation API ile çevrilmiştir.

Dosya verilerini yükle

Google Drive API, File oluşturduğunuzda veya güncellediğinizde dosya verilerini yüklemenize olanak tanır. Klasör gibi yalnızca meta verilerden oluşan bir dosya oluşturma hakkında bilgi edinmek için Yalnızca meta verilerden oluşan dosyalar oluşturma başlıklı makaleyi inceleyin.

Üç tür yükleme yapabilirsiniz:

Basit yükleme (uploadType=media): Meta veri sağlamadan küçük bir medya dosyasını (5 MB veya daha az) aktarmak için bu yükleme türünü kullanın. Basit bir yükleme işlemi gerçekleştirmek için Basit yükleme gerçekleştirme başlıklı makaleyi inceleyin.
Çok parçalı yükleme (uploadType=multipart): "Bu yükleme türünü, dosyayı açıklayan meta verilerle birlikte küçük bir dosyayı (5 MB veya daha az) tek bir istekte aktarmak için kullanın. Çok parçalı yükleme gerçekleştirmek için Çok parçalı yükleme gerçekleştirme başlıklı makaleyi inceleyin.
Devam ettirilebilir yükleme (uploadType=resumable): Bu yükleme türünü büyük dosyalar (5 MB'tan büyük) için ve ağ kesintisi olasılığının yüksek olduğu durumlarda (ör. mobil uygulamadan dosya oluştururken) kullanın. Devam ettirilebilir yüklemeler, yükleme başına yalnızca bir ek HTTP isteği maliyetiyle küçük dosyalar için de çalıştığından çoğu uygulama için iyi bir seçimdir. Devam ettirilebilir yükleme gerçekleştirmek için Devam ettirilebilir yükleme gerçekleştirme başlıklı makaleyi inceleyin.

Google API istemci kitaplıkları, bu yükleme türlerinden en az birini uygular. Her türün nasıl kullanılacağı hakkında daha fazla bilgi için istemci kitaplığı belgelerine bakın.

`PATCH` ve `PUT` kullanımı

HTTP fiili PATCH, kısmi dosya kaynağı güncellemesini desteklerken HTTP fiili PUT, kaynağın tamamen değiştirilmesini destekler. PUT Mevcut bir kaynağa yeni alan eklerken uyumluluğu bozan değişiklikler yapabileceğini unutmayın.

Dosya kaynağı yüklerken aşağıdaki yönergeleri kullanın:

Devam ettirilebilir yüklemenin ilk isteği veya basit ya da çok parçalı yüklemenin tek isteği için API referansında belgelenen HTTP fiilini kullanın.
İstek başlatıldıktan sonra, devam ettirilebilir yüklemeyle ilgili tüm sonraki istekler için PUT kullanın. Bu istekler, çağrılan yönteme bakılmaksızın içerik yüklüyor.

Basit bir yükleme gerçekleştirme

Basit bir yükleme işlemi gerçekleştirmek için uploadType=media ile files.create yöntemini kullanın.

Aşağıda, basit bir yükleme işleminin nasıl yapılacağı gösterilmektedir:

HTTP

uploadType=media sorgu parametresiyle yöntemin /upload URI'sine POST isteği oluşturun:

POST https://www.googleapis.com/upload/drive/v3/files?uploadType=media
Dosyanın verilerini istek gövdesine ekleyin.
Şu HTTP üstbilgilerini ekleyin:
- Content-Type. Yüklenen nesnenin MIME medya türüne ayarlanır.
- Content-Length. Yüklediğiniz bayt sayısına ayarlayın. Parçalı aktarım kodlaması kullanıyorsanız bu üstbilgi gerekli değildir.
İsteği gönderin. İstek başarılı olursa sunucu, dosyanın meta verileriyle birlikte HTTP 200 OK durum kodunu döndürür. {HTTP}

Basit bir yükleme işlemi gerçekleştirdiğinizde temel meta veriler oluşturulur ve dosyadaki bazı özellikler (ör. MIME türü veya modifiedTime) çıkarılır. Küçük dosyalarınızın olduğu ve dosya meta verilerinin önemli olmadığı durumlarda basit yükleme yöntemini kullanabilirsiniz.

Çok parçalı yükleme gerçekleştirme

Çok parçalı yükleme isteği, meta verileri ve verileri aynı istekte yüklemenize olanak tanır. Bağlantı başarısız olursa gönderdiğiniz veriler tekrar yüklenmeye yetecek kadar küçükse bu seçeneği kullanın.

Çok parçalı yükleme gerçekleştirmek için uploadType=multipart ile birlikte files.create yöntemini kullanın.

Aşağıda, çok parçalı yüklemenin nasıl yapılacağı gösterilmektedir:

Java

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

GitHub'da göster

import com.google.api.client.googleapis.json.GoogleJsonResponseException;
import com.google.api.client.http.FileContent;
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.api.services.drive.model.File;
import com.google.auth.http.HttpCredentialsAdapter;
import com.google.auth.oauth2.GoogleCredentials;
import java.io.IOException;
import java.util.Arrays;

/* Class to demonstrate use of Drive insert file API */
public class UploadBasic {

  /**
   * Upload new file.
   *
   * @return Inserted file metadata if successful, {@code null} otherwise.
   * @throws IOException if service account credentials file not found.
   */
  public static String uploadBasic() 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();
    // Upload file photo.jpg on drive.
    File fileMetadata = new File();
    fileMetadata.setName("photo.jpg");
    // File's content.
    java.io.File filePath = new java.io.File("files/photo.jpg");
    // Specify media type and file-path for file.
    FileContent mediaContent = new FileContent("image/jpeg", filePath);
    try {
      File file = service.files().create(fileMetadata, mediaContent)
          .setFields("id")
          .execute();
      System.out.println("File ID: " + file.getId());
      return file.getId();
    } catch (GoogleJsonResponseException e) {
      // TODO(developer) - handle error appropriately
      System.err.println("Unable to upload file: " + e.getDetails());
      throw e;
    }
  }
}

Python

drive/snippets/drive-v3/file_snippet/upload_basic.py

GitHub'da göster

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


def upload_basic():
  """Insert new file.
  Returns : Id's of the file uploaded

  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_metadata = {"name": "download.jpeg"}
    media = MediaFileUpload("download.jpeg", mimetype="image/jpeg")
    # pylint: disable=maybe-no-member
    file = (
        service.files()
        .create(body=file_metadata, media_body=media, fields="id")
        .execute()
    )
    print(f'File ID: {file.get("id")}')

  except HttpError as error:
    print(f"An error occurred: {error}")
    file = None

  return file.get("id")


if __name__ == "__main__":
  upload_basic()

Node.js

drive/snippets/drive_v3/file_snippets/upload_basic.js

GitHub'da göster

/**
 * Insert new file.
 * @return{obj} file Id
 * */
async function uploadBasic() {
  const fs = require('fs');
  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});
  const requestBody = {
    name: 'photo.jpg',
    fields: 'id',
  };
  const media = {
    mimeType: 'image/jpeg',
    body: fs.createReadStream('files/photo.jpg'),
  };
  try {
    const file = await service.files.create({
      requestBody,
      media: media,
    });
    console.log('File Id:', file.data.id);
    return file.data.id;
  } catch (err) {
    // TODO(developer) - Handle error
    throw err;
  }
}

PHP

drive/snippets/drive_v3/src/DriveUploadBasic.php

GitHub'da göster

<?php
use Google\Client;
use Google\Service\Drive;
# TODO - PHP client currently chokes on fetching start page token
function uploadBasic()
{
    try {
        $client = new Client();
        $client->useApplicationDefaultCredentials();
        $client->addScope(Drive::DRIVE);
        $driveService = new Drive($client);
        $fileMetadata = new Drive\DriveFile(array(
        'name' => 'photo.jpg'));
        $content = file_get_contents('../files/photo.jpg');
        $file = $driveService->files->create($fileMetadata, array(
            'data' => $content,
            'mimeType' => 'image/jpeg',
            'uploadType' => 'multipart',
            'fields' => 'id'));
        printf("File ID: %s\n", $file->id);
        return $file->id;
    } catch(Exception $e) {
        echo "Error Message: ".$e;
    } 

}

.NET

drive/snippets/drive_v3/DriveV3Snippets/UploadBasic.cs

GitHub'da göster

using Google.Apis.Auth.OAuth2;
using Google.Apis.Drive.v3;
using Google.Apis.Services;

namespace DriveV3Snippets
{
    // Class to demonstrate use of Drive insert file API
    public class UploadBasic
    {
        /// <summary>
        /// Upload new file.
        /// </summary>
        /// <param name="filePath">Image path to upload.</param>
        /// <returns>Inserted file metadata if successful, null otherwise.</returns>
        public static string DriveUploadBasic(string filePath)
        {
            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"
                });

                // Upload file photo.jpg on drive.
                var fileMetadata = new Google.Apis.Drive.v3.Data.File()
                {
                    Name = "photo.jpg"
                };
                FilesResource.CreateMediaUpload request;
                // Create a new file on drive.
                using (var stream = new FileStream(filePath,
                           FileMode.Open))
                {
                    // Create a new file, with metadata and stream.
                    request = service.Files.Create(
                        fileMetadata, stream, "image/jpeg");
                    request.Fields = "id";
                    request.Upload();
                }

                var file = request.ResponseBody;
                // Prints the uploaded file id.
                Console.WriteLine("File ID: " + file.Id);
                return file.Id;
            }
            catch (Exception e)
            {
                // TODO(developer) - handle error appropriately
                if (e is AggregateException)
                {
                    Console.WriteLine("Credential Not found");
                }
                else if (e is FileNotFoundException)
                {
                    Console.WriteLine("File not found");
                }
                else
                {
                    throw;
                }
            }
            return null;
        }
    }
}

HTTP

uploadType=multipart sorgu parametresiyle yöntemin /upload URI'sine POST isteği oluşturun:

POST https://www.googleapis.com/upload/drive/v3/files?uploadType=multipart
İsteğin gövdesini oluşturun. Gövdeyi, iki bölümden oluşan RFC 2387 çok parçalı/ilişkili içerik türüne göre biçimlendirin:
- Meta veriler. Meta veriler önce gelmeli ve Content-Type başlığı application/json; charset=UTF-8 olarak ayarlanmış olmalıdır. Dosyanın meta verilerini JSON biçiminde ekleyin.
- Medya Medya ikinci sırada olmalı ve herhangi bir MIME türünde Content-Type üstbilgisine sahip olmalıdır. Dosyanın verilerini medya bölümüne ekleyin.
Her bölümü, başında iki kısa çizgi bulunan bir sınır dizesiyle tanımlayın. Ayrıca, son sınır dizesinden sonra iki tire ekleyin.
Şu üst düzey HTTP üstbilgilerini ekleyin:
- Content-Type. multipart/related olarak ayarlayın ve isteğin farklı bölümlerini tanımlamak için kullandığınız sınır dizesini ekleyin. Örneğin: Content-Type: multipart/related; boundary=foo_bar_baz
- Content-Length. İstek gövdesindeki toplam bayt sayısına ayarlanır.
İsteği gönderin.

Yalnızca meta veri bölümünü ilişkili veriler olmadan oluşturmak veya güncellemek için standart kaynak uç noktasına POST veya PATCH isteği gönderin: https://www.googleapis.com/drive/v3/files İstek başarılı olursa sunucu, dosyanın meta verileriyle birlikte HTTP 200 OK durum kodunu döndürür.

Dosya oluştururken dosyanın name alanında bir dosya uzantısı belirtmelidirler. Örneğin, fotoğraf JPEG dosyası oluştururken meta verilerde "name": "photo.jpg" gibi bir değer belirtebilirsiniz. files.get için sonraki çağrılar, name alanında başlangıçta belirtilen uzantıyı içeren salt okunur fileExtension özelliğini döndürür.

Devam ettirilebilir yükleme gerçekleştirme

Devam ettirilebilir yükleme, iletişim hatası nedeniyle veri akışı kesintiye uğradıktan sonra yükleme işlemine devam etmenizi sağlar. Büyük dosya yüklemelerini baştan başlatmanız gerekmediğinden, devam ettirilebilir yüklemeler ağ hatası durumunda bant genişliği kullanımınızı da azaltabilir.

Dosya boyutlarınızın büyük ölçüde değişebileceği veya istekler için sabit bir süre sınırı olduğu durumlarda (ör. mobil işletim sistemi arka plan görevleri ve belirli App Engine istekleri) devam ettirilebilir yüklemeler kullanışlıdır. Yükleme ilerleme çubuğu göstermek istediğiniz durumlarda da devam ettirilebilir yüklemeleri kullanabilirsiniz.

Devam ettirilebilir yükleme, üst düzeyde birkaç adımdan oluşur:

İlk isteği gönderin ve devam ettirilebilir oturum URI'sini alın.
Verileri yükleyin ve yükleme durumunu izleyin.
(İsteğe bağlı) Yükleme işlemi kesintiye uğrarsa yüklemeye devam edin.

İlk isteği gönderme

Devam ettirilebilir yükleme başlatmak için uploadType=resumable ile files.create yöntemini kullanın.

HTTP

uploadType=resumable sorgu parametresiyle yöntemin /upload URI'sine POST isteği oluşturun:

POST https://www.googleapis.com/upload/drive/v3/files?uploadType=resumable

Başlatma isteği başarılı olursa yanıtta 200 OK HTTP durum kodu yer alır. Ayrıca, devam ettirilebilir oturum URI'sini belirten bir Location üst bilgisi de içerir:
```
HTTP/1.1 200 OK
Location: https://www.googleapis.com/upload/drive/v3/files?uploadType=resumable&upload_id=xa298sd_sdlkj2
Content-Length: 0
```
Dosya verilerini yükleyebilmek ve yükleme durumunu sorgulayabilmek için devam ettirilebilir oturum URI'sini kaydedin. Devam ettirilebilir oturum URI'sinin süresi bir hafta sonra dolar.

Not: Mevcut bir dosyayı güncellemek için PUT simgesini kullanın.
Dosyanın meta verileri varsa meta verileri JSON biçiminde istek gövdesine ekleyin. Aksi takdirde istek gövdesini boş bırakın.
Şu HTTP üstbilgilerini ekleyin:
- X-Upload-Content-Type. İsteğe bağlıdır. Sonraki isteklerde aktarılan dosya verilerinin MIME türüne ayarlanır. Verilerin MIME türü meta verilerde veya bu başlık aracılığıyla belirtilmemişse nesne application/octet-stream. olarak sunulur.
- X-Upload-Content-Length. İsteğe bağlıdır. Sonraki isteklerde aktarılan dosya verilerinin bayt sayısı olarak ayarlanır.
- Content-Type. Dosyanın meta verileri varsa gereklidir. application/json; charset=UTF-8 olarak ayarlayın.
- Content-Length. Parçalı aktarım kodlaması kullanmıyorsanız gereklidir. Bu ilk isteğin gövdesindeki bayt sayısına ayarlanır.
İsteği gönderin. Oturum başlatma isteği başarılı olursa yanıtta 200 OK HTTP durum kodu yer alır. Ayrıca, yanıtta devam ettirilebilir oturum URI'sini belirten bir Location başlığı bulunur. Dosya verilerini yüklemek ve yükleme durumunu sorgulamak için devam ettirilebilir oturum URI'sini kullanın. Devam ettirilebilir oturum URI'sinin süresi bir hafta sonra dolar.
Devam ettirilebilir oturum URL'sini kopyalayıp kaydedin.
İçeriği yükleme işlemine devam edin.

İçeriği yükleyin

Devam ettirilebilir oturumla dosya yüklemenin iki yolu vardır:

Tek bir istekte içerik yükleme: Dosya tek bir istekte yüklenebiliyorsa, tek bir istek için sabit bir zaman sınırı yoksa veya yükleme ilerleme durumu göstergesi görüntülemeniz gerekmiyorsa bu yaklaşımı kullanın. Bu yaklaşım, daha az istek gerektirdiği ve daha iyi performans sağladığı için en iyi yöntemdir.
İçeriği birden fazla parça halinde yükleme: Tek bir istekte aktarılan veri miktarını azaltmanız gerekiyorsa bu yaklaşımı kullanın. Belirli App Engine istek sınıflarında olduğu gibi, tek tek istekler için sabit bir zaman sınırı olduğunda aktarılan verileri azaltmanız gerekebilir. Bu yaklaşım, yükleme ilerleme durumunu göstermek için özelleştirilmiş bir gösterge sağlamanız gerektiğinde de yararlıdır.

HTTP - tek istek

Devam ettirilebilir oturum URI'sine bir PUT isteği oluşturun.
Dosyanın verilerini istek gövdesine ekleyin.
Dosyadaki bayt sayısına ayarlanmış bir Content-Length HTTP üstbilgisi ekleyin.
İsteği gönderin. Yükleme isteği kesintiye uğrarsa veya 5xx yanıtı alırsanız Kesintiye uğrayan yüklemeye devam etme bölümündeki prosedürü uygulayın.

HTTP - multiple requests

Devam ettirilebilir oturum URI'sine bir PUT isteği oluşturun.
Parçanın verilerini istek gövdesine ekleyin. Yüklemeyi tamamlayan son parça hariç olmak üzere, 256 KB'ın (256 x 1024 bayt) katları şeklinde parçalar oluşturun. Yüklemenin verimli olması için parça boyutunu mümkün olduğunca büyük tutun.
Şu HTTP üstbilgilerini ekleyin:
- Content-Length. Geçerli parçadaki bayt sayısına ayarlanır.
- Content-Range. Yüklediğiniz dosyadaki hangi baytların gösterileceğini ayarlamak için kullanılır. Örneğin, Content-Range: bytes 0-524287/2000000, 2.000.000 baytlık bir dosyada ilk 524.288 baytı (256 x 1024 x 2) yüklediğinizi gösterir.
İsteği gönderin ve yanıtı işleyin. Yükleme isteği kesintiye uğrarsa veya 5xx yanıtı alırsanız Kesintiye uğrayan yüklemeyi devam ettirme bölümündeki prosedürü uygulayın.
Dosyada kalan her parça için 1-4 arasındaki adımları tekrarlayın. Bir sonraki parçanın nereden başlayacağını belirlemek için yanıttaki Range başlığını kullanın. Sunucunun önceki istekte gönderilen tüm baytları aldığını varsaymayın.

Dosya yükleme işlemi tamamlandığında, kaynakla ilişkili tüm meta verilerle birlikte 200 OK veya 201 Created yanıtını alırsınız.

Kesintiye uğrayan yüklemeyi devam ettirme

Yükleme isteği yanıt verilmeden önce sonlandırılırsa veya 503 Service Unavailable yanıtı alırsanız kesintiye uğrayan yüklemeyi devam ettirmeniz gerekir.

HTTP

Yükleme durumunu istemek için devam ettirilebilir oturum URI'sine boş bir PUT isteği oluşturun.
Dosyadaki mevcut konumun bilinmediğini belirtmek için Content-Range üstbilgisi ekleyin. Örneğin, toplam dosya uzunluğunuz 2.000.000 bayt ise Content-Range değerini */2000000 olarak ayarlayın. Dosyanın tam boyutunu bilmiyorsanız Content-Range değerini */* olarak ayarlayın.
İsteği gönderin.
Yanıtı işleme:
- 200 OK veya 201 Created yanıtı, yüklemenin tamamlandığını ve başka bir işlem yapılmasına gerek olmadığını gösterir.
- 308 Resume Incomplete yanıtı, dosyayı yüklemeye devam etmeniz gerektiğini gösterir.
- 404 Not Found yanıtı, yükleme oturumunun süresinin dolduğunu ve yüklemenin baştan başlatılması gerektiğini gösterir.
308 Resume Incomplete yanıtı aldıysanız sunucunun hangi baytları aldığını belirlemek için yanıtın Range üst bilgisini işleyin. Yanıtın Range üst bilgisi yoksa herhangi bir bayt alınmamıştır. Örneğin, Range başlığı, dosyanın ilk bytes=0-42 baytının alındığını ve yüklenecek bir sonraki parçanın 44. bayttan başlayacağını gösterir.
Yüklemeye nereden devam edeceğinizi öğrendiğinize göre, bir sonraki bayttan başlayarak dosyayı yüklemeye devam edin. Dosyanın hangi bölümünü gönderdiğinizi belirtmek için bir Content-Range üstbilgisi ekleyin. Örneğin, Content-Range: bytes 43-1999999, 44 ile 2.000.000 arasındaki baytları gönderdiğinizi gösterir.

Medya yükleme hatalarını giderme

Medya yüklerken hataları gidermek için aşağıdaki en iyi uygulamalardan yararlanın:

5xx hataları için bağlantı kesintileri nedeniyle başarısız olan yüklemeleri devam ettirin veya yeniden deneyin. 5xx hatalarını ele alma hakkında daha fazla bilgi için 500, 502, 503, 504 hataları başlıklı makaleyi inceleyin.
403 rate limit hataları için yüklemeyi yeniden deneyin. 403 rate limit hatalarını işleme hakkında daha fazla bilgi için 403 hatası: rateLimitExceeded başlıklı makaleyi inceleyin.
Devam ettirilebilir yükleme sırasında oluşan 4xx hataları (403 dahil) için yüklemeyi yeniden başlatın. Bu hatalar, yükleme oturumunun süresinin dolduğunu ve yeni bir oturum URI'si isteyerek yeniden başlatılması gerektiğini gösterir. Yükleme oturumlarının süresi de bir hafta işlem yapılmadığında dolar.

Google Dokümanlar'a aktarılabilen dosya türleri

Drive'da oluşturduğunuz dosyaları Google Dokümanlar veya E-Tablolar gibi Google Workspace dosya türlerine dönüştürmek isteyebilirsiniz. Örneğin, özelliklerinden yararlanmak için en sevdiğiniz kelime işlemcideki bir dokümanı Dokümanlar'a dönüştürmek isteyebilirsiniz.

Bir dosyayı belirli bir Google Workspace dosya türüne dönüştürmek için dosyayı oluştururken Google Workspace'i mimeType belirtin.

Aşağıda, CSV dosyasını Google Workspace sayfasına dönüştürme işlemi gösterilmektedir:

Java

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

GitHub'da göster

import com.google.api.client.googleapis.json.GoogleJsonResponseException;
import com.google.api.client.http.FileContent;
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.api.services.drive.model.File;
import com.google.auth.http.HttpCredentialsAdapter;
import com.google.auth.oauth2.GoogleCredentials;
import java.io.IOException;
import java.util.Arrays;

/* Class to demonstrate Drive's upload with conversion use-case. */
public class UploadWithConversion {

  /**
   * Upload file with conversion.
   *
   * @return Inserted file id if successful, {@code null} otherwise.
   * @throws IOException if service account credentials file not found.
   */
  public static String uploadWithConversion() 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();

    // File's metadata.
    File fileMetadata = new File();
    fileMetadata.setName("My Report");
    fileMetadata.setMimeType("application/vnd.google-apps.spreadsheet");

    java.io.File filePath = new java.io.File("files/report.csv");
    FileContent mediaContent = new FileContent("text/csv", filePath);
    try {
      File file = service.files().create(fileMetadata, mediaContent)
          .setFields("id")
          .execute();
      System.out.println("File ID: " + file.getId());
      return file.getId();
    } 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/upload_with_conversion.py

GitHub'da göster

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


def upload_with_conversion():
  """Upload file with conversion
  Returns: ID of the file uploaded

  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_metadata = {
        "name": "My Report",
        "mimeType": "application/vnd.google-apps.spreadsheet",
    }
    media = MediaFileUpload("report.csv", mimetype="text/csv", resumable=True)
    # pylint: disable=maybe-no-member
    file = (
        service.files()
        .create(body=file_metadata, media_body=media, fields="id")
        .execute()
    )
    print(f'File with ID: "{file.get("id")}" has been uploaded.')

  except HttpError as error:
    print(f"An error occurred: {error}")
    file = None

  return file.get("id")


if __name__ == "__main__":
  upload_with_conversion()

Node.js

drive/snippets/drive_v3/file_snippets/upload_with_conversion.js

GitHub'da göster

/**
 * Upload file with conversion
 * @return{obj} file Id
 * */
async function uploadWithConversion() {
  const fs = require('fs');
  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});
  const fileMetadata = {
    name: 'My Report',
    mimeType: 'application/vnd.google-apps.spreadsheet',
  };
  const media = {
    mimeType: 'text/csv',
    body: fs.createReadStream('files/report.csv'),
  };

  try {
    const file = await service.files.create({
      requestBody: fileMetadata,
      media: media,
      fields: 'id',
    });
    console.log('File Id:', file.data.id);
    return file.data.id;
  } catch (err) {
    // TODO(developer) - Handle error
    throw err;
  }
}

PHP

drive/snippets/drive_v3/src/DriveUploadWithConversion.php

GitHub'da göster

<?php
use Google\Client;
use Google\Service\Drive;
function uploadWithConversion()
{
    try {
        $client = new Client();
        $client->useApplicationDefaultCredentials();
        $client->addScope(Drive::DRIVE);
        $driveService = new Drive($client);
        $fileMetadata = new Drive\DriveFile(array(
            'name' => 'My Report',
            'mimeType' => 'application/vnd.google-apps.spreadsheet'));
        $content = file_get_contents('../files/report.csv');
        $file = $driveService->files->create($fileMetadata, array(
            'data' => $content,
            'mimeType' => 'text/csv',
            'uploadType' => 'multipart',
            'fields' => 'id'));
        printf("File ID: %s\n", $file->id);
        return $file->id;
    } catch(Exception $e) {
        echo "Error Message: ".$e;
    }

}

.NET

drive/snippets/drive_v3/DriveV3Snippets/UploadWithConversion.cs

GitHub'da göster

using Google.Apis.Auth.OAuth2;
using Google.Apis.Drive.v3;
using Google.Apis.Services;

namespace DriveV3Snippets
{
    // Class to demonstrate Drive's upload with conversion use-case.
    public class UploadWithConversion
    {
        /// <summary>
        /// Upload file with conversion.
        /// </summary>
        /// <param name="filePath">Id of the spreadsheet file.</param>
        /// <returns>Inserted file id if successful, null otherwise.</returns>
        public static string DriveUploadWithConversion(string filePath)
        {
            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"
                });

                // Upload file My Report on drive.
                var fileMetadata = new Google.Apis.Drive.v3.Data.File()
                {
                    Name = "My Report",
                    MimeType = "application/vnd.google-apps.spreadsheet"
                };
                FilesResource.CreateMediaUpload request;
                // Create a new drive.
                using (var stream = new FileStream(filePath,
                           FileMode.Open))
                {
                    // Create a new file, with metadata and stream.
                    request = service.Files.Create(
                        fileMetadata, stream, "text/csv");
                    request.Fields = "id";
                    request.Upload();
                }

                var file = request.ResponseBody;
                // Prints the uploaded file id.
                Console.WriteLine("File ID: " + file.Id);
                return file.Id;
            }
            catch (Exception e)
            {
                // TODO(developer) - handle error appropriately
                if (e is AggregateException)
                {
                    Console.WriteLine("Credential Not found");
                }
                else if (e is FileNotFoundException)
                {
                    Console.WriteLine("File not found");
                }
                else
                {
                    throw;
                }
            }
            return null;
        }
    }
}

Dönüşümün kullanılabilir olup olmadığını görmek için dosyayı oluşturmadan önce about kaynağının importFormats dizisini kontrol edin. Desteklenen dönüşümler bu dizide dinamik olarak kullanılabilir. Sık kullanılan bazı içe aktarma biçimleri şunlardır:

Nereden	Alıcı
Microsoft Word, OpenDocument Metni, HTML, RTF, düz metin	Google Dokümanlar
Microsoft Excel, OpenDocument E-tablosu, CSV, TSV, düz metin	Google E-Tablolar
Microsoft PowerPoint, OpenDocument Presentation	Google Slaytlar
JPEG, PNG, GIF, BMP, PDF	Google Dokümanlar (resmi bir dokümana yerleştirir)
Düz metin (özel MIME türü), JSON	Google Apps Komut Dosyası

update isteği sırasında medya yükleyip Dokümanlar, E-Tablolar veya Slaytlar dosyasına dönüştürdüğünüzde dokümanın tüm içeriği değiştirilir.

Bir resmi Dokümanlar'a dönüştürdüğünüzde Drive, resmi metne dönüştürmek için optik karakter tanıma (OCR) özelliğini kullanır. ocrLanguage parametresinde geçerli BCP 47 dil kodunu belirterek OCR algoritmasının kalitesini artırabilirsiniz. Ayıklanan metin, dokümanda yerleştirilmiş resmin yanında görünür.

Dosya yüklemek için önceden oluşturulmuş bir kimlik kullanma

Drive API, kaynakları yüklemek ve oluşturmak için kullanılan önceden oluşturulmuş dosya kimliklerinin listesini almanıza olanak tanır. Yükleme ve dosya oluşturma isteklerinde bu önceden oluşturulmuş kimlikler kullanılabilir. Dosya meta verilerinde id alanını ayarlayın.

Önceden oluşturulmuş kimlikler oluşturmak için oluşturulacak kimlik sayısıyla birlikte files.generateIds işlevini çağırın.

Belirsiz bir sunucu hatası veya zaman aşımı varsa önceden oluşturulmuş kimliklerle yüklemeyi güvenli bir şekilde yeniden deneyebilirsiniz. Dosya başarıyla oluşturulduysa sonraki yeniden denemeler HTTP 409 hatası döndürür ve yinelenen dosyalar oluşturmaz.

Bilinmeyen dosya türleri için dizine eklenebilir metni tanımlama

Kullanıcılar, doküman içeriğini bulmak için Drive kullanıcı arayüzünü kullanabilir. Uygulamanızdaki içerikleri aramak için files.list ve fullText alanını da kullanabilirsiniz. Daha fazla bilgi için Dosya ve klasör arama başlıklı makaleyi inceleyin.

Drive, dosya türünü tanıdığında (metin belgeleri, PDF'ler, metin içeren resimler ve diğer yaygın türler dahil) belgeleri arama için otomatik olarak dizine ekler. Uygulamanız başka türde dosyalar (ör. çizimler, videolar ve kısayollar) kaydediyorsa dosyanın contentHints.indexableText alanına dizine eklenebilir metin sağlayarak keşfedilebilirliği artırabilirsiniz.

Dizinlenebilir metin hakkında daha fazla bilgi için Dosya meta verilerini yönetme başlıklı makaleyi inceleyin.

Dosya verilerini yükle Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

PATCH ve PUT kullanımı

Basit bir yükleme gerçekleştirme

HTTP

Çok parçalı yükleme gerçekleştirme

Java

Python

Node.js

PHP

.NET

HTTP

Devam ettirilebilir yükleme gerçekleştirme

İlk isteği gönderme

HTTP

İçeriği yükleyin

HTTP - tek istek

HTTP - multiple requests

Kesintiye uğrayan yüklemeyi devam ettirme

HTTP

Medya yükleme hatalarını giderme

Google Dokümanlar'a aktarılabilen dosya türleri

Java

Python

Node.js

PHP

.NET

Dosya yüklemek için önceden oluşturulmuş bir kimlik kullanma

Bilinmeyen dosya türleri için dizine eklenebilir metni tanımlama

Dosya verilerini yükle

`PATCH` ve `PUT` kullanımı