Method: files.create

एक नई फ़ाइल बनाता है.

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

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

ध्यान दें: लिटरल */* वैल्यू के बजाय, 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 ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

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

पैरामीटर
uploadType

string

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

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

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

boolean

समर्थन नहीं होना या रुकना. अब एक से ज़्यादा फ़ोल्डर में फ़ाइलें नहीं बनाई जा सकतीं.
ignoreDefaultVisibility

boolean

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

boolean

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

string

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

boolean

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

boolean

अब सेवा में नहीं है: इसके बजाय supportsAllDrives का इस्तेमाल करें.
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

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