Method: labels.disable

ปิดใช้ป้ายกำกับที่เผยแพร่ การปิดใช้ป้ายกำกับจะส่งผลให้มีฉบับที่เผยแพร่ใหม่ซึ่งปิดใช้โดยอิงตามฉบับที่เผยแพร่ในปัจจุบัน หากมีฉบับร่างฉบับแก้ไข ระบบจะสร้างฉบับร่างฉบับแก้ไขใหม่แบบปิดใช้โดยอิงตามฉบับร่างฉบับแก้ไขล่าสุด ระบบจะลบการแก้ไขฉบับร่างเก่าๆ

เมื่อปิดใช้แล้ว ระบบอาจลบป้ายกำกับด้วย labels.delete

คำขอ HTTP

POST https://drivelabels.googleapis.com/v2/{name=labels/*}:disable

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

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

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

string

ต้องระบุ ชื่อทรัพยากรของป้ายกำกับ

เนื้อความของคำขอ

เนื้อความของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON
{
  "updateMask": string,
  "useAdminAccess": boolean,
  "writeControl": {
    object (WriteControl)
  },
  "disabledPolicy": {
    object (DisabledPolicy)
  },
  "languageCode": string
}
ช่อง
updateMask

string (FieldMask format)

ฟิลด์ที่ควรอัปเดต ต้องระบุฟิลด์อย่างน้อย 1 ช่อง ระบบจะนํา disabledPolicy รูทมาใช้โดยปริยายและไม่ควรระบุ คุณใช้ * เพียงตัวเดียวเป็นทางลัดในการอัปเดตทุกช่องได้

useAdminAccess

boolean

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

writeControl

object (WriteControl)

ควบคุมวิธีดำเนินการกับคำขอเขียน ค่าเริ่มต้นคือ "unset" ซึ่งหมายความว่าการเขียนครั้งล่าสุดจะเป็นผู้ชนะ

disabledPolicy

object (DisabledPolicy)

นโยบายที่ปิดใช้

languageCode

string

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

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

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Label

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

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

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

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