- คำขอ HTTP
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- ConsolidationStrategy
- NoConsolidation
- แบบเดิม
- ลองใช้งาน
ค้นหากิจกรรมที่ผ่านมาใน Google ไดรฟ์
คำขอ HTTP
POST https://driveactivity.googleapis.com/v2/activity:query
URL ใช้ไวยากรณ์การแปลง gRPC
เนื้อหาของคำขอ
เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้
การแสดง JSON |
---|
{ "consolidationStrategy": { object ( |
ช่อง | |
---|---|
consolidationStrategy |
รายละเอียดเกี่ยวกับวิธีรวมการดำเนินการที่เกี่ยวข้องที่ประกอบกันเป็นกิจกรรม หากไม่ได้ตั้งค่า ระบบจะไม่รวมการดำเนินการที่เกี่ยวข้อง |
pageSize |
จำนวนกิจกรรมขั้นต่ำที่ต้องการในการตอบสนอง เซิร์ฟเวอร์พยายามแสดงผลจำนวนนี้เป็นอย่างน้อย เซิร์ฟเวอร์อาจส่งคืนกิจกรรมน้อยกว่านี้หากมีการตอบสนองบางส่วนพร้อมแล้วก่อนที่คำขอจะหมดเวลา หากไม่ได้ตั้งค่า ระบบจะใช้ค่าเริ่มต้น |
pageToken |
โทเค็นนี้จะระบุหน้าผลลัพธ์ที่จะแสดง ตั้งค่านี้เป็นค่า nextPageToken ที่ส่งคืนจากการค้นหาก่อนหน้าเพื่อรับหน้าผลลัพธ์ต่อไปนี้ หากไม่ได้ตั้งค่า ระบบจะแสดงผลการค้นหาหน้าแรก |
filter |
การกรองรายการที่แสดงผลจากคำขอการค้นหานี้ รูปแบบของสตริงตัวกรองคือชุดนิพจน์ที่ต่อกันด้วย "AND" ที่จะระบุหรือไม่ก็ได้ โดยที่นิพจน์แต่ละรายการจะอยู่ในรูปของ "fieldโอเปอเรเตอร์ value" ช่องที่รองรับ
|
ฟิลด์การรวม key เกณฑ์หลักในการค้นหา ค่าเริ่มต้นคือ ancestorName = items/root หากไม่ได้ระบุคีย์ key ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
itemName |
ส่งคืนกิจกรรมสำหรับรายการในไดรฟ์นี้ รูปแบบคือ |
ancestorName |
แสดงผลกิจกรรมสำหรับโฟลเดอร์ในไดรฟ์นี้ รวมถึงรายการย่อยและองค์ประกอบย่อยทั้งหมด รูปแบบคือ |
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
ข้อความตอบกลับสำหรับการค้นหากิจกรรมในไดรฟ์
การแสดง JSON |
---|
{
"activities": [
{
object ( |
ช่อง | |
---|---|
activities[] |
รายการกิจกรรมที่ส่งคำขอ |
nextPageToken |
โทเค็นสำหรับดึงผลการค้นหาหน้าถัดไป หรือเว้นว่างไว้หากไม่มีผลลัพธ์เพิ่มเติมในรายการ |
ขอบเขตการให้สิทธิ์
ต้องมีขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้
https://www.googleapis.com/auth/drive.activity
https://www.googleapis.com/auth/drive.activity.readonly
โปรดดูข้อมูลเพิ่มเติมที่คู่มือการให้สิทธิ์
ConsolidationStrategy
วิธีรวบรวมกิจกรรมแต่ละอย่าง หากชุดของกิจกรรมมีความเกี่ยวข้องกัน กิจกรรมเหล่านั้นสามารถรวมกันเป็นกิจกรรมเดียวได้ เช่น นักแสดง 1 คนที่มีการกระทำเดียวกันในเป้าหมายหลายรายการ หรือนักแสดงหลายคนที่มีการกระทำเดียวกันในเป้าหมายเดียว กลยุทธ์จะกำหนดกฎสำหรับกิจกรรมที่เกี่ยวข้อง
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ฟิลด์การรวม strategy วิธีรวบรวมกิจกรรมแต่ละอย่าง strategy ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
none |
ระบบจะไม่รวมแต่ละกิจกรรมเข้าด้วยกัน |
legacy |
ระบบจะรวมแต่ละกิจกรรมโดยใช้กลยุทธ์เดิม |
NoConsolidation
กลยุทธ์ที่ไม่มีการรวมกิจกรรมแต่ละรายการเข้าด้วยกัน
รุ่นเดิม
กลยุทธ์ที่รวมกิจกรรมโดยใช้กฎการจัดกลุ่มจาก V1 Activity API เดิม คุณสามารถจัดกลุ่มการทำงานที่คล้ายกันที่เกิดขึ้นภายในกรอบเวลาหนึ่งไปยังหลายเป้าหมาย (เช่น การย้ายชุดไฟล์พร้อมกัน) หรือการดำเนินการหลายคน (เช่น ผู้ใช้หลายคนที่แก้ไขรายการเดียวกัน) กฎการจัดกลุ่มสำหรับกลยุทธ์นี้จะใช้กับการดำเนินการแต่ละประเภทโดยเฉพาะ