Method: files.update

यह फ़ाइल के मेटाडेटा, कॉन्टेंट या दोनों को अपडेट करता है.

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

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

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

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

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

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

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

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

पाथ पैरामीटर

पैरामीटर
fileId

string

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

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

पैरामीटर
addParents

string

जोड़ने के लिए, माता-पिता के आईडी की कॉमा लगाकर अलग की गई सूची.
enforceSingleParent
(deprecated)

boolean

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

boolean

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

string

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

string

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

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