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

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