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.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

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