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" (ไม่บังคับ) โดยแต่ละนิพจน์มีรูปแบบเป็น "ฟิลด์ โอเปอเรเตอร์ ค่า"

ฟิลด์ที่รองรับ

  • 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
ฟิลด์ Union 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.
}
ช่อง
ฟิลด์ Union strategy วิธีรวมกิจกรรมแต่ละรายการ strategy ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
none

object (NoConsolidation)

ระบบจะไม่รวมกิจกรรมแต่ละรายการ
legacy

object (Legacy)

ระบบจะรวมกิจกรรมแต่ละรายการโดยใช้กลยุทธ์เดิม

NoConsolidation

ประเภทนี้ไม่มีฟิลด์

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

เดิม

ประเภทนี้ไม่มีฟิลด์

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