Method: files.insert

नई फ़ाइल डालता है.

यह तरीका, /upload यूआरआई के साथ काम करता है. साथ ही, अपलोड किए गए मीडिया को इन विशेषताओं के साथ स्वीकार करता है:

  • फ़ाइल का साइज़: 5,120 जीबी
  • स्वीकार किए जाने वाले मीडिया एमआईएमई टाइप:*/*

ध्यान दें: लिटरल */* वैल्यू के बजाय, मान्य 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

अगर ocr की वैल्यू 'सही है' है, तो इस्तेमाल की जाने वाली भाषा के बारे में बताएं. मान्य वैल्यू, BCP 47 कोड हैं.
pinned

boolean

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

boolean

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

boolean

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

string

टाइम किए गए टेक्स्ट की भाषा.
timedTextTrackName

string

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

string

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

स्वीकार की जा सकने वाली वैल्यू ये हैं:

  • media - सामान्य अपलोड. सिर्फ़ मीडिया अपलोड करें, बिना किसी मेटाडेटा के.
  • multipart - मल्टीपार्ट अपलोड. एक ही अनुरोध में, मीडिया और उसका मेटाडेटा, दोनों अपलोड करें.
  • resumable - फिर से अपलोड किया जा सकता है. फ़ाइल को फिर से शुरू किया जा सकने वाले तरीके से अपलोड करें. इसके लिए, कम से कम दो अनुरोधों की सीरीज़ का इस्तेमाल करें. पहले अनुरोध में मेटाडेटा शामिल होना चाहिए.
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

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