Method: drives.list

แสดงรายการไดรฟ์ที่แชร์ของผู้ใช้

เมธอดนี้ยอมรับพารามิเตอร์ q ซึ่งเป็นคำค้นหาที่รวมข้อความค้นหาอย่างน้อย 1 รายการ ดูข้อมูลเพิ่มเติมได้ที่คู่มือการค้นหาไดรฟ์ที่แชร์

คำขอ HTTP

GET https://www.googleapis.com/drive/v3/drives

URL ใช้ ไวยากรณ์การแปลงรหัส gRPC

พารามิเตอร์การค้นหา

พารามิเตอร์
pageSize

integer

จำนวนไดรฟ์ที่แชร์สูงสุดที่จะแสดง บริการอาจแสดงผลน้อยกว่าค่านี้

หากไม่ระบุ ระบบจะแสดงไดรฟ์ที่แชร์ไม่เกิน 10 รายการ

ค่าสูงสุดคือ 100 หากค่ามากกว่า 100 ระบบจะบังคับให้เป็น 100
pageToken

string

โทเค็นหน้าสำหรับไดรฟ์ที่แชร์
q

string

สตริงการค้นหาสำหรับค้นหาไดรฟ์ที่แชร์
useDomainAdminAccess

boolean

ส่งคำขอในฐานะผู้ดูแลระบบโดเมน หากตั้งค่าเป็น "จริง" ระบบจะแสดงไดรฟ์ที่แชร์ทั้งหมดของโดเมนที่ผู้ส่งคำขอเป็นผู้ดูแลระบบ

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

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

รายการไดรฟ์ที่แชร์

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

การแสดง JSON 
{
  "drives": [
    {
      object (Drive)
    }
  ],
  "nextPageToken": string,
  "kind": string
}
ช่อง
drives[]

object (Drive)

รายการไดรฟ์ที่แชร์ หากมีการป้อนข้อมูลใน nextPageToken แสดงว่ารายการนี้อาจไม่สมบูรณ์และควรดึงข้อมูลหน้าผลลัพธ์เพิ่มเติม
nextPageToken

string

โทเค็นหน้าสำหรับไดรฟ์ที่แชร์หน้าถัดไป ช่องนี้จะไม่มีข้อมูลหากถึงจุดสิ้นสุดของรายการแล้ว หากระบบปฏิเสธโทเค็นไม่ว่าด้วยเหตุผลใดก็ตาม คุณควรทิ้งโทเค็นนั้นและเริ่มการแบ่งหน้าใหม่จากหน้าผลลัพธ์หน้าแรก โดยปกติแล้วโทเค็นหน้าจะมีอายุการใช้งานหลายชั่วโมง อย่างไรก็ตาม หากมีการเพิ่มหรือนำรายการใหม่ออก ผลลัพธ์ที่คาดหวังอาจแตกต่างออกไป
kind

string

ระบุประเภทของทรัพยากร ค่าคือสตริงคงที่ "drive#driveList"

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.readonly

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