Method: activity.query

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

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

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

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

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

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

जेएसओएन के काेड में दिखाना 
{
  "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 से मिलीसेकंड के हिसाब से या RFC 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 पर की गई गतिविधि के बारे में क्वेरी करने के लिए रिस्पॉन्स मैसेज.

जेएसओएन के काेड में दिखाना 
{
  "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

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

जेएसओएन के काेड में दिखाना 
{

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