Method: files.update

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

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

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

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

इससे पता चलता है कि जवाब में कौनसे अतिरिक्त व्यू की अनुमतियां शामिल करनी हैं. सिर्फ़ 'पब्लिश किया गया' का इस्तेमाल किया जा सकता है.
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

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