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.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

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