Method: files.update

• एचटीटीपी अनुरोध
• पाथ पैरामीटर
• क्वेरी पैरामीटर
• अनुरोध का मुख्य हिस्सा
• जवाब का मुख्य हिस्सा
• अनुमति पाने के लिंक
• इसे आज़माएं!

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

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

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

ध्यान दें: लिटरल */* वैल्यू के बजाय, मान्य MIME टाइप डालें. लिटरल */* का इस्तेमाल सिर्फ़ यह बताने के लिए किया जाता है कि कोई भी मान्य 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 ब्लॉब अपलोड करने पर, नया रिविज़न बनाना चाहिए या नहीं. अगर यह फ़ॉल्स है, तो मौजूदा हेड रिविज़न में ब्लॉब डेटा बदल दिया जाता है. अगर यह सही है या सेट नहीं है, तो हेड रिविज़न के तौर पर एक नया ब्लॉब बनाया जाता है. साथ ही, पिन नहीं किए गए पिछले रिविज़न को कुछ समय के लिए सेव रखा जाता है. पिन किए गए बदलावों को हमेशा के लिए सेव किया जाता है. इसके लिए, स्टोरेज के अतिरिक्त कोटे का इस्तेमाल किया जाता है. हालांकि, ज़्यादा से ज़्यादा 200 बदलावों को सेव किया जा सकता है. बदलावों को सेव रखने के तरीके के बारे में जानने के लिए, Drive के सहायता केंद्र पर जाएं.
ocr	boolean .jpg, .png, .gif या .pdf फ़ाइलों पर ओसीआर (ऑप्टिकल कैरेक्टर रिकग्निशन) की सुविधा का इस्तेमाल करना है या नहीं.
ocrLanguage	string अगर ocr की वैल्यू 'सही है' है, तो इस्तेमाल की जाने वाली भाषा के बारे में बताएं. मान्य वैल्यू, BCP 47 कोड हैं.
pinned	boolean नए वर्शन को पिन करना है या नहीं. किसी फ़ाइल में ज़्यादा से ज़्यादा 200 पिन किए गए बदलाव हो सकते हैं.
removeParents	string हटाने के लिए, पैरंट आईडी की कॉमा लगाकर बनाई गई सूची.
setModifiedDate	boolean अनुरोध के मुख्य हिस्से में दी गई वैल्यू का इस्तेमाल करके, बदली गई तारीख सेट करनी है या नहीं. इस फ़ील्ड को true पर सेट करने का मतलब है कि इसे modifiedDateBehavior=fromBodyOrNow पर सेट किया गया है. साथ ही, false को modifiedDateBehavior=now पर सेट करने का मतलब है कि इसे modifiedDateBehavior=fromBodyOrNow पर सेट किया गया है. बदली गई तारीख में कोई बदलाव न हो, इसके लिए modifiedDateBehavior=noChange सेट करें.
supportsAllDrives	boolean अनुरोध करने वाला ऐप्लिकेशन, 'मेरी ड्राइव' और शेयर की गई ड्राइव, दोनों के साथ काम करता है या नहीं.
supportsTeamDrives (deprecated)	boolean इस्तेमाल नहीं किया जा सकता: इसके बजाय, supportsAllDrives का इस्तेमाल करें.
timedTextLanguage	string टाइम किए गए टेक्स्ट की भाषा.
timedTextTrackName	string टाइम किए गए टेक्स्ट ट्रैक का नाम.
updateViewedDate	boolean फ़ाइल को अपडेट करने के बाद, व्यू की तारीख अपडेट करनी है या नहीं.
uploadType	string /upload यूआरआई पर अपलोड करने के अनुरोध का टाइप. अगर /upload यूआरआई के साथ डेटा अपलोड किया जा रहा है, तो यह फ़ील्ड भरना ज़रूरी है. अगर सिर्फ़ मेटाडेटा वाली फ़ाइल बनाई जा रही है, तो इस फ़ील्ड की ज़रूरत नहीं है. इसके अलावा, यह फ़ील्ड "यह तरीका आज़माएं" विजेट में नहीं दिखता, क्योंकि यह विजेट डेटा अपलोड करने की सुविधा के साथ काम नहीं करता. स्वीकार की जा सकने वाली वैल्यू ये हैं: media - सामान्य अपलोड. सिर्फ़ मीडिया अपलोड करें, बिना किसी मेटाडेटा के. multipart - मल्टीपार्ट अपलोड. एक ही अनुरोध में, मीडिया और उसका मेटाडेटा, दोनों अपलोड करें. resumable - फिर से अपलोड किया जा सकता है. फ़ाइल को फिर से शुरू किया जा सकने वाले तरीके से अपलोड करें. इसके लिए, कम से कम दो अनुरोधों की सीरीज़ का इस्तेमाल करें. पहले अनुरोध में मेटाडेटा शामिल होना चाहिए.
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

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