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' और 'appDataFolder' को वैल्यू के तौर पर इस्तेमाल किया जा सकता है.

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

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