Method: files.update

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

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

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

ध्यान दें: लिटरल */* वैल्यू के बजाय, MIME टाइप डालें. लिटरल */* का इस्तेमाल सिर्फ़ यह बताने के लिए किया जाता है कि किसी भी मान्य MIME टाइप को अपलोड किया जा सकता है.

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

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

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

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

पाथ के पैरामीटर

पैरामीटर
uploadType

string

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

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

  • media - अपलोड करने में आसान. बिना किसी मेटाडेटा के सिर्फ़ मीडिया अपलोड करें.
  • multipart - कई हिस्सों में अपलोड. एक ही अनुरोध में मीडिया और उसका मेटाडेटा, दोनों को अपलोड करें.
  • resumable - फिर से अपलोड किया जा सकता है. कम से कम दो अनुरोधों की सीरीज़ का इस्तेमाल करके, फिर से शुरू किए जा सकने वाले फ़ॉर्मैट में फ़ाइल को अपलोड करें. ऐसा कम से कम दो अनुरोधों की सीरीज़ में किया जाता है, जिसमें मेटाडेटा शामिल हो.
fileId

string

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

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

पैरामीटर
uploadType

string

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

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

  • media - अपलोड करने में आसान. बिना किसी मेटाडेटा के सिर्फ़ मीडिया अपलोड करें.
  • multipart - कई हिस्सों में अपलोड. एक ही अनुरोध में मीडिया और उसका मेटाडेटा, दोनों को अपलोड करें.
  • resumable - फिर से अपलोड किया जा सकता है. कम से कम दो अनुरोधों की सीरीज़ का इस्तेमाल करके, फिर से शुरू किए जा सकने वाले फ़ॉर्मैट में फ़ाइल को अपलोड करें. ऐसा कम से कम दो अनुरोधों की सीरीज़ में किया जाता है, जिसमें मेटाडेटा शामिल हो.
addParents

string

जोड़ने के लिए पैरंट आईडी की कॉमा-सेपरेटेड लिस्ट.

convert
(deprecated)

boolean

अब काम नहीं करता: इस पैरामीटर में कोई फ़ंक्शन नहीं है.

enforceSingleParent
(deprecated)

boolean

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

modifiedDateBehavior

enum (ModifiedDateBehavior)

यह नीति उस व्यवहार को तय करती है जिसमें modifiedDate को अपडेट किया जाता है. यह setModifiedDate को बदल देता है.

newRevision

boolean

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

ocr

boolean

क्या .jpg, .png, .gif या .pdf अपलोड पर OCR की कोशिश की जानी चाहिए.

ocrLanguage

string

अगर ocr सही है, तो इस्तेमाल की जाने वाली भाषा की ओर संकेत करता है. 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

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

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

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