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