Method: files.patch

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

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

PATCH 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

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

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

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