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
{
  "items": [
    {
      object (ChildReference)
    }
  ],
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "selfLink": string,
  "nextLink": string
}
ช่อง
items[]

object (ChildReference)

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

nextPageToken

string

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

kind

string

ซึ่งจะdrive#childListเสมอ

etag

string

ETag ของรายการ

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

ต้องใช้ขอบเขต 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

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