Method: labels.list

แสดงรายการป้ายกำกับ

คำขอ HTTP

GET https://drivelabels.googleapis.com/v2/labels

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

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

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

boolean

ระบุว่าจะรวมเฉพาะป้ายกำกับที่เผยแพร่ในผลการค้นหาหรือไม่

  • เมื่อ true ระบบจะแสดงเฉพาะการแก้ไขป้ายกำกับที่เผยแพร่ในปัจจุบันเท่านั้น มีป้ายกำกับที่ปิดใช้ ชื่อทรัพยากรป้ายกำกับที่แสดงผลอ้างอิงการแก้ไขที่เผยแพร่ (labels/{id}/{revisionId})
  • เมื่อ false ระบบจะแสดงผลการแก้ไขป้ายกำกับปัจจุบัน ซึ่งอาจไม่ได้เผยแพร่ ชื่อทรัพยากรป้ายกำกับที่แสดงจะไม่อ้างอิงการแก้ไขที่เฉพาะเจาะจง (labels/{id})
customer

string

ลูกค้าที่จะกำหนดขอบเขตคำขอรายการนี้ เช่น "customers/abcd1234" หากไม่ได้ตั้งค่า ระบบจะแสดงป้ายกำกับทั้งหมดภายในลูกค้าปัจจุบัน

languageCode

string

รหัสภาษา BCP-47 ที่จะใช้ในการประเมินป้ายกำกับช่องที่แปล เมื่อไม่ระบุ ระบบจะใช้ค่าในภาษาที่กำหนดค่าไว้เริ่มต้น

pageSize

integer

จำนวนป้ายกำกับสูงสุดที่จะแสดงต่อ 1 หน้า ค่าเริ่มต้น: 50 สูงสุด: 200

pageToken

string

โทเค็นของหน้าเว็บที่จะแสดงผล

view

enum (LabelView)

เมื่อระบุ ระบบจะแสดงผลเฉพาะบางฟิลด์ที่เป็นของข้อมูลพร็อพเพอร์ตี้ที่ระบุ

พารามิเตอร์การรวม access

access ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้

useAdminAccess

boolean

ตั้งค่าเป็น true เพื่อใช้ข้อมูลเข้าสู่ระบบของผู้ดูแลระบบของผู้ใช้ การดำเนินการนี้จะแสดงป้ายกำกับทั้งหมดภายในลูกค้า

minimumRole

enum (LabelRole)

ระบุระดับการเข้าถึงที่ผู้ใช้ต้องมีสำหรับป้ายกำกับที่แสดงผล บทบาทขั้นต่ำที่ผู้ใช้ต้องมีในป้ายกำกับ ค่าเริ่มต้นคือ READER

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

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

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

คำตอบสำหรับการแสดงป้ายกำกับ

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

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

object (Label)

ป้ายกำกับ

nextPageToken

string

โทเค็นของหน้าถัดไปในคำตอบ

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

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

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่คู่มือการให้สิทธิ์