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)

มอบสิทธิ์ในการควบคุมวิธีดำเนินการตามคำขอเขียน ค่าเริ่มต้นคือไม่ได้ตั้งค่า ซึ่งหมายความว่าการเขียนล่าสุดจะชนะ

disabledPolicy

object (DisabledPolicy)

ปิดใช้นโยบายที่จะใช้แล้ว

languageCode

string

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

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

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

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

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

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

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