Method: activity.query

Google Drive में की गई पिछली गतिविधि के बारे में क्वेरी करना.

एचटीटीपी अनुरोध

POST https://driveactivity.googleapis.com/v2/activity:query

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य भाग में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना 
{
  "consolidationStrategy": {
    object (ConsolidationStrategy)
  },
  "pageSize": integer,
  "pageToken": string,
  "filter": string,

  // Union field key can be only one of the following:
  "itemName": string,
  "ancestorName": string
  // End of list of possible types for union field key.
}
फ़ील्ड
consolidationStrategy

object (ConsolidationStrategy)

गतिविधि में शामिल मिलती-जुलती कार्रवाइयों को एक साथ ग्रुप करने के तरीके के बारे में जानकारी. अगर इसे सेट नहीं किया जाता है, तो मिलती-जुलती कार्रवाइयों को एक साथ नहीं रखा जाता.
pageSize

integer

जवाब में कम से कम इतनी गतिविधियां होनी चाहिए; सर्वर कम से कम इतनी गतिविधियां दिखाने की कोशिश करता है. अनुरोध के टाइम आउट होने से पहले, सर्वर कुछ गतिविधियों का जवाब भी दे सकता है. अगर यह सेट नहीं है, तो डिफ़ॉल्ट वैल्यू का इस्तेमाल किया जाता है.
pageToken

string

इस टोकन से यह पता चलता है कि नतीजों का कौनसा पेज दिखाना है. नतीजों का अगला पेज पाने के लिए, इसे पिछली क्वेरी से मिली nextPageToken वैल्यू पर सेट करें. अगर यह नीति सेट नहीं है, तो नतीजों का पहला पेज दिखता है.
filter

string

इस क्वेरी के अनुरोध से मिले आइटम के लिए फ़िल्टर करने की सुविधा. फ़िल्टर स्ट्रिंग का फ़ॉर्मैट, एक्सप्रेशन का एक क्रम होता है. इसे "AND" से जोड़ा जाता है. हर एक्सप्रेशन "field operator value" के फ़ॉर्मैट में होता है.

इन फ़ील्ड के लिए यह सुविधा उपलब्ध है:

  • time: यह फ़ंक्शन, तारीख की वैल्यू पर संख्या वाले ऑपरेटर का इस्तेमाल करता है. यह वैल्यू, 1 जनवरी, 1970 से मिलीसेकंड के हिसाब से या RFC 3339 फ़ॉर्मैट में होती है. उदाहरण:

    • time > 1452409200000 AND time <= 1492812924310
    • time >= "2016-01-10T01:02:03-05:00"

  • detail.action_detail_case: इसमें "has" ऑपरेटर (:) का इस्तेमाल किया जाता है. साथ ही, इसमें एक वैल्यू या अनुमति वाले ऐक्शन टाइप की सूची का इस्तेमाल किया जाता है. इस सूची को कोष्ठक में रखा जाता है और इसमें मौजूद वैल्यू को स्पेस से अलग किया जाता है. किसी नतीजे को जवाब में शामिल न करने के लिए, फ़िल्टर स्ट्रिंग की शुरुआत में हाइफ़न (-) लगाएं. उदाहरण:

    • detail.action_detail_case:RENAME
    • detail.action_detail_case:(CREATE RESTORE)
    • -detail.action_detail_case:MOVE
यूनियन फ़ील्ड key. क्वेरी में मौजूद मुख्य शर्त. अगर कोई कुंजी नहीं दी गई है, तो डिफ़ॉल्ट वैल्यू ancestorName = items/root होती है. key इनमें से सिर्फ़ एक हो सकता है:
itemName

string

Drive में मौजूद इस आइटम से जुड़ी गतिविधियां दिखाता है. फ़ॉर्मैट items/ITEM_ID है.
ancestorName

string

इस Drive फ़ोल्डर के साथ-साथ, इसके सभी चाइल्ड और डिसेंडेंट फ़ोल्डर की गतिविधियां दिखाएं. फ़ॉर्मैट items/ITEM_ID है.

जवाब का मुख्य भाग

Drive में की गई गतिविधि के बारे में क्वेरी करने पर मिलने वाला जवाब.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON के काेड में दिखाना 
{
  "activities": [
    {
      object (DriveActivity)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
activities[]

object (DriveActivity)

जिस गतिविधि का अनुरोध किया गया है उसकी सूची.
nextPageToken

string

नतीजों का अगला पेज पाने के लिए टोकन. अगर सूची में और नतीजे नहीं हैं, तो यह खाली होता है.

अनुमति के स्कोप

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/drive.activity
  • https://www.googleapis.com/auth/drive.activity.readonly

ज़्यादा जानकारी के लिए, अनुमति पाने से जुड़ी गाइड देखें.

ConsolidationStrategy

अलग-अलग गतिविधियों को एक साथ कैसे जोड़ा जाता है. अगर गतिविधियों का कोई सेट एक-दूसरे से जुड़ा है, तो उन्हें एक साथ मिलाकर एक गतिविधि में शामिल किया जा सकता है. जैसे, एक ही व्यक्ति का कई टारगेट पर एक जैसी कार्रवाई करना या कई लोगों का एक ही टारगेट पर एक जैसी कार्रवाई करना. रणनीति में उन गतिविधियों के लिए नियम तय किए जाते हैं जिनसे यह जुड़ी होती है.

JSON के काेड में दिखाना 
{

  // Union field strategy can be only one of the following:
  "none": {
    object (NoConsolidation)
  },
  "legacy": {
    object (Legacy)
  }
  // End of list of possible types for union field strategy.
}
फ़ील्ड
यूनियन फ़ील्ड strategy. अलग-अलग गतिविधियों को एक साथ कैसे जोड़ा जाता है. strategy इनमें से सिर्फ़ एक हो सकता है:
none

object (NoConsolidation)

अलग-अलग गतिविधियों को एक साथ नहीं जोड़ा जाता.
legacy

object (Legacy)

लेगसी रणनीति का इस्तेमाल करके, अलग-अलग गतिविधियों को एक साथ जोड़ा जाता है.

NoConsolidation

इस टाइप में कोई फ़ील्ड नहीं है.

यह ऐसी रणनीति है जिसमें अलग-अलग गतिविधियों को एक साथ नहीं जोड़ा जाता.

लेगेसी

इस टाइप में कोई फ़ील्ड नहीं है.

यह एक ऐसी रणनीति है जो लेगसी V1 Activity API के ग्रुपिंग नियमों का इस्तेमाल करके गतिविधियों को एक साथ जोड़ती है. एक तय समय में होने वाली मिलती-जुलती कार्रवाइयों को कई टारगेट (जैसे, एक साथ कई फ़ाइलें ट्रांसफ़र करना) या कई उपयोगकर्ताओं (जैसे, कई उपयोगकर्ताओं का एक ही आइटम में बदलाव करना) के हिसाब से ग्रुप किया जा सकता है. इस रणनीति के लिए ग्रुप बनाने के नियम, हर तरह की कार्रवाई के हिसाब से अलग-अलग होते हैं.