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

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