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

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

पैरामीटर
uploadType

string

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

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

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

boolean

क्या इस फ़ाइल को संबंधित दस्तावेज़ संपादक फ़ॉर्मैट में बदलना है.

enforceSingleParent
(deprecated)

boolean

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

ocr

boolean

क्या .jpg, .png, .gif या .pdf अपलोड पर OCR की कोशिश की जानी चाहिए.

ocrLanguage

string

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

pinned

boolean

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

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

अब सेवा में नहीं है: इसके बजाय supportsAllDrives का इस्तेमाल करें.

timedTextLanguage

string

समयबद्ध लेख की भाषा.

timedTextTrackName

string

समयबद्ध लेख ट्रैक नाम.

useContentAsIndexableText

boolean

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

visibility

enum (Visibility)

नई फ़ाइल किसको दिख रही है. यह पैरामीटर सिर्फ़ तब काम करता है, जब conversion=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

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