Method: children.list

แสดงรายการโฟลเดอร์ย่อย

คำขอ HTTP

GET https://www.googleapis.com/drive/v2/files/{folderId}/children

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

พารามิเตอร์เส้นทาง

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

string

รหัสของโฟลเดอร์

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

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

integer

จำนวนรายการย่อยสูงสุดที่จะแสดง

orderBy

string

รายการคีย์การจัดเรียงที่คั่นด้วยคอมมา คีย์ที่ถูกต้องคือ createdDate, folder, lastViewedByMeDate, modifiedByMeDate, modifiedDate, quotaBytesUsed, recency, sharedWithMeDate, starred และ title โดยค่าเริ่มต้น แต่ละคีย์จะจัดเรียงจากน้อยไปมาก แต่สามารถกลับลำดับได้ด้วยแป้นกดร่วม desc ตัวอย่างการใช้งาน: ?orderBy=folder,modifiedDate desc,title โปรดทราบว่าขณะนี้มีข้อจำกัดสำหรับผู้ใช้ที่มีไฟล์ประมาณ 1 ล้านไฟล์ ซึ่งระบบจะไม่สนใจลําดับการจัดเรียงที่ขอ

pageToken

string

โทเค็นหน้าสำหรับเด็ก

q

string

สตริงการค้นหาสำหรับค้นหาเด็ก

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

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

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

รายการไฟล์ย่อยของไฟล์

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

การแสดง JSON
{
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "selfLink": string,
  "nextLink": string,
  "items": [
    {
      object (ChildReference)
    }
  ]
}
ช่อง
nextPageToken

string

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

kind

string

ค่านี้จะมีค่าเป็น drive#childList เสมอ

etag

string

ETag ของรายการ

items[]

object (ChildReference)

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

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

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

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