Google Drive API की मदद से, File
बनाते या अपडेट करते समय, फ़ाइल का डेटा अपलोड किया जा सकता है. सिर्फ़ मेटाडेटा वाली फ़ाइल, जैसे कि फ़ोल्डर बनाने के तरीके के बारे में जानने के लिए, सिर्फ़ मेटाडेटा वाली फ़ाइलें बनाना लेख पढ़ें.
तीन तरह की फ़ाइलें अपलोड की जा सकती हैं:
सामान्य अपलोड (
uploadType=media
): इस तरह के अपलोड का इस्तेमाल, मेटाडेटा दिए बिना छोटी मीडिया फ़ाइल (पांच एमबी या इससे कम) ट्रांसफ़र करने के लिए करें. आसान तरीके से अपलोड करने के लिए, आसान तरीके से अपलोड करना लेख पढ़ें.मल्टीपार्ट अपलोड (
uploadType=multipart
): "इस तरह के अपलोड का इस्तेमाल, एक ही अनुरोध में छोटी फ़ाइल (पांच एमबी या इससे कम) को मेटाडेटा के साथ ट्रांसफ़र करने के लिए करें. मेटाडेटा में फ़ाइल के बारे में जानकारी होती है. कई हिस्सों में अपलोड करने की सुविधा का इस्तेमाल करने के लिए, कई हिस्सों में अपलोड करने की सुविधा का इस्तेमाल करना लेख पढ़ें.फिर से शुरू किया जा सकने वाला अपलोड (
uploadType=resumable
): इस तरह के अपलोड का इस्तेमाल तब करें, जब फ़ाइलें बड़ी हों (पांच एमबी से ज़्यादा) और नेटवर्क में रुकावट आने की संभावना ज़्यादा हो. जैसे, मोबाइल ऐप्लिकेशन से फ़ाइल बनाते समय. फिर से शुरू किए जा सकने वाले अपलोड, ज़्यादातर ऐप्लिकेशन के लिए भी एक अच्छा विकल्प है. ऐसा इसलिए, क्योंकि ये छोटे फ़ाइलों के लिए भी काम करते हैं. इसके लिए, हर अपलोड पर एक अतिरिक्त एचटीटीपी अनुरोध करना पड़ता है. फिर से अपलोड करने की सुविधा का इस्तेमाल करने के लिए, फिर से अपलोड करने की सुविधा का इस्तेमाल करना लेख पढ़ें.
Google API की क्लाइंट लाइब्रेरी, इनमें से कम से कम एक तरह के अपलोड को लागू करती हैं. हर टाइप का इस्तेमाल करने के बारे में ज़्यादा जानकारी के लिए, क्लाइंट लाइब्रेरी के दस्तावेज़ देखें.
PATCH
बनाम PUT
आपको याद दिला दें कि एचटीटीपी वर्ब PATCH
, फ़ाइल के संसाधन को आंशिक तौर पर अपडेट करने की सुविधा देता है. वहीं, एचटीटीपी वर्ब PUT
, संसाधन को पूरी तरह से बदलने की सुविधा देता है. ध्यान दें कि PUT
, किसी मौजूदा संसाधन में नया फ़ील्ड जोड़ते समय, बड़े बदलाव कर सकता है.
फ़ाइल रिसॉर्स अपलोड करते समय, इन दिशा-निर्देशों का पालन करें:
- फिर से शुरू किए जा सकने वाले अपलोड के शुरुआती अनुरोध के लिए या सामान्य या कई हिस्सों वाले अपलोड के सिर्फ़ एक अनुरोध के लिए, एपीआई रेफ़रंस में दिए गए एचटीटीपी वर्ब का इस्तेमाल करें.
- अनुरोध शुरू होने के बाद, फिर से शुरू किए जा सकने वाले अपलोड के लिए बाद के सभी अनुरोधों के लिए
PUT
का इस्तेमाल करें. ये अनुरोध, कॉन्टेंट अपलोड कर रहे हैं. भले ही, कोई भी तरीका इस्तेमाल किया जा रहा हो.
आसानी से अपलोड करना
आसानी से अपलोड करने के लिए, files
संसाधन पर create
तरीके का इस्तेमाल करें. इसके साथ uploadType=media
का इस्तेमाल करें.
यहां सामान्य तरीके से अपलोड करने का तरीका बताया गया है:
HTTP
POST
क्वेरी पैरामीटर के साथ, तरीके के /upload यूआरआई परPOST
अनुरोध बनाएं:uploadType=media
POST https://www.googleapis.com/upload/drive/v3/files?uploadType=media
फ़ाइल का डेटा, अनुरोध के मुख्य हिस्से में जोड़ें.
ये एचटीटीपी हेडर जोड़ें:
Content-Type
. इसे अपलोड किए जा रहे ऑब्जेक्ट के MIME मीडिया टाइप पर सेट करें.Content-Length
. इसे अपलोड किए गए बाइट की संख्या पर सेट करें. अगर आपने chunked transfer encoding का इस्तेमाल किया है, तो इस हेडर की ज़रूरत नहीं है.
अनुरोध भेजें. अनुरोध पूरा होने पर, सर्वर फ़ाइल के मेटाडेटा के साथ
HTTP 200 OK
स्टेटस कोड दिखाता है. {HTTP}
सामान्य अपलोड करने पर, बुनियादी मेटाडेटा बनाया जाता है. साथ ही, फ़ाइल से कुछ एट्रिब्यूट का अनुमान लगाया जाता है. जैसे, MIME टाइप या modifiedTime
. अगर आपके पास छोटी फ़ाइलें हैं और फ़ाइल का मेटाडेटा ज़रूरी नहीं है, तो सामान्य अपलोड का इस्तेमाल किया जा सकता है.
मल्टीपार्ट अपलोड करना
मल्टीपार्ट अपलोड अनुरोध की मदद से, एक ही अनुरोध में मेटाडेटा और डेटा अपलोड किया जा सकता है. अगर भेजा गया डेटा इतना छोटा है कि कनेक्शन फ़ेल होने पर उसे फिर से अपलोड किया जा सकता है, तो इस विकल्प का इस्तेमाल करें.
मल्टीपार्ट अपलोड करने के लिए, files
संसाधन पर create
तरीके का इस्तेमाल करें. इसके साथ uploadType=multipart
का इस्तेमाल करें.
यहां मल्टीपार्ट अपलोड करने का तरीका बताया गया है:
Java
Python
Node.js
PHP
.NET
HTTP
POST
क्वेरी पैरामीटर के साथ, तरीके के /upload यूआरआई परPOST
अनुरोध बनाएं:uploadType=multipart
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"
जैसी जानकारी दी जा सकती है. get
तरीके को बाद में कॉल करने पर, रीड-ओनली fileExtension
प्रॉपर्टी मिलती है. इसमें name
फ़ील्ड में मूल रूप से बताया गया एक्सटेंशन होता है.
फिर से अपलोड करने की सुविधा का इस्तेमाल करना
फिर से शुरू किए जा सकने वाले अपलोड की मदद से, डेटा ट्रांसफ़र के दौरान कनेक्शन टूट जाने पर, अपलोड की प्रोसेस को फिर से शुरू किया जा सकता है. बड़ी फ़ाइलों को शुरू से अपलोड करने की ज़रूरत नहीं होती. इसलिए, नेटवर्क में गड़बड़ी होने पर, फिर से शुरू किए जा सकने वाले अपलोड से बैंडविथ का इस्तेमाल भी कम किया जा सकता है.
फिर से शुरू किए जा सकने वाले अपलोड तब काम आते हैं, जब आपकी फ़ाइलों के साइज़ में काफ़ी अंतर हो या जब अनुरोधों के लिए समयसीमा तय हो. जैसे, मोबाइल ओएस के बैकग्राउंड टास्क और App Engine के कुछ अनुरोध. अपलोड की प्रोग्रेस बार दिखाने के लिए भी, फिर से शुरू किए जा सकने वाले अपलोड का इस्तेमाल किया जा सकता है.
फिर से अपलोड करने की सुविधा में, ये चरण शामिल होते हैं:
- शुरुआती अनुरोध भेजें और फिर से शुरू किए जा सकने वाले सेशन का यूआरआई पाएं.
- डेटा अपलोड करें और अपलोड की स्थिति को मॉनिटर करें.
- (ज़रूरी नहीं) अगर अपलोड में कोई समस्या आती है, तो अपलोड फिर से शुरू करें.
शुरुआती अनुरोध भेजना
फिर से शुरू किए जा सकने वाले अपलोड की प्रोसेस शुरू करने के लिए, files
संसाधन पर uploadType=resumable
के साथ create
तरीके का इस्तेमाल करें.
HTTP
POST
क्वेरी पैरामीटर के साथ, तरीके के /upload यूआरआई परPOST
अनुरोध बनाएं:uploadType=resumable
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 बाइट की फ़ाइल में पहले 524,288 बाइट (256 x 1024 x 2) अपलोड किए हैं.
अनुरोध भेजें और जवाब को प्रोसेस करें. अगर अपलोड करने का अनुरोध बीच में रुक जाता है या आपको
5xx
जवाब मिलता है, तो अपलोड करने की प्रोसेस फिर से शुरू करें में दिया गया तरीका अपनाएं.फ़ाइल में मौजूद हर चंक के लिए, पहले से चौथे चरण तक की प्रोसेस दोहराएं. रिस्पॉन्स में मौजूद
Range
हेडर का इस्तेमाल करके, यह तय करें कि अगला हिस्सा कहां से शुरू करना है. यह न मान लें कि सर्वर को पिछले अनुरोध में भेजे गए सभी बाइट मिल गए हैं.
पूरी फ़ाइल अपलोड हो जाने पर, आपको 200 OK
या 201 Created
जवाब मिलता है. साथ ही, संसाधन से जुड़ा कोई भी मेटाडेटा मिलता है.
अपलोड होने की प्रक्रिया बीच में रुक जाने पर उसे फिर से शुरू करना
अगर अपलोड करने का अनुरोध, जवाब मिलने से पहले ही बंद हो जाता है या आपको 503
Service Unavailable
जवाब मिलता है, तो आपको अपलोड करने की प्रोसेस फिर से शुरू करनी होगी.
HTTP
अपलोड का स्टेटस जानने के लिए, फिर से शुरू किए जा सकने वाले सेशन के यूआरआई पर एक खाली
PUT
अनुरोध भेजें.Content-Range
हेडर जोड़कर यह बताएं कि फ़ाइल में मौजूद मौजूदा जगह के बारे में जानकारी नहीं है. उदाहरण के लिए, अगर आपकी फ़ाइल का कुल साइज़ 20,00,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 में बदलना हो, ताकि आप इसकी सुविधाओं का फ़ायदा ले सकें.
किसी फ़ाइल को Google Workspace के किसी खास फ़ाइल टाइप में बदलने के लिए, फ़ाइल बनाते समय Google Workspace mimeType
तय करें.
यहां CSV फ़ाइल को Google Workspace शीट में बदलने का तरीका बताया गया है:
Java
Python
Node.js
PHP
.NET
यह देखने के लिए कि कन्वर्ज़न उपलब्ध है या नहीं, फ़ाइल बनाने से पहले about
संसाधन के importFormats
फ़ील्ड की जांच करें. इस कैटगरी में, सहायता वाले कन्वर्ज़न डाइनैमिक तौर पर उपलब्ध होते हैं. इंपोर्ट करने के कुछ सामान्य फ़ॉर्मैट ये हैं:
शुरू होने का समय | To |
---|---|
Microsoft Word, OpenDocument Text, HTML, RTF, सादा टेक्स्ट | Google Docs |
Microsoft Excel, OpenDocument Spreadsheet, CSV, TSV, सादा टेक्स्ट | Google Sheets |
Microsoft PowerPoint, OpenDocument Presentation | 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 की मदद से, पहले से जनरेट किए गए फ़ाइल आईडी की सूची को वापस पाया जा सकता है. इन आईडी का इस्तेमाल, संसाधन बनाने, कॉपी करने, और अपलोड करने के लिए किया जा सकता है. ज़्यादा जानकारी के लिए, अपनी फ़ाइलों के साथ इस्तेमाल करने के लिए आईडी जनरेट करना लेख पढ़ें.
अगर सर्वर से जुड़ी कोई ऐसी गड़बड़ी होती है जिसके बारे में पता नहीं चल पाता या टाइम आउट हो जाता है, तो पहले से जनरेट किए गए आईडी का इस्तेमाल करके, अपलोड करने की प्रोसेस को फिर से शुरू किया जा सकता है. अगर फ़ाइल का ऐक्शन पूरा हो जाता है, तो बाद में किए गए फिर से कोशिश करने पर, 409 Conflict
एचटीटीपी स्टेटस कोड रिस्पॉन्स मिलता है. साथ ही, डुप्लीकेट फ़ाइलें नहीं बनती हैं.
ध्यान दें कि पहले से जनरेट किए गए आईडी, Google Workspace फ़ाइलें बनाने के लिए इस्तेमाल नहीं किए जा सकते. हालांकि, application/vnd.google-apps.drive-sdk
और application/vnd.google-apps.folder
MIME टाइप के लिए इनका इस्तेमाल किया जा सकता है. इसी तरह, Google Workspace फ़ाइल फ़ॉर्मैट में बदलने के लिए किए गए अपलोड भी काम नहीं करते.
ऐसे फ़ाइल टाइप के लिए इंडेक्स किए जा सकने वाले टेक्स्ट को तय करना जिनके बारे में जानकारी नहीं है
उपयोगकर्ता, दस्तावेज़ के कॉन्टेंट को ढूंढने के लिए Drive के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल कर सकते हैं. अपने ऐप्लिकेशन का कॉन्टेंट खोजने के लिए, files
संसाधन पर list
तरीके का इस्तेमाल किया जा सकता है. इसके अलावा, fullText
फ़ील्ड का इस्तेमाल भी किया जा सकता है. ज़्यादा जानकारी के लिए, फ़ाइलें और फ़ोल्डर खोजना लेख पढ़ें.
Drive, दस्तावेज़ों को अपने-आप इंडेक्स करता है, ताकि उन्हें खोजा जा सके. ऐसा तब होता है, जब Drive को फ़ाइल टाइप का पता चलता है. जैसे, टेक्स्ट दस्तावेज़, PDF, टेक्स्ट वाली इमेज, और अन्य सामान्य टाइप. अगर आपका ऐप्लिकेशन अन्य तरह की फ़ाइलें सेव करता है (जैसे कि ड्रॉइंग, वीडियो, और शॉर्टकट), तो उन्हें खोजने में आसानी हो सकती है. इसके लिए, फ़ाइल के contentHints.indexableText
फ़ील्ड में इंडेक्स किया जा सकने वाला टेक्स्ट डालें.
इंडेक्स किए जा सकने वाले टेक्स्ट के बारे में ज़्यादा जानने के लिए, फ़ाइल का मेटाडेटा मैनेज करना लेख पढ़ें.