Method: files.update

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

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

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

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

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

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

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

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

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

पाथ पैरामीटर

पैरामीटर
fileId

string

अपडेट की जाने वाली फ़ाइल का आईडी.

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

पैरामीटर
addParents

string

जोड़े जाने वाले पैरंट आईडी की सूची, जिसमें कॉमा लगाकर आईडी को अलग-अलग किया गया है.
convert
(deprecated)

boolean

इस्तेमाल बंद कर दिया गया है: इस पैरामीटर का कोई फ़ंक्शन नहीं है.
enforceSingleParent
(deprecated)

boolean

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

enum (ModifiedDateBehavior)

इस कुकी से यह तय होता है कि modifiedDate को किस तरह से अपडेट किया जाएगा. इससे setModifiedDate सेटिंग बदल जाएगी.
newRevision

boolean

क्या बड़ी फ़ाइल अपलोड करने पर, नया वर्शन बनाया जाना चाहिए. अगर यह वैल्यू गलत है, तो मौजूदा हेड रिवीजन में मौजूद BLOB डेटा बदल दिया जाता है. अगर इस फ़ील्ड की वैल्यू 'सही' पर सेट की जाती है या इसे सेट नहीं किया जाता है, तो हेड वर्शन के तौर पर एक नया ब्लॉब बनाया जाता है. साथ ही, अनपिन किए गए पिछले वर्शन को कुछ समय के लिए सुरक्षित रखा जाता है. पिन किए गए वर्शन को हमेशा के लिए सेव किया जाता है. इसके लिए, अतिरिक्त स्टोरेज कोटे का इस्तेमाल किया जाता है. ज़्यादा से ज़्यादा 200 वर्शन पिन किए जा सकते हैं. बदलावों को सेव रखने के तरीके के बारे में जानने के लिए, Drive के सहायता केंद्र पर जाएं.
ocr

boolean

.jpg, .png, .gif या .pdf फ़ाइलें अपलोड करने पर, ओसीआर की सुविधा का इस्तेमाल करना है या नहीं.
ocrLanguage

string

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

boolean

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

string

हटाए जाने वाले पैरंट आईडी की कॉमा लगाकर अलग की गई सूची.
setModifiedDate

boolean

क्या अनुरोध के मुख्य हिस्से में दी गई वैल्यू का इस्तेमाल करके, तारीख में बदलाव करना है. इस फ़ील्ड को true पर सेट करने का मतलब modifiedDateBehavior=fromBodyOrNow है. वहीं, false पर सेट करने का मतलब modifiedDateBehavior=now है. बदलाव की तारीख में किए गए किसी भी बदलाव को रोकने के लिए modifiedDateBehavior=noChange.
supportsAllDrives

boolean

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

boolean

बंद कर दिया गया है: इसके बजाय, supportsAllDrives का इस्तेमाल करें.
timedTextLanguage

string

टाइम किए गए टेक्स्ट की भाषा.
timedTextTrackName

string

टाइम किया गया टेक्स्ट ट्रैक का नाम.
updateViewedDate

boolean

फ़ाइल को अपडेट करने के बाद, व्यू की तारीख को अपडेट करना है या नहीं.
uploadType

string

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

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

boolean

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

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