Method: comments.list

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

ต้องระบุ: ต้องตั้งค่าพารามิเตอร์ fields หากต้องการแสดงผลเฉพาะช่องที่ต้องการ โปรดดูหัวข้อ แสดงผลช่องที่เฉพาะเจาะจง

คำขอ HTTP

GET https://www.googleapis.com/drive/v3/files/{fileId}/comments

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

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

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

string

รหัสของไฟล์

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

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

boolean

ระบุว่าจะรวมความคิดเห็นที่ถูกลบหรือไม่ ความคิดเห็นที่ถูกลบจะไม่มีเนื้อหาเดิม
pageSize

integer

จำนวนความคิดเห็นสูงสุดที่จะแสดง บริการอาจแสดงผลน้อยกว่าค่านี้

หากไม่ระบุ ระบบจะแสดงความคิดเห็นไม่เกิน 20 รายการ

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

string

โทเค็นสำหรับดำเนินการคำขอรายการก่อนหน้าในหน้าถัดไป ควรตั้งค่านี้เป็นค่า "nextPageToken" จากการตอบกลับก่อนหน้า
startModifiedTime

string

ค่าต่ำสุดของ "modifiedTime" สำหรับความคิดเห็นในผลลัพธ์ (วันที่และเวลา RFC 3339)

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

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

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

รายการความคิดเห็นในไฟล์

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

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

object (Comment)

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

string

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

string

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

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

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

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

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