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