Method: files.update

यह किसी फ़ाइल के मेटाडेटा और/या कॉन्टेंट को अपडेट करता है. इस तरीके को कॉल करते समय, सिर्फ़ उस अनुरोध के फ़ील्ड में जानकारी भरें जिसमें आपको बदलाव करना है. फ़ील्ड अपडेट करते समय, कुछ फ़ील्ड अपने-आप बदल सकते हैं, जैसे कि modifiedDate. यह विधि पैच सिमैंटिक का समर्थन करती है.

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

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

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

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

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

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

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

पाथ के पैरामीटर

पैरामीटर
uploadType

string

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

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

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

string

फ़ाइल का आईडी.

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

पैरामीटर
uploadType

string

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

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

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

string

जोड़ने के लिए, पैरंट आईडी की कॉमा-सेपरेटेड लिस्ट.
enforceSingleParent
(deprecated)

boolean

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

boolean

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

string

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

string

हटाने के लिए पैरंट आईडी की कॉमा-सेपरेटेड लिस्ट.
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
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.scripts

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