Method: files.create

इससे नई फ़ाइल बन जाएगी.

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

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

ध्यान दें: लिटरल */* वैल्यू के बजाय, मान्य MIME टाइप डालें. लिटरल */* का इस्तेमाल सिर्फ़ यह बताने के लिए किया जाता है कि कोई भी मान्य MIME टाइप अपलोड किया जा सकता है.

फ़ाइलें अपलोड करने के बारे में ज़्यादा जानने के लिए, फ़ाइल का डेटा अपलोड करना लेख पढ़ें.

files.create का इस्तेमाल करके शॉर्टकट बनाने वाले ऐप्लिकेशन को MIME टाइप application/vnd.google-apps.shortcut की जानकारी देनी होगी.

ऐप्लिकेशन को एपीआई की मदद से फ़ाइलें डालते समय, name प्रॉपर्टी में फ़ाइल एक्सटेंशन की जानकारी देनी चाहिए. उदाहरण के लिए, JPEG फ़ाइल डालने के लिए, मेटाडेटा में "name": "cat.jpg" जैसी कोई जानकारी होनी चाहिए.

इसके बाद के GET अनुरोधों में, रीड-ओनली fileExtension प्रॉपर्टी शामिल होती है. इसमें title प्रॉपर्टी में मूल रूप से बताए गए एक्सटेंशन का इस्तेमाल किया जाता है. जब Google Drive का कोई उपयोगकर्ता किसी फ़ाइल को डाउनलोड करने का अनुरोध करता है या फ़ाइल को सिंक क्लाइंट की मदद से डाउनलोड किया जाता है, तो Drive टाइटल के आधार पर फ़ाइल का पूरा नाम (एक्सटेंशन के साथ) बनाता है. अगर फ़ाइल में एक्सटेंशन नहीं है, तो Drive फ़ाइल के MIME टाइप के आधार पर एक्सटेंशन का पता लगाने की कोशिश करता है.

एचटीटीपी अनुरोध

  • मीडिया अपलोड करने के अनुरोधों के लिए, अपलोड यूआरआई:
    POST https://www.googleapis.com/upload/drive/v3/files
  • सिर्फ़ मेटाडेटा के अनुरोधों के लिए मेटाडेटा यूआरआई:
    POST https://www.googleapis.com/drive/v3/files

यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.

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

पैरामीटर
enforceSingleParent

boolean

समर्थन नहीं होना या रुकना. एक से ज़्यादा फ़ोल्डर में फ़ाइलें बनाने की सुविधा अब उपलब्ध नहीं है.
ignoreDefaultVisibility

boolean

बनाई गई फ़ाइल के लिए, डोमेन की डिफ़ॉल्ट तौर पर दिखने की सेटिंग को अनदेखा करना है या नहीं. डोमेन एडमिन, अपलोड की गई सभी फ़ाइलों को डिफ़ॉल्ट रूप से डोमेन के लिए उपलब्ध कराने का विकल्प चुन सकते हैं. यह पैरामीटर, अनुरोध के लिए उस व्यवहार को बायपास करता है. हालांकि, अनुमतियां अब भी पैरंट फ़ोल्डर से इनहेरिट की जाती हैं.
keepRevisionForever

boolean

नए हेड रिविज़न में 'keepForever' फ़ील्ड सेट करना है या नहीं. यह सिर्फ़ Google Drive में मौजूद, बाइनरी कॉन्टेंट वाली फ़ाइलों पर लागू होता है. फ़ाइल के लिए, सिर्फ़ 200 बदलावों को हमेशा के लिए सेव किया जा सकता है. अगर यह सीमा पूरी हो जाती है, तो पिन किए गए बदलावों को मिटाने की कोशिश करें.
ocrLanguage

string

इमेज इंपोर्ट करने के दौरान, ओसीआर प्रोसेसिंग के लिए भाषा का संकेत (ISO 639-1 कोड).
supportsAllDrives

boolean

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

boolean

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

string

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

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

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

boolean

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

string

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

string

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

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

अनुरोध के मुख्य भाग में File का उदाहरण है.

जवाब का मुख्य भाग

कामयाब रहने पर, जवाब के मुख्य हिस्से में File का एक इंस्टेंस शामिल किया जाता है.

अनुमति के दायरे

इसके लिए, OAuth के इनमें से किसी एक स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file

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