Method: files.listLabels

แสดงป้ายกํากับบนไฟล์

คำขอ HTTP

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

URL ใช้ไวยากรณ์ gRPC Transcoding

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

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

string

รหัสของไฟล์

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

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

integer

จํานวนป้ายกํากับสูงสุดที่จะแสดงต่อหน้าเว็บ เมื่อไม่ได้ตั้งค่า จะมีค่าเริ่มต้นเป็น 100
pageToken

string

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

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

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

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

รายการป้ายกํากับที่ใช้กับไฟล์

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

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

object (Label)

รายการป้ายกํากับ
nextPageToken

string

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

string

นี่เป็น Drive#labelList เสมอ

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

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

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

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