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" से जोड़ा जाता है. इसमें हर एक्सप्रेशन, "फ़ील्ड ऑपरेटर वैल्यू" के तौर पर होता है.

इस्तेमाल किए जा सकने वाले फ़ील्ड:

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

    • time > 1452409200000 AND time <= 1492812924310
    • time >= "2016-01-10T01:02:03-05:00"
  • detail.action_detail_case: "इसमें हैं" का इस्तेमाल किया गया है ऑपरेटर (:) और या तो एक वैल्यू या अनुमति वाली कार्रवाई की सूची होती है. इन्हें ब्रैकेट में रखकर, खाली जगह से अलग किया जाता है. किसी नतीजे को रिस्पॉन्स से बाहर रखने के लिए, फ़िल्टर स्ट्रिंग की शुरुआत में हाइफ़न (-) लगाएं. उदाहरण:

    • 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 के ग्रुप के नियमों का इस्तेमाल करके, गतिविधियों को इकट्ठा करती है. किसी समयावधि में होने वाली मिलती-जुलती कार्रवाइयों को कई टारगेट (जैसे, फ़ाइलों के एक सेट को एक साथ एक जगह से दूसरी जगह ले जाना) या कई उपयोगकर्ताओं (जैसे, एक ही आइटम में कई उपयोगकर्ताओं का बदलाव करना) के हिसाब से ग्रुप किया जा सकता है. इस रणनीति को ग्रुप करने के नियम, हर तरह की कार्रवाई के लिए खास होते हैं.