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
Python
Node.js
PHP
.NET
HTTP
uploadType=multipart
के क्वेरी पैरामीटर के साथ, तरीके के /upload यूआरआई परPOST
अनुरोध बनाएं:POST https://www.googleapis.com/upload/drive/v3/files?uploadType=multipart
अनुरोध का मुख्य हिस्सा बनाएं. मुख्य हिस्सा, कई हिस्सों वाले/मिलते-जुलते कॉन्टेंट टाइप आरएफ़सी 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
फिर से शुरू किए जा सकने वाले सेशन का यूआरआई सेव करें, ताकि आप फ़ाइल का डेटा अपलोड कर सकें और अपलोड की स्थिति के बारे में क्वेरी कर सकें. फिर से शुरू किए जा सकने वाले सेशन का यूआरआई, एक हफ़्ते के बाद खत्म हो जाता है.
अगर आपके पास फ़ाइल का मेटाडेटा है, तो अनुरोध के मुख्य हिस्से में 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 से 2,000,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
Python
Node.js
PHP
.NET
यह देखने के लिए कि कोई कन्वर्ज़न उपलब्ध है या नहीं, फ़ाइल बनाने से पहले about
रिसॉर्स के importFormats
कलेक्शन की जांच करें.
इस्तेमाल किए जा सकने वाले कन्वर्ज़न, इस कलेक्शन में डाइनैमिक तौर पर उपलब्ध होते हैं. डेटा इंपोर्ट करने के लिए, ये सामान्य फ़ॉर्मैट इस्तेमाल किए जा सकते हैं:
शुरू होने का समय | इसके लिए |
---|---|
Microsoft Word, OpenDocument Text, HTML, RTF, सादा टेक्स्ट | 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
फ़ील्ड में इंडेक्स किया जा सकने वाला टेक्स्ट डालकर, फ़ाइल को खोजने लायक बनाया जा सकता है.
इंडेक्स किए जा सकने वाले टेक्स्ट के बारे में ज़्यादा जानकारी के लिए, फ़ाइल का मेटाडेटा मैनेज करना लेख पढ़ें.