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

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