Method: changes.watch

इससे किसी उपयोगकर्ता के लिए बदलावों की सदस्यता ली जाती है.

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

POST https://www.googleapis.com/drive/v3/changes/watch

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

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

पैरामीटर
driveId

string

शेयर की गई वह ड्राइव जहां से बदलाव किए जाएंगे. अगर बदलाव के आईडी तय किए गए हैं, तो वे 'शेयर की गई ड्राइव' के हिसाब से भी दिखेंगे. आइडेंटिफ़ायर के तौर पर, मिले-जुले ड्राइव का आईडी और बदलाव आईडी का इस्तेमाल करें.

includeCorpusRemovals

boolean

अगर अनुरोध के समय, उपयोगकर्ता फ़ाइल को अब भी ऐक्सेस कर सकता है, तो क्या बदलावों में फ़ाइल संसाधन शामिल होना चाहिए. भले ही, बदलावों की सूची से किसी फ़ाइल को हटा दिया गया हो और उसके बाद इस फ़ाइल में कोई बदलाव नहीं किया जाएगा.

includeItemsFromAllDrives

boolean

'मेरी ड्राइव' और 'शेयर की गई ड्राइव' के आइटम, दोनों को खोज के नतीजों में शामिल किया जाना चाहिए या नहीं.

includeRemoved

boolean

क्या बदलावों को शामिल करना है, जो बताते हैं कि आइटम को बदलावों की सूची से हटा दिया गया है. उदाहरण के लिए, आइटम मिटने से या उनका ऐक्सेस खो जाने से.

includeTeamDriveItems
(deprecated)

boolean

अब काम नहीं करता: इसके बजाय, includeItemsFromAllDrives का इस्तेमाल करें.

pageSize

integer

प्रति पेज दिखाए जाने वाले बदलावों की ज़्यादा से ज़्यादा संख्या.

pageToken

string

अगले पेज पर, सूची के पिछले अनुरोध को जारी रखने के लिए टोकन. इसे पिछले रिस्पॉन्स में मौजूद 'nextPageToken' की वैल्यू या getStartPageToken तरीके से मिले रिस्पॉन्स पर सेट किया जाना चाहिए.

restrictToMyDrive

boolean

चुनें कि नतीजों को 'मेरी ड्राइव' की हैरारकी में बदलाव करने पर सीमित करना है या नहीं. ऐसा करने से, ऐप्लिकेशन डेटा फ़ोल्डर या शेयर की गई उन फ़ाइलों में किए गए बदलाव हट जाते हैं जिन्हें 'मेरी ड्राइव' में नहीं जोड़ा गया है.

spaces

string

कॉर्पोरा में क्वेरी करने के लिए स्पेस की कॉमा-सेपरेटेड लिस्ट. इसके लिए, 'drive' और 'appData प्रतिनिधित्व' वैल्यू का इस्तेमाल किया जा सकता है.

supportsAllDrives

boolean

अनुरोध करने वाला ऐप्लिकेशन, 'मेरी ड्राइव' और 'शेयर की गई ड्राइव', दोनों के साथ काम करता है या नहीं.

supportsTeamDrives
(deprecated)

boolean

अब काम नहीं करता: इसके बजाय, supportsAllDrives का इस्तेमाल करें.

teamDriveId
(deprecated)

string

अब काम नहीं करता: इसके बजाय, driveId का इस्तेमाल करें.

includePermissionsForView

string

इससे पता चलता है कि रिस्पॉन्स में किस अतिरिक्त व्यू की अनुमतियां शामिल करनी हैं. सिर्फ़ 'पब्लिश की गई टिप्पणियां' इस्तेमाल की जा सकती हैं.

includeLabels

string

जवाब के labelInfo हिस्से में शामिल करने के लिए, लेबल के आईडी की कॉमा-सेपरेटेड लिस्ट.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य भाग में Channel का उदाहरण है.

जवाब का मुख्य भाग

कामयाब रहने पर, जवाब के मुख्य हिस्से में Channel का एक इंस्टेंस शामिल किया जाता है.

अनुमति के दायरे

इनमें से किसी एक 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.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

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