Method: changes.watch

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

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

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

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

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

पैरामीटर
driveId

string

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

includeCorpusRemovals

boolean

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

includeDeleted

boolean

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

includeItemsFromAllDrives

boolean

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

includeSubscribed

boolean

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

includeTeamDriveItems
(deprecated)

boolean

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

maxResults

integer

लौटाए जाने वाले बदलावों की ज़्यादा से ज़्यादा संख्या.

pageToken

string

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

spaces

string

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

startChangeId
(deprecated)

string (int64 format)

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

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

teamDriveId
(deprecated)

string

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

includePermissionsForView

string

इससे पता चलता है कि जवाब में कौनसे अतिरिक्त व्यू की अनुमतियां शामिल करनी हैं. वैल्यू के तौर पर, सिर्फ़ published को इस्तेमाल किया जा सकता है.

includeLabels

string

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

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

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

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

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

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

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

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