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

ज़्यादा से ज़्यादा कितने बदलावों की जानकारी दी जानी चाहिए. सेवा, इस वैल्यू से कम बदलावों की जानकारी दे सकती है.

अगर इसे तय नहीं किया जाता है, तो ज़्यादा से ज़्यादा 100 बदलावों की जानकारी दी जाएगी.

इसकी ज़्यादा से ज़्यादा वैल्यू 1000 है. इससे ज़्यादा वैल्यू डालने पर, इसे 1000 माना जाएगा.

pageToken

string

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

restrictToMyDrive

boolean

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

spaces

string

कॉर्पोरा में क्वेरी करने के लिए, कॉमा से अलग की गई स्पेस की सूची. 'drive' और 'appDataFolder' को वैल्यू के तौर पर इस्तेमाल किया जा सकता है.

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

इस सुविधा का इस्तेमाल बंद कर दिया गया है. इसके बजाय, supportsAllDrives का इस्तेमाल करें.

teamDriveId
(deprecated)

string

इस सुविधा का इस्तेमाल बंद कर दिया गया है. इसके बजाय, driveId का इस्तेमाल करें.

includePermissionsForView

string

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

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

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