Method: activity.query

ค้นหากิจกรรมที่ผ่านมาใน Google ไดรฟ์

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลง 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โอเปอเรเตอร์ 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

ส่งคืนกิจกรรมสำหรับรายการในไดรฟ์นี้ รูปแบบคือ items/ITEM_ID
ancestorName

string

แสดงผลกิจกรรมสำหรับโฟลเดอร์ในไดรฟ์นี้ รวมถึงรายการย่อยและองค์ประกอบย่อยทั้งหมด รูปแบบคือ items/ITEM_ID

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

ข้อความตอบกลับสำหรับการค้นหากิจกรรมในไดรฟ์

การแสดง 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

วิธีรวบรวมกิจกรรมแต่ละอย่าง หากชุดของกิจกรรมมีความเกี่ยวข้องกัน กิจกรรมเหล่านั้นสามารถรวมกันเป็นกิจกรรมเดียวได้ เช่น นักแสดง 1 คนที่มีการกระทำเดียวกันในเป้าหมายหลายรายการ หรือนักแสดงหลายคนที่มีการกระทำเดียวกันในเป้าหมายเดียว กลยุทธ์จะกำหนดกฎสำหรับกิจกรรมที่เกี่ยวข้อง

การแสดง 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 เดิม คุณสามารถจัดกลุ่มการทำงานที่คล้ายกันที่เกิดขึ้นภายในกรอบเวลาหนึ่งไปยังหลายเป้าหมาย (เช่น การย้ายชุดไฟล์พร้อมกัน) หรือการดำเนินการหลายคน (เช่น ผู้ใช้หลายคนที่แก้ไขรายการเดียวกัน) กฎการจัดกลุ่มสำหรับกลยุทธ์นี้จะใช้กับการดำเนินการแต่ละประเภทโดยเฉพาะ