Method: drives.list

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

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

คำขอ HTTP

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

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

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

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

integer

จำนวนไดรฟ์ที่แชร์สูงสุดที่จะแสดงต่อ 1 หน้า

pageToken

string

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

q

string

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

useDomainAdminAccess

boolean

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

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

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

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

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

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

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

string

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

kind

string

ระบุว่าทรัพยากรนี้เป็นประเภทใด ค่า: สตริงคงที่ "drive#driveList"

drives[]

object (Drive)

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

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

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

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

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