- एचटीटीपी अनुरोध
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- इसे आज़माएं!
यह सूची, किसी उपयोगकर्ता या शेयर की गई ड्राइव में किए गए बदलावों की जानकारी देती है.
एचटीटीपी अनुरोध
GET https://www.googleapis.com/drive/v3/changes
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
driveId |
शेयर की गई वह ड्राइव जहां से बदलाव किए जाएंगे. अगर बदलाव के आईडी बताए गए हैं, तो ये 'शेयर की गई ड्राइव' में दिखेंगे; कंबाइंड ड्राइव आईडी का इस्तेमाल करना और आइडेंटिफ़ायर के तौर पर आईडी बदलना. |
includeCorpusRemovals |
अगर अनुरोध के समय, उपयोगकर्ता फ़ाइल को अब भी ऐक्सेस कर सकता है, तो क्या बदलावों में फ़ाइल संसाधन शामिल होना चाहिए. भले ही, बदलावों की सूची से किसी फ़ाइल को हटा दिया गया हो और उसके बाद इस फ़ाइल में कोई बदलाव नहीं किया जाएगा. |
includeItemsFromAllDrives |
'मेरी ड्राइव' और 'शेयर की गई ड्राइव' के आइटम, दोनों को नतीजों में शामिल किया जाना चाहिए या नहीं. |
includeRemoved |
क्या बदलावों को शामिल करना है, जो बताते हैं कि आइटम को बदलावों की सूची से हटा दिया गया है. उदाहरण के लिए, आइटम मिटने से या उनका ऐक्सेस खो जाने से. |
includeTeamDriveItems |
अब काम नहीं करता: इसके बजाय, |
pageSize |
प्रति पेज दिखाए जाने वाले बदलावों की ज़्यादा से ज़्यादा संख्या. |
pageToken |
अगले पेज पर, सूची के पिछले अनुरोध को जारी रखने के लिए टोकन. इसे 'nextPageToken' की वैल्यू पर सेट किया जाना चाहिए पिछले रिस्पॉन्स से या getStartPageToken तरीके से मिले रिस्पॉन्स से. |
restrictToMyDrive |
चुनें कि नतीजों को 'मेरी ड्राइव' की हैरारकी में बदलाव करने पर सीमित करना है या नहीं. ऐसा करने से, ऐप्लिकेशन डेटा फ़ोल्डर या शेयर की गई उन फ़ाइलों में किए गए बदलाव हट जाते हैं जिन्हें 'मेरी ड्राइव' में नहीं जोड़ा गया है. |
spaces |
कॉर्पोरा में क्वेरी करने के लिए स्पेस की कॉमा-सेपरेटेड लिस्ट. इस्तेमाल की जा सकने वाली वैल्यू 'drive' हैं और 'appData Folder' में मिलेगा. |
supportsAllDrives |
अनुरोध करने वाला ऐप्लिकेशन, 'मेरी ड्राइव' और 'शेयर की गई ड्राइव', दोनों के साथ काम करता है या नहीं. |
supportsTeamDrives |
अब काम नहीं करता: इसके बजाय, |
teamDriveId |
अब काम नहीं करता: इसके बजाय, |
includePermissionsForView |
इससे पता चलता है कि रिस्पॉन्स में किस अतिरिक्त व्यू की अनुमतियां शामिल करनी हैं. सिर्फ़ 'पब्लिश किया गया' समर्थित है. |
includeLabels |
जवाब के |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
उपयोगकर्ता के लिए बदलावों की सूची.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
JSON के काेड में दिखाना |
---|
{
"kind": string,
"nextPageToken": string,
"newStartPageToken": string,
"changes": [
{
object ( |
फ़ील्ड | |
---|---|
kind |
इससे पता चलता है कि यह किस तरह का संसाधन है. वैल्यू: तय स्ट्रिंग |
nextPageToken |
बदलावों वाले अगले पेज के लिए पेज टोकन. अगर बदलाव की सूची खत्म हो जाती है, तो यह संख्या मौजूद नहीं होगी. पेज टोकन की समयसीमा खत्म नहीं होती. |
newStartPageToken |
आगे के बदलावों के लिए शुरुआती पेज टोकन. यह सिर्फ़ तब मौजूद होगा, जब मौजूदा बदलावों की सूची खत्म हो चुकी होगी. पेज टोकन की समयसीमा खत्म नहीं होती. |
changes[] |
बदलावों की सूची. अगर NextPageToken में जानकारी अपने-आप भर जाती है, तो हो सकता है कि यह सूची अधूरी हो और नतीजों का एक और पेज फ़ेच किया जाना चाहिए. |
अनुमति के दायरे
इनमें से किसी एक 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
कुछ दायरे पर पाबंदी है. इनका इस्तेमाल करने के लिए, आपके ऐप्लिकेशन को सुरक्षा जांच की ज़रूरत होती है. ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.