Method: files.create

कोई फ़ाइल बनाता है. ज़्यादा जानकारी के लिए, फ़ाइलें बनाना और मैनेज करना लेख पढ़ें.

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

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

    (*/* वैल्यू के बजाय, मान्य MIME टाइप बताएं. लिटरल */* का इस्तेमाल सिर्फ़ यह बताने के लिए किया जाता है कि कोई भी मान्य MIME टाइप अपलोड किया जा सकता है. ज़्यादा जानकारी के लिए, Google Workspace और Google Drive के साथ काम करने वाले MIME टाइप देखें.)

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

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

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

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

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

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

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

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

पैरामीटर
enforceSingleParent
(deprecated)

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

इससे यह तय होता है कि जवाब में किस अतिरिक्त व्यू की अनुमतियां शामिल करनी हैं. वैल्यू के तौर पर, सिर्फ़ published को इस्तेमाल किया जा सकता है.
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

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