- एचटीटीपी अनुरोध
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- इसे आज़माएं!
नई फ़ाइल शामिल करता है.
यह तरीका /upload यूआरआई के साथ काम करता है और अपलोड किए गए मीडिया को इन विशेषताओं के साथ स्वीकार करता है:
- फ़ाइल का ज़्यादा से ज़्यादा साइज़: 5,120 जीबी
- स्वीकार किए गए मीडिया के MIME टाइप:
*/*
ध्यान दें: लिटरल */*
वैल्यू के बजाय, MIME टाइप डालें. लिटरल */*
का इस्तेमाल सिर्फ़ यह बताने के लिए किया जाता है कि किसी भी मान्य MIME टाइप को अपलोड किया जा सकता है.
फ़ाइलें अपलोड करने के बारे में ज़्यादा जानकारी के लिए, फ़ाइल का डेटा अपलोड करें देखें.
files.insert
से शॉर्टकट बनाने वाले ऐप्लिकेशन को MIME टाइप application/vnd.google-apps.shortcut
बताना होगा.
एपीआई की मदद से फ़ाइलें शामिल करते समय, ऐप्लिकेशन को title
प्रॉपर्टी में फ़ाइल एक्सटेंशन तय करना चाहिए. उदाहरण के लिए, JPEG फ़ाइल शामिल करने की कार्रवाई के मेटाडेटा में "title": "cat.jpg"
जैसा कुछ बताया जाना चाहिए.
बाद के GET
अनुरोधों में, रीड-ओनली fileExtension
प्रॉपर्टी शामिल होती है. इसमें वही एक्सटेंशन शामिल होता है जो मूल रूप से title
प्रॉपर्टी में बताया गया है. जब Google Drive इस्तेमाल करने वाला कोई व्यक्ति किसी फ़ाइल को डाउनलोड करने का अनुरोध करता है या उसे सिंक करने वाले क्लाइंट से डाउनलोड करता है, तो Drive, टाइटल के आधार पर पूरा फ़ाइल नाम (एक्सटेंशन के साथ) बनाता है. जिन मामलों में एक्सटेंशन मौजूद नहीं होता है, उनमें Drive, फ़ाइल के MIME टाइप के आधार पर एक्सटेंशन का पता लगाने की कोशिश करता है.
एचटीटीपी अनुरोध
- मीडिया अपलोड करने के अनुरोधों के लिए, यूआरआई अपलोड करें:
POST https://www.googleapis.com/upload/drive/v2/files
- सिर्फ़ मेटाडेटा से जुड़े अनुरोधों के लिए, मेटाडेटा यूआरआई:
POST https://www.googleapis.com/drive/v2/files
यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
uploadType |
ये वैल्यू स्वीकार की जा सकती हैं:
|
convert |
क्या इस फ़ाइल को संबंधित दस्तावेज़ संपादक फ़ॉर्मैट में बदलना है. |
enforceSingleParent |
अब सेवा में नहीं है: एक से ज़्यादा फ़ोल्डर में फ़ाइलें नहीं बनाई जा सकतीं. |
ocr |
क्या .jpg, .png, .gif या .pdf अपलोड पर OCR की कोशिश की जानी चाहिए. |
ocrLanguage |
अगर ocr सही है, तो इस्तेमाल की जाने वाली भाषा की ओर संकेत करता है. BCP 47 कोड मान्य वैल्यू हैं. |
pinned |
अपलोड की गई फ़ाइल के हेड संशोधन को पिन करना है या नहीं. किसी फ़ाइल में, पिन किए गए ज़्यादा से ज़्यादा 200 बदलाव हो सकते हैं. |
supportsAllDrives |
अनुरोध किया गया ऐप्लिकेशन, 'मेरी ड्राइव' और 'शेयर की गई ड्राइव', दोनों के साथ काम करता है या नहीं. |
supportsTeamDrives |
अब सेवा में नहीं है: इसके बजाय |
timedTextLanguage |
समयबद्ध लेख की भाषा. |
timedTextTrackName |
समयबद्ध लेख ट्रैक नाम. |
useContentAsIndexableText |
क्या कॉन्टेंट को इंडेक्स किए जा सकने वाले टेक्स्ट के तौर पर इस्तेमाल करना है. |
visibility |
नई फ़ाइल किसको दिख रही है. यह पैरामीटर सिर्फ़ तब काम करता है, जब conversion=false हो. |
includePermissionsForView |
इससे पता चलता है कि जवाब में कौनसे अतिरिक्त व्यू की अनुमतियां शामिल करनी हैं. वैल्यू के तौर पर, सिर्फ़ |
includeLabels |
जवाब के |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य भाग में File
का उदाहरण है.
जवाब का मुख्य भाग
कामयाब रहने पर, जवाब के मुख्य हिस्से में File
का एक इंस्टेंस शामिल किया जाता है.
अनुमति देने के दायरे
इनमें से कोई एक OAuth स्कोप ज़रूरी है:
https://www.googleapis.com/auth/docs
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.apps.readonly
https://www.googleapis.com/auth/drive.file
कुछ दायरे सीमित हैं. इनका इस्तेमाल करने के लिए, सुरक्षा जांच की ज़रूरत होती है. ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.