- एचटीटीपी अनुरोध
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- इसे आज़माएं!
यह सूची, किसी उपयोगकर्ता या शेयर की गई ड्राइव में किए गए बदलावों की जानकारी देती है.
एचटीटीपी अनुरोध
GET https://www.googleapis.com/drive/v2/changes
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
क्वेरी पैरामीटर
| पैरामीटर | |
|---|---|
driveId |
शेयर की गई वह ड्राइव जहां से बदलाव किए जाएंगे. अगर बदलाव के आईडी तय किए गए हैं, तो वे 'शेयर की गई ड्राइव' के हिसाब से भी दिखेंगे. आइडेंटिफ़ायर के तौर पर, मिले-जुले ड्राइव का आईडी और बदलाव आईडी का इस्तेमाल करें. |
includeCorpusRemovals |
अगर अनुरोध के समय, उपयोगकर्ता फ़ाइल को अब भी ऐक्सेस कर सकता है, तो क्या बदलावों में फ़ाइल संसाधन शामिल होना चाहिए. भले ही, बदलावों की सूची से किसी फ़ाइल को हटा दिया गया हो और उसके बाद इस फ़ाइल में कोई बदलाव नहीं किया जाएगा. |
includeDeleted |
क्या बदलावों को शामिल करना है, जो बताते हैं कि आइटम को बदलावों की सूची से हटा दिया गया है. उदाहरण के लिए, आइटम मिटने से या उनका ऐक्सेस खो जाने से. |
includeItemsFromAllDrives |
'मेरी ड्राइव' और 'शेयर की गई ड्राइव' के आइटम, दोनों को खोज के नतीजों में शामिल किया जाना चाहिए या नहीं. |
includeSubscribed |
क्या नतीजे में 'मेरी ड्राइव' की हैरारकी से बाहर के बदलावों को शामिल करना है. अगर नीति को 'गलत है' पर सेट किया जाता है, तो नतीजों में से उन फ़ाइलों में बदलाव नहीं किया जा सकता जो 'ऐप्लिकेशन डेटा' फ़ोल्डर या शेयर की गई उन फ़ाइलों में मौजूद हैं जिन्हें 'मेरी ड्राइव' में नहीं जोड़ा गया है. |
includeTeamDriveItems |
अब काम नहीं करता: इसके बजाय, |
maxResults |
दिए जाने वाले बदलावों की ज़्यादा से ज़्यादा संख्या. |
pageToken |
अगले पेज पर, सूची के पिछले अनुरोध को जारी रखने के लिए टोकन. इसे पिछले रिस्पॉन्स में मौजूद |
spaces |
क्वेरी करने के लिए स्पेस की कॉमा-सेपरेटेड लिस्ट. |
startChangeId |
अब काम नहीं करता: इसके बजाय, |
supportsAllDrives |
अनुरोध करने वाला ऐप्लिकेशन, 'मेरी ड्राइव' और 'शेयर की गई ड्राइव', दोनों के साथ काम करता है या नहीं. |
supportsTeamDrives |
अब काम नहीं करता: इसके बजाय, |
teamDriveId |
अब काम नहीं करता: इसके बजाय, |
includePermissionsForView |
इससे पता चलता है कि रिस्पॉन्स में किस अतिरिक्त व्यू की अनुमतियां शामिल करनी हैं. सिर्फ़ |
includeLabels |
जवाब के |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
उपयोगकर्ता के लिए बदलावों की सूची.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
| जेएसओएन के काेड में दिखाना |
|---|
{
"largestChangeId": string,
"nextPageToken": string,
"kind": string,
"etag": string,
"newStartPageToken": string,
"selfLink": string,
"nextLink": string,
"items": [
{
object ( |
| फ़ील्ड | |
|---|---|
largestChangeId |
मौजूदा सबसे बड़ा बदलाव आईडी. |
nextPageToken |
बदलावों वाले अगले पेज के लिए पेज टोकन. अगर बदलाव की सूची खत्म हो जाती है, तो यह संख्या मौजूद नहीं होगी. अगर टोकन किसी वजह से अस्वीकार हो जाता है, तो उसे खारिज कर देना चाहिए. साथ ही, नतीजों के पहले पेज से पेज नंबर डालना फिर से शुरू करना चाहिए. |
kind |
यह हमेशा |
etag |
सूची का ETag. |
newStartPageToken |
आगे के बदलावों के लिए शुरुआती पेज टोकन. यह सिर्फ़ तब मौजूद होगा, जब मौजूदा बदलावों की सूची खत्म हो चुकी होगी. |
selfLink |
इस सूची पर वापस जाने के लिए लिंक. |
nextLink |
बदलावों के अगले पेज का लिंक. |
items[] |
बदलावों की सूची. अगर NextPageToken में जानकारी अपने-आप भर जाती है, तो हो सकता है कि यह सूची अधूरी हो और नतीजों का एक और पेज फ़ेच किया जाना चाहिए. |
अनुमति के दायरे
इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:
https://www.googleapis.com/auth/docshttps://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/drive.appdatahttps://www.googleapis.com/auth/drive.apps.readonlyhttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/drive.meet.readonlyhttps://www.googleapis.com/auth/drive.metadatahttps://www.googleapis.com/auth/drive.metadata.readonlyhttps://www.googleapis.com/auth/drive.photos.readonlyhttps://www.googleapis.com/auth/drive.readonly
कुछ दायरे पर पाबंदी है. इनका इस्तेमाल करने के लिए, आपके ऐप्लिकेशन को सुरक्षा जांच की ज़रूरत होती है. ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.