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

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