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