- एचटीटीपी अनुरोध
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- इसे आज़माएं!
किसी उपयोगकर्ता या शेयर की गई ड्राइव के बदलावों की सूची बनाता है.
एचटीटीपी अनुरोध
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/docs
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.apps.readonly
https://www.googleapis.com/auth/drive.file
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
कुछ दायरे सीमित हैं. इनका इस्तेमाल करने के लिए, सुरक्षा जांच की ज़रूरत होती है. ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.