Method: files.insert

इससे एक नई फ़ाइल डाली जाती है.

इस तरीके में /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 ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

क्वेरी पैरामीटर

पैरामीटर
convert

boolean

इस फ़ाइल को Docs Editors के फ़ॉर्मैट में बदलना है या नहीं.
enforceSingleParent
(deprecated)

boolean

बंद कर दी गई सुविधा: अब एक से ज़्यादा फ़ोल्डर में फ़ाइलें नहीं बनाई जा सकतीं.
ocr

boolean

.jpg, .png, .gif या .pdf फ़ाइलें अपलोड करने पर, ओसीआर की सुविधा का इस्तेमाल करना है या नहीं.
ocrLanguage

string

अगर ओसीआर की सुविधा चालू है, तो इस्तेमाल की जाने वाली भाषा के बारे में सुझाव दिए जाते हैं. मान्य वैल्यू, BCP 47 कोड हैं.
pinned

boolean

अपलोड की गई फ़ाइल के मुख्य वर्शन को पिन करना है या नहीं. किसी फ़ाइल में ज़्यादा से ज़्यादा 200 पिन किए गए वर्शन हो सकते हैं.
supportsAllDrives

boolean

अनुरोध करने वाला ऐप्लिकेशन, 'मेरी ड्राइव' और शेयर की गई ड्राइव, दोनों के साथ काम करता है या नहीं.
supportsTeamDrives
(deprecated)

boolean

बंद कर दिया गया है: इसके बजाय, supportsAllDrives का इस्तेमाल करें.
timedTextLanguage

string

टाइम किया गया टेक्स्ट किस भाषा में है.
timedTextTrackName

string

टाइम किया गया टेक्स्ट ट्रैक का नाम.
uploadType

string

/upload यूआरआई पर अपलोड करने का अनुरोध किस तरह का है. अगर आपको /upload यूआरआई का इस्तेमाल करके डेटा अपलोड करना है, तो यह फ़ील्ड ज़रूरी है. अगर आपको सिर्फ़ मेटाडेटा वाली फ़ाइल बनानी है, तो यह फ़ील्ड ज़रूरी नहीं है. इसके अलावा, यह फ़ील्ड "इस तरीके को आज़माएं" विजेट में नहीं दिखता, क्योंकि विजेट डेटा अपलोड करने की सुविधा के साथ काम नहीं करता.

ये वैल्यू इस्तेमाल की जा सकती हैं:
useContentAsIndexableText

boolean

कॉन्टेंट को इंडेक्स किए जा सकने वाले टेक्स्ट के तौर पर इस्तेमाल करना है या नहीं.
visibility

enum (Visibility)

नई फ़ाइल किसको दिखे. अनुमतियां अब भी पैरंट फ़ोल्डर से इनहेरिट की जाती हैं. यह पैरामीटर सिर्फ़ तब काम का होता है, जब convert=false.
includePermissionsForView

string

इससे यह तय किया जाता है कि जवाब में किस अतिरिक्त व्यू की अनुमतियां शामिल करनी हैं. वैल्यू के तौर पर, सिर्फ़ published को इस्तेमाल किया जा सकता है.
includeLabels

string

जवाब के labelInfo हिस्से में शामिल किए जाने वाले लेबल के आईडी की कॉमा लगाकर अलग की गई सूची.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य भाग में 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

कुछ स्कोप पर पाबंदी है. इसलिए, आपके ऐप्लिकेशन को इनका इस्तेमाल करने से पहले सुरक्षा से जुड़ी जांच करानी होगी. ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.