इस पेज का अनुवाद Cloud Translation API से किया गया है.

फ़ाइल डेटा अपलोड करें

Google Drive API का इस्तेमाल करके, File बनाते या अपडेट करते समय, फ़ाइल का डेटा अपलोड किया जा सकता है. सिर्फ़ मेटाडेटा वाली फ़ाइल, जैसे कि फ़ोल्डर बनाने का तरीका जानने के लिए, सिर्फ़ मेटाडेटा वाली फ़ाइलें बनाएं लेख पढ़ें.

तीन तरह के अपलोड किए जा सकते हैं:

सामान्य अपलोड (uploadType=media): मेटाडेटा डाले बिना, छोटी मीडिया फ़ाइल (5 एमबी या उससे कम) को ट्रांसफ़र करने के लिए, अपलोड के इस टाइप का इस्तेमाल करें. सामान्य अपलोड करने के लिए, आसान अपलोड करें देखें.
मल्टीपार्ट अपलोड (uploadType=multipart): "इस अपलोड टाइप का इस्तेमाल करके, एक ही अनुरोध में फ़ाइल के बारे में बताने वाले मेटाडेटा के साथ-साथ, छोटी फ़ाइल (5 एमबी या उससे कम) को ट्रांसफ़र करें. एक से ज़्यादा फ़ाइलें अपलोड करने के लिए, एक से ज़्यादा फ़ाइलें अपलोड करना लेख पढ़ें.
फिर से शुरू किया जा सकने वाला अपलोड (uploadType=resumable): बड़ी फ़ाइलों (5 एमबी से ज़्यादा) और नेटवर्क में रुकावट आने की संभावना होने पर, अपलोड के इस टाइप का इस्तेमाल करें. जैसे, मोबाइल ऐप्लिकेशन से फ़ाइल बनाते समय. फिर से शुरू किया जा सकने वाला अपलोड, ज़्यादातर ऐप्लिकेशन के लिए भी एक अच्छा विकल्प है, क्योंकि ये छोटी फ़ाइलों के लिए भी काम करते हैं. इसके लिए, हर अपलोड के लिए एक अतिरिक्त एचटीटीपी अनुरोध की ज़रूरत होती है. फिर से अपलोड करने की सुविधा का इस्तेमाल करने के लिए, फिर से अपलोड करने की सुविधा का इस्तेमाल करना लेख पढ़ें.

Google API क्लाइंट लाइब्रेरी, इनमें से कम से कम एक अपलोड को लागू करती है. हर टाइप का इस्तेमाल करने के तरीके के बारे में ज़्यादा जानकारी के लिए, क्लाइंट लाइब्रेरी के दस्तावेज़ देखें.

`PATCH` बनाम `PUT` का इस्तेमाल करना

आपको याद दिला दें कि एचटीटीपी वर्ब PATCH, फ़ाइल के संसाधन को कुछ हद तक अपडेट करने की सुविधा देता है, जबकि एचटीटीपी वर्ब PUT, संसाधन को पूरी तरह से बदलने की सुविधा देता है. ध्यान दें कि किसी मौजूदा संसाधन में नया फ़ील्ड जोड़ने पर, PUT बड़े बदलाव कर सकता है.

फ़ाइल संसाधन अपलोड करते समय, इन दिशा-निर्देशों का पालन करें:

फिर से शुरू किए जा सकने वाले अपलोड के शुरुआती अनुरोध के लिए, एपीआई रेफ़रंस में दिए गए एचटीटीपी वर्ब का इस्तेमाल करें. इसके अलावा, एक या उससे ज़्यादा हिस्सों वाले अपलोड के अनुरोध के लिए भी एचटीटीपी वर्ब का इस्तेमाल करें.
अनुरोध शुरू होने के बाद, फिर से शुरू किए जा सकने वाले अपलोड के लिए, सभी अनुरोधों के लिए PUT का इस्तेमाल करें. ये अनुरोध सिर्फ़ कॉन्टेंट अपलोड करते हैं, भले ही किसी दूसरे तरीके का इस्तेमाल किया जा रहा हो.

आसानी से अपलोड करें

आसानी से अपलोड करने के लिए, uploadType=media के साथ files.create का इस्तेमाल करें.

यहां सामान्य अपलोड करने का तरीका बताया गया है:

HTTP

uploadType=media के क्वेरी पैरामीटर के साथ, तरीके के /upload यूआरआई पर POST अनुरोध बनाएं:

POST https://www.googleapis.com/upload/drive/v3/files?uploadType=media
अनुरोध के मुख्य हिस्से में फ़ाइल का डेटा जोड़ें.
ये एचटीटीपी हेडर जोड़ें:
- Content-Type. अपलोड किए जा रहे ऑब्जेक्ट के MIME मीडिया टाइप पर सेट करें.
- Content-Length. अपलोड किए जाने वाले बाइट की संख्या पर सेट करें. अगर आपने चंकी ट्रांसफ़र कोड का इस्तेमाल किया है, तो इस हेडर की ज़रूरत नहीं है.
अनुरोध भेजें. अनुरोध पूरा होने पर सर्वर, फ़ाइल के मेटाडेटा के साथ HTTP 200 OK स्टेटस कोड भी दिखाता है. {HTTP}

सामान्य अपलोड करने पर, बुनियादी मेटाडेटा बन जाता है और फ़ाइल से कुछ एट्रिब्यूट का पता चलता है. जैसे, MIME टाइप या modifiedTime. अगर आपके पास छोटी फ़ाइलें हैं और फ़ाइल का मेटाडेटा ज़रूरी नहीं है, तो सामान्य अपलोड का इस्तेमाल किया जा सकता है.

मल्टीपार्ट अपलोड करना

एक से ज़्यादा हिस्सों में अपलोड करने के अनुरोध की मदद से, एक ही अनुरोध में मेटाडेटा और डेटा अपलोड किया जा सकता है. अगर आपके भेजे गए डेटा का साइज़ इतना छोटा है कि उसे फिर से अपलोड किया जा सकता है, तो इस विकल्प का इस्तेमाल करें.

एक से ज़्यादा हिस्सों में अपलोड करने के लिए, uploadType=multipart के साथ files.create का इस्तेमाल करें.

यहां कई हिस्सों में अपलोड करने का तरीका बताया गया है:

Java

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

GitHub पर देखना

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 पर देखें

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 पर देखें

/**
 * 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 पर देखना

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 पर देखना

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 के क्वेरी पैरामीटर के साथ, तरीके के /upload यूआरआई के लिए POST अनुरोध बनाएं:

POST https://www.googleapis.com/upload/drive/v3/files?uploadType=multipart
अनुरोध का मुख्य हिस्सा बनाएं. मुख्य हिस्से को कई हिस्सों या उससे जुड़े कॉन्टेंट टाइप RFC 2387 के हिसाब से फ़ॉर्मैट करें. इसमें दो हिस्से होते हैं:
- मेटाडेटा. मेटाडेटा पहले होना चाहिए और उसका Content-Type हेडर application/json; charset=UTF-8 पर सेट होना चाहिए. JSON फ़ॉर्मैट में फ़ाइल का मेटाडेटा जोड़ें.
- मीडिया. मीडिया को दूसरे नंबर पर रखना ज़रूरी है. साथ ही, इसमें किसी भी MIME टाइप का Content-Type हेडर होना चाहिए. मीडिया वाले हिस्से में फ़ाइल का डेटा जोड़ें.
हर हिस्से की पहचान सीमा स्ट्रिंग से करें, जिसके पहले दो हाइफ़न होते हैं. इसके अलावा, आखिरी बाउंड्री स्ट्रिंग के बाद दो हाइफ़न जोड़ें.
ये टॉप-लेवल एचटीटीपी हेडर जोड़ें:
- Content-Type. इसे multipart/related पर सेट करें और उस बॉर्डर स्ट्रिंग को शामिल करें जिसका इस्तेमाल, अनुरोध के अलग-अलग हिस्सों की पहचान करने के लिए किया जा रहा है. उदाहरण के लिए: Content-Type: multipart/related; boundary=foo_bar_baz
- Content-Length. इसे अनुरोध के मुख्य हिस्से में मौजूद बाइट की कुल संख्या पर सेट करें.
अनुरोध भेजें.

मेटाडेटा का हिस्सा बनाने या अपडेट करने के लिए, उससे जुड़े डेटा के बिना, स्टैंडर्ड रिसॉर्स एंडपॉइंट पर POST या PATCH अनुरोध भेजें: https://www.googleapis.com/drive/v3/files अगर अनुरोध पूरा हो जाता है, तो सर्वर, फ़ाइल के मेटाडेटा के साथ HTTP 200 OK स्टेटस कोड दिखाता है.

फ़ाइलें बनाते समय, उन्हें फ़ाइल के name फ़ील्ड में फ़ाइल एक्सटेंशन की जानकारी देनी चाहिए. उदाहरण के लिए, फ़ोटो JPEG फ़ाइल बनाते समय, मेटाडेटा में "name": "photo.jpg" जैसा कुछ बताया जा सकता है. files.get के बाद में आने वाले कॉल, सिर्फ़ रीड-ओनली fileExtension प्रॉपर्टी देते हैं, जिसमें मूल रूप से name फ़ील्ड में बताया गया एक्सटेंशन होता है.

फिर से शुरू करने लायक अपलोड करें

फिर से शुरू किया जा सकने वाला अपलोड, डेटा के फ़्लो में रुकावट आने के बाद, अपलोड ऑपरेशन को फिर से शुरू करने की सुविधा देता है. बड़ी फ़ाइलों को फिर से शुरू करके अपलोड करने की सुविधा का इस्तेमाल करने पर, नेटवर्क के बंद होने पर भी आपके बैंडविड्थ के इस्तेमाल में कमी आ सकती है. ऐसा इसलिए, क्योंकि आपको बड़ी फ़ाइलों को फिर से शुरू करके अपलोड करने की सुविधा का इस्तेमाल करने पर, नेटवर्क के बंद होने पर भी आपके बैंडविड्थ के इस्तेमाल में कमी आ सकती है. ऐसा इसलिए, क्योंकि आपको बड़ी फ़ाइलों को फिर से शुरू करके अपलोड करने की सुविधा का इस्तेमाल करने पर, नेटवर्क के बंद होने पर भी आपके बैंडविड्थ के इस्तेमाल में कमी आ सकती है. ऐसा इसलिए, क्योंकि आपको बड़ी फ़ाइलों को फिर से शुरू करके अपलोड करने की सुविधा का इस्तेमाल करने पर, नेटवर्क के बंद होने पर भी आपके बैंडविड्थ के इस्तेमाल में कमी आ सकती है.

फिर से शुरू किए जा सकने वाले अपलोड तब कारगर होते हैं, जब आपकी फ़ाइल का साइज़ काफ़ी अलग हो सकता है या अनुरोधों के लिए एक तय समयसीमा होती है. जैसे, मोबाइल ओएस के बैकग्राउंड से जुड़े टास्क और कुछ App Engine के अनुरोध. फिर से शुरू किए जा सकने वाले अपलोड का इस्तेमाल, उन स्थितियों में भी किया जा सकता है जहां आपको अपलोड का प्रोग्रेस बार दिखाना है.

फिर से अपलोड करने की सुविधा में कई बड़े चरण शामिल होते हैं:

शुरुआती अनुरोध भेजें और फिर से शुरू किए जा सकने वाले सेशन का यूआरआई पाएं.
डेटा अपलोड करें और अपलोड की स्थिति को मॉनिटर करें.
(ज़रूरी नहीं) अगर अपलोड में रुकावट आती है, तो उसे फिर से शुरू करें.

शुरुआती अनुरोध भेजना

फिर से शुरू किया जा सकने वाला अपलोड शुरू करने के लिए, uploadType=resumable के साथ files.create का इस्तेमाल करें.

HTTP

uploadType=resumable के क्वेरी पैरामीटर के साथ, तरीके के /upload यूआरआई के लिए POST अनुरोध बनाएं:

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

अगर अनुरोध पूरा हो जाता है, तो जवाब में 200 OK एचटीटीपी स्टेटस कोड शामिल होता है. इसके अलावा, इसमें एक Location हेडर शामिल होता है, जो फिर से शुरू किए जा सकने वाले सेशन यूआरआई के बारे में बताता है:
```
HTTP/1.1 200 OK
Location: https://www.googleapis.com/upload/drive/v3/files?uploadType=resumable&upload_id=xa298sd_sdlkj2
Content-Length: 0
```
फिर से शुरू किए जा सकने वाले सेशन का यूआरआई सेव करें, ताकि आप फ़ाइल का डेटा अपलोड कर सकें और अपलोड की स्थिति के बारे में क्वेरी कर सकें. फिर से शुरू किए जा सकने वाले सेशन का यूआरआई, एक हफ़्ते के बाद खत्म हो जाता है.

ध्यान दें: किसी मौजूदा फ़ाइल को अपडेट करने के लिए, PUT का इस्तेमाल करें.
अगर आपके पास फ़ाइल का मेटाडेटा है, तो अनुरोध के मुख्य हिस्से में JSON फ़ॉर्मैट में मेटाडेटा जोड़ें. अगर ऐसा नहीं है, तो अनुरोध का मुख्य हिस्सा खाली छोड़ दें.
ये एचटीटीपी हेडर जोड़ें:
- X-Upload-Content-Type. ज़रूरी नहीं. उस फ़ाइल डेटा के MIME टाइप पर सेट करें जिसे बाद के अनुरोधों में ट्रांसफ़र किया जाता है. अगर डेटा का MIME टाइप, मेटाडेटा या इस हेडर में नहीं बताया गया है, तो ऑब्जेक्ट को application/octet-stream. के तौर पर दिखाया जाता है
- X-Upload-Content-Length. ज़रूरी नहीं. इसे फ़ाइल डेटा के बाइट की संख्या पर सेट करें, जिसे बाद के अनुरोधों में ट्रांसफ़र किया जाता है.
- Content-Type. अगर आपके पास फ़ाइल का मेटाडेटा है, तो यह ज़रूरी है. इसे application/json; charset=UTF-8 पर सेट करें.
- Content-Length. अगर डेटा ट्रांसफ़र करने के अलग-अलग हिस्सों को कोड में बदलने का तरीका इस्तेमाल नहीं किया जाता, तो यह ज़रूरी है. इस शुरुआती अनुरोध के मुख्य हिस्से में बाइट की संख्या पर सेट करें.
अनुरोध भेजें. अगर सेशन शुरू करने का अनुरोध पूरा हो जाता है, तो जवाब में एक 200 OK HTTP स्टेटस कोड शामिल होता है. इसके अलावा, रिस्पॉन्स में एक Location हेडर शामिल होता है. यह फिर से शुरू किए जा सकने वाले सेशन यूआरआई के बारे में बताता है. फ़ाइल का डेटा अपलोड करने और अपलोड के स्टेटस के बारे में क्वेरी करने के लिए, फिर से शुरू किए जा सकने वाले सेशन के यूआरआई का इस्तेमाल करें. फिर से शुरू किए जा सकने वाले सेशन का यूआरआई, एक हफ़्ते के बाद खत्म हो जाता है.
फिर से शुरू किए जा सकने वाले सेशन के यूआरएल को कॉपी करें और सेव करें.
कॉन्टेंट अपलोड करना जारी रखें.

कॉन्टेंट अपलोड करना

फिर से शुरू किए जाने वाले सेशन वाली फ़ाइल को अपलोड करने के दो तरीके हैं:

एक अनुरोध में कॉन्टेंट अपलोड करना: इस तरीके का इस्तेमाल तब करें, जब फ़ाइल को एक अनुरोध में अपलोड किया जा सकता हो. ऐसा तब होता है, जब किसी भी अनुरोध के लिए तय समयसीमा न हो या आपको अपलोड की प्रोग्रेस का इंडिकेटर दिखाने की ज़रूरत न हो. यह तरीका सबसे अच्छा है, क्योंकि इसमें कम अनुरोधों की ज़रूरत होती है और इससे परफ़ॉर्मेंस बेहतर होती है.
कॉन्टेंट को कई हिस्सों में अपलोड करें: अगर आपको किसी एक अनुरोध में ट्रांसफ़र किए जाने वाले डेटा की मात्रा कम करनी है, तो इस तरीके का इस्तेमाल करें. अगर अलग-अलग अनुरोधों के लिए तय समयसीमा होती है, तो आपको ट्रांसफ़र किए जाने वाले डेटा को कम करना पड़ सकता है. ऐसा, App Engine के कुछ क्लास के अनुरोधों के लिए हो सकता है. अगर आपको अपलोड की प्रोग्रेस दिखाने के लिए, पसंद के मुताबिक इंडिकेटर देना है, तो यह तरीका भी मददगार है.

एचटीटीपी - एक अनुरोध

फिर से शुरू किए जा सकने वाले सेशन यूआरआई के लिए, PUT अनुरोध बनाएं.
अनुरोध के मुख्य हिस्से में फ़ाइल का डेटा जोड़ें.
Content-Length एचटीटीपी हेडर जोड़ें. इसे फ़ाइल में मौजूद बाइट की संख्या पर सेट करें.
अनुरोध भेजें. अगर अपलोड के अनुरोध में रुकावट आती है या आपको 5xx जवाब मिलता है, तो रुका हुआ अपलोड फिर से शुरू करने का तरीका अपनाएं.

एचटीटीपी - एक से ज़्यादा अनुरोध

फिर से शुरू किए जा सकने वाले सेशन के यूआरआई के लिए PUT अनुरोध बनाएं.
अनुरोध के मुख्य हिस्से में डेटा समूह का डेटा जोड़ें. अपलोड पूरा करने वाले आखिरी चंक को छोड़कर, 256 केबी (256 x 1024 बाइट) के कई हिस्से बनाएं. चंक का साइज़ जितना हो सके उतना बड़ा रखें, ताकि अपलोड तेज़ी से हो.
ये एचटीटीपी हेडर जोड़ें:
- Content-Length. इसे मौजूदा चंक में बाइट की संख्या पर सेट करें.
- Content-Range. अपलोड की गई फ़ाइल में कौनसे बाइट दिखाने हैं, यह सेट करें. उदाहरण के लिए, Content-Range: bytes 0-524287/2000000 से पता चलता है कि आपने 2,000,000 बाइट की फ़ाइल में से पहले 5,24,288 बाइट (256 x 1024 x 2) अपलोड किए हैं.
अनुरोध भेजें और जवाब को प्रोसेस करें. अगर अपलोड का अनुरोध बीच में रुक जाता है या आपको 5xx जवाब मिलता है, तो बीच में रुके हुए अपलोड को फिर से शुरू करने का तरीका अपनाएं.
फ़ाइल में बचे हुए हर चंक के लिए, पहले से चौथे चरण तक दोहराएं. अगले चंक को कहां से शुरू करना है, यह तय करने के लिए रिस्पॉन्स में Range हेडर का इस्तेमाल करें. यह न मानें कि सर्वर को पिछले अनुरोध में भेजे गए सभी बाइट मिले हैं.

जब पूरी फ़ाइल अपलोड हो जाती है, तब आपको 200 OK या 201 Created रिस्पॉन्स मिलता है. साथ ही, संसाधन से जुड़ा मेटाडेटा भी मिलता है.

जो अपलोड पूरा नहीं हुआ उसे फिर से शुरू करें

अगर अपलोड करने का अनुरोध, जवाब देने से पहले ही रद्द कर दिया जाता है या आपको 503 Service Unavailable जवाब मिलता है, तो आपको बिना रुकावट वाले अपलोड को फिर से शुरू करना होगा.

HTTP

अपलोड के स्टेटस का अनुरोध करने के लिए, फिर से शुरू किए जा सकने वाले सेशन यूआरआई के लिए, एक खाली PUT अनुरोध बनाएं.
यह बताने के लिए कि फ़ाइल की मौजूदा जगह की जानकारी नहीं है, Content-Range हेडर जोड़ें. उदाहरण के लिए, अगर आपकी फ़ाइल की कुल लंबाई 2,000,000 बाइट है, तो Content-Range को */2000000 पर सेट करें. अगर आपको फ़ाइल का पूरा साइज़ नहीं पता है, तो Content-Range को */* पर सेट करें.
अनुरोध भेजें.
जवाब को प्रोसेस करना:
- 200 OK या 201 Created रिस्पॉन्स से पता चलता है कि अपलोड हो गया है और आगे कोई कार्रवाई करने की ज़रूरत नहीं है.
- 308 Resume Incomplete रिस्पॉन्स से पता चलता है कि आपको फ़ाइल अपलोड करना जारी रखना होगा.
- 404 Not Found कोड का मतलब है कि अपलोड सेशन की समयसीमा खत्म हो गई है और अपलोड को फिर से शुरू करना होगा.
अगर आपको 308 Resume Incomplete रिस्पॉन्स मिलता है, तो जवाब के Range हेडर को प्रोसेस करें, ताकि यह पता लगाया जा सके कि सर्वर को कितनी बाइट मिली हैं. अगर रिस्पॉन्स में Range हेडर नहीं है, तो इसका मतलब है कि कोई बाइट नहीं मिला है. उदाहरण के लिए, bytes=0-42 का Range हेडर बताता है कि फ़ाइल के पहले 43 बाइट मिल गए हैं और अपलोड करने के लिए अगला चंक, बाइट 44 से शुरू होगा.
अब आपको पता है कि अपलोड को कहां से फिर से शुरू करना है. इसलिए, अगले बाइट से फ़ाइल अपलोड करना जारी रखें. फ़ाइल का कौनसा हिस्सा भेजा गया है, यह बताने के लिए Content-Range हेडर शामिल करें. उदाहरण के लिए, Content-Range: bytes 43-1999999 बताता है कि आपको 44 से 20,00,000 तक बाइट भेजी जाती हैं.

मीडिया अपलोड करने से जुड़ी गड़बड़ियां ठीक करना

मीडिया अपलोड करते समय, गड़बड़ियों को ठीक करने के लिए ये सबसे सही तरीके अपनाएं:

5xx गड़बड़ियों के लिए, अपलोड को फिर से शुरू करें या फिर से कोशिश करें, जो कनेक्शन में आने वाली रुकावटों की वजह से फ़ेल हो जाते हों. 5xx गड़बड़ियों को ठीक करने के बारे में ज़्यादा जानने के लिए, 500, 502, 503, 504 गड़बड़ियां लेख पढ़ें.
403 rate limit गड़बड़ियों के लिए, अपलोड की प्रक्रिया को फिर से शुरू करें. 403 rate limit गड़बड़ियों को मैनेज करने के बारे में ज़्यादा जानकारी के लिए, 403 गड़बड़ी: rateLimitExceeded देखें.
फिर से शुरू किए जा सकने वाले अपलोड के दौरान, 4xx गड़बड़ियों (इसमें 403 भी शामिल है) के लिए, अपलोड को फिर से शुरू करें. इन गड़बड़ियों से पता चलता है कि अपलोड सेशन की समयसीमा खत्म हो गई है. इसलिए, नए सेशन के यूआरआई का अनुरोध करके, इसे फिर से शुरू करना होगा. अपलोड सेशन भी एक हफ़्ते तक कोई गतिविधि न होने पर खत्म हो जाते हैं.

Google Docs में इंपोर्ट करने के टाइप

Drive में कोई फ़ाइल बनाते समय, हो सकता है कि आप उस फ़ाइल को Google Workspace फ़ाइल टाइप, जैसे कि Google Docs या Sheets में बदलना चाहें. उदाहरण के लिए, हो सकता है कि आपको अपने पसंदीदा वर्ड प्रोसेसर से किसी दस्तावेज़ को Docs में बदलना हो, ताकि आप Docs की सुविधाओं का फ़ायदा ले सकें.

किसी फ़ाइल को किसी खास Google Workspace फ़ाइल टाइप में बदलने के लिए, फ़ाइल बनाते समय Google Workspace के mimeType के बारे में बताएं.

यहां CSV फ़ाइल को Google Workspace शीट में बदलने का तरीका बताया गया है:

Java

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

GitHub पर देखना

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 पर देखना

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 पर देखना

/**
 * 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 पर देखना

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 पर देखना

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

कन्वर्ज़न उपलब्ध है या नहीं, यह देखने के लिए फ़ाइल बनाने से पहले about संसाधन का importFormats कलेक्शन देखें. इस्तेमाल किए जा सकने वाले कन्वर्ज़न, इस कलेक्शन में डाइनैमिक तौर पर उपलब्ध होते हैं. इंपोर्ट के कुछ सामान्य फ़ॉर्मैट इस तरह हैं:

शुरू होने का समय	इसके लिए
Microsoft Word, OpenDocument Text, एचटीएमएल, आरटीएफ़, सादा टेक्स्ट	Google Docs
Microsoft Excel, OpenDocument स्प्रेडशीट, CSV, TSV, सादा टेक्स्ट	Google Sheets
Microsoft PowerPoint, OpenDocument प्रज़ेंटेशन	Google Slides
JPEG, PNG, GIF, BMP, PDF	Google Docs (इमेज को दस्तावेज़ में जोड़ता है)
सादा टेक्स्ट (खास MIME टाइप), JSON	Google Apps Script

update अनुरोध के दौरान, Docs, Sheets या Slides फ़ाइल में मीडिया अपलोड करने और उसे बदलने पर, दस्तावेज़ का पूरा कॉन्टेंट बदल जाता है.

जब किसी इमेज को Docs में बदला जाता है, तो Drive उस इमेज को टेक्स्ट में बदलने के लिए, ऑप्टिकल कैरेक्टर रिकग्निशन (ओसीआर) का इस्तेमाल करता है. ocrLanguage पैरामीटर में, लागू होने वाला BCP 47 भाषा कोड डालकर, ओसीआर एल्गोरिदम की क्वालिटी को बेहतर बनाया जा सकता है. निकाला गया टेक्स्ट, दस्तावेज़ में एम्बेड की गई इमेज के बगल में दिखता है.

फ़ाइलें अपलोड करने के लिए, पहले से जनरेट किए गए आईडी का इस्तेमाल करना

Drive API की मदद से, पहले से जनरेट किए गए फ़ाइल आईडी की सूची देखी जा सकती है. इन आईडी का इस्तेमाल, संसाधन अपलोड करने और बनाने के लिए किया जाता है. अपलोड करने और फ़ाइल बनाने के अनुरोध, पहले से जनरेट किए गए इन आईडी का इस्तेमाल कर सकते हैं. फ़ाइल के मेटाडेटा में id फ़ील्ड सेट करें.

पहले से जनरेट किए गए आईडी बनाने के लिए, files.generateIds को कॉल करें. साथ ही, आईडी की संख्या भी डालें.

अगर सर्वर में कोई गड़बड़ी है या टाइम आउट हुआ है, तो पहले से जनरेट किए गए आईडी का इस्तेमाल करके, डेटा को फिर से अपलोड किया जा सकता है. अगर फ़ाइल बन गई है, तो फिर से कोशिश करने पर HTTP 409 गड़बड़ी दिखती है और डुप्लीकेट फ़ाइलें नहीं बनती हैं.

अनजान फ़ाइल टाइप के लिए, इंडेक्स किया जा सकने वाला टेक्स्ट तय करें

उपयोगकर्ता, दस्तावेज़ का कॉन्टेंट ढूंढने के लिए, Drive के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल कर सकते हैं. अपने ऐप्लिकेशन में मौजूद कॉन्टेंट खोजने के लिए, files.list और fullText फ़ील्ड का इस्तेमाल भी किया जा सकता है. ज़्यादा जानकारी के लिए, फ़ाइलें और फ़ोल्डर खोजें लेख पढ़ें.

Drive, फ़ाइल टाइप की पहचान करने के बाद, खोज के लिए दस्तावेज़ों को अपने-आप इंडेक्स करता है. इनमें टेक्स्ट दस्तावेज़, PDF, टेक्स्ट वाली इमेज, और अन्य सामान्य टाइप के दस्तावेज़ शामिल हैं. अगर आपका ऐप्लिकेशन ड्रॉइंग, वीडियो, और शॉर्टकट जैसी अन्य फ़ाइलें सेव करता है, तो फ़ाइल के contentHints.indexableText फ़ील्ड में इंडेक्स किया जा सकने वाला टेक्स्ट डालकर, फ़ाइल को खोजने लायक बनाया जा सकता है.

इंडेक्स किए जा सकने वाले टेक्स्ट के बारे में ज़्यादा जानकारी के लिए, फ़ाइल मेटाडेटा मैनेज करना लेख पढ़ें.

फ़ाइल डेटा अपलोड करें

PATCH बनाम PUT का इस्तेमाल करना

आसानी से अपलोड करें

HTTP

मल्टीपार्ट अपलोड करना

Java

Python

Node.js

PHP

.NET

HTTP

फिर से शुरू करने लायक अपलोड करें

शुरुआती अनुरोध भेजना

HTTP

कॉन्टेंट अपलोड करना

एचटीटीपी - एक अनुरोध

एचटीटीपी - एक से ज़्यादा अनुरोध

जो अपलोड पूरा नहीं हुआ उसे फिर से शुरू करें

HTTP

मीडिया अपलोड करने से जुड़ी गड़बड़ियां ठीक करना

Google Docs में इंपोर्ट करने के टाइप

Java

Python

Node.js

PHP

.NET

फ़ाइलें अपलोड करने के लिए, पहले से जनरेट किए गए आईडी का इस्तेमाल करना

अनजान फ़ाइल टाइप के लिए, इंडेक्स किया जा सकने वाला टेक्स्ट तय करें

`PATCH` बनाम `PUT` का इस्तेमाल करना