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