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 Operat 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

ประเภทนี้ไม่มีช่อง

กลยุทธ์ที่ไม่มีการรวมกิจกรรมแต่ละรายการ

เดิม

ประเภทนี้ไม่มีช่อง

กลยุทธ์ที่รวมกิจกรรมโดยใช้กฎการจัดกลุ่มจาก Activity API เดิมเวอร์ชัน 1 คุณสามารถจัดกลุ่มการกระทําที่คล้ายกันภายในกรอบเวลาหนึ่งๆ ไว้ในเป้าหมายหลายรายการ (เช่น การย้ายชุดไฟล์พร้อมกัน) หรือผู้ดำเนินการหลายคน (เช่น ผู้ใช้หลายรายแก้ไขรายการเดียวกัน) ได้ กฎการจัดกลุ่มสำหรับกลยุทธ์นี้ใช้เฉพาะกับการดำเนินการแต่ละประเภท