- एचटीटीपी अनुरोध
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- ConsolidationStrategy
- NoConsolidation
- लेगसी
- इसे आज़माएं!
Google Drive में पिछली गतिविधि के बारे में क्वेरी करें.
एचटीटीपी अनुरोध
POST https://driveactivity.googleapis.com/v2/activity:query
यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में इस तरह का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना |
---|
{ "consolidationStrategy": { object ( |
फ़ील्ड | |
---|---|
consolidationStrategy |
गतिविधि में शामिल मिलती-जुलती कार्रवाइयों को इकट्ठा करने के तरीके के बारे में जानकारी. इस नीति को सेट न करने पर, मिलती-जुलती कार्रवाइयों को एक साथ इकट्ठा नहीं किया जाता. |
pageSize |
रिस्पॉन्स में ज़रूरी गतिविधियों की कम से कम संख्या; सर्वर कम से कम यह संख्या दिखाने की कोशिश करता है. अगर अनुरोध के समय खत्म होने से पहले सर्वर के पास कोई जवाब तैयार नहीं है, तो हो सकता है कि सर्वर कम गतिविधियां दिखाए. इस नीति को सेट न करने पर, डिफ़ॉल्ट वैल्यू का इस्तेमाल किया जाता है. |
pageToken |
टोकन यह पहचान करता है कि नतीजों का कौनसा पेज दिखाना है. नतीजों का अगला पेज पाने के लिए, इसे पिछली क्वेरी से मिले NextPageToken की वैल्यू पर सेट करें. अगर इस नीति को सेट नहीं किया जाता है, तो नतीजों का पहला पेज दिखता है. |
filter |
इस क्वेरी के अनुरोध से मिले आइटम को फ़िल्टर करने की सुविधा. फ़िल्टर स्ट्रिंग का फ़ॉर्मैट, एक्सप्रेशन का एक क्रम होता है. इसे वैकल्पिक "AND" से जोड़ा जाता है. इसमें हर एक्सप्रेशन, "फ़ील्ड ऑपरेटर वैल्यू" के तौर पर होता है. इस्तेमाल किए जा सकने वाले फ़ील्ड:
|
यूनियन फ़ील्ड key . क्वेरी में मुख्य शर्त. अगर कोई कुंजी तय नहीं की गई है, तो ancestorName = items/root डिफ़ॉल्ट होता है. key इनमें से सिर्फ़ एक हो सकता है: |
|
itemName |
Drive में मौजूद इस आइटम के लिए की गई गतिविधियां. फ़ॉर्मैट |
ancestorName |
इस Drive फ़ोल्डर के लिए, गतिविधियों का जवाब दें. साथ ही, सभी चाइल्ड और डिसेंडेंट भी दिखाएं. फ़ॉर्मैट |
जवाब का मुख्य भाग
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
Drive पर की गई गतिविधि के बारे में क्वेरी करने के लिए रिस्पॉन्स मैसेज.
जेएसओएन के काेड में दिखाना |
---|
{
"activities": [
{
object ( |
फ़ील्ड | |
---|---|
activities[] |
अनुरोध की गई गतिविधियों की सूची. |
nextPageToken |
नतीजों का अगला पेज दिखाने के लिए टोकन. अगर सूची में कोई और नतीजा नहीं है, तो इसे खाली छोड़ा जा सकता है. |
अनुमति देने के दायरे
इनमें से कोई एक OAuth स्कोप ज़रूरी है:
https://www.googleapis.com/auth/drive.activity
https://www.googleapis.com/auth/drive.activity.readonly
ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.
ConsolidationStrategy
अलग-अलग गतिविधियों को एक ही जगह पर कैसे इकट्ठा किया जाता है. अगर गतिविधियों का कोई सेट आपस में मिलता-जुलता है, तो उसे मिली-जुली गतिविधि में शामिल किया जा सकता है. जैसे, एक कलाकार कई टारगेट पर एक ही कार्रवाई कर रहा है या एक ही टारगेट पर कई कलाकार एक ही कार्रवाई कर रहे हैं. रणनीति की मदद से गतिविधियों के नियम तय किए जाते हैं.
जेएसओएन के काेड में दिखाना |
---|
{ // Union field |
फ़ील्ड | |
---|---|
यूनियन फ़ील्ड strategy . अलग-अलग गतिविधियों को एक ही जगह पर कैसे इकट्ठा किया जाता है. strategy इनमें से सिर्फ़ एक हो सकता है: |
|
none |
अलग-अलग गतिविधियों को इकट्ठा नहीं किया जाता. |
legacy |
अलग-अलग गतिविधियों को लेगसी रणनीति का इस्तेमाल करके एक साथ जोड़ा जाता है. |
NoConsolidation
एक ऐसी रणनीति जिसमें हर गतिविधि शामिल नहीं होती.
विरासती
ऐसी रणनीति जो लेगसी V1 Activity API के ग्रुपिंग नियमों का इस्तेमाल करके, गतिविधियों को इकट्ठा करती है. किसी विंडो में होने वाली मिलती-जुलती कार्रवाइयों को कई टारगेट (जैसे कि एक साथ फ़ाइलों के सेट को एक जगह से दूसरी जगह ले जाना) या एक से ज़्यादा ऐक्टर (जैसे, एक ही आइटम में बदलाव करने वाले कई उपयोगकर्ता) में ग्रुप किया जा सकता है. इस रणनीति के लिए ग्रुप करने के नियम, हर तरह की कार्रवाई के लिए अलग-अलग होते हैं.