Method: labels.publish

เผยแพร่การเปลี่ยนแปลงฉบับร่างทั้งหมดไปยังป้ายกำกับ เมื่อเผยแพร่แล้ว ป้ายกำกับจะไม่กลับสู่สถานะฉบับร่าง ดูข้อมูลเพิ่มเติมได้ที่ google.apps.drive.labels.v2.Lifecycle

การเผยแพร่ป้ายกำกับจะทำให้มีการแก้ไขที่ได้รับการเผยแพร่ใหม่แล้ว ระบบจะลบการแก้ไขฉบับร่างก่อนหน้านี้ทั้งหมด ระบบจะเก็บการแก้ไขที่เผยแพร่ก่อนหน้าไว้ แต่อาจมีการลบโดยอัตโนมัติตามความจำเป็น

เมื่อเผยแพร่แล้ว ระบบจะไม่อนุญาตให้ทำการเปลี่ยนแปลงบางอย่างอีกต่อไป โดยทั่วไป การเปลี่ยนแปลงใดๆ ที่อาจทำให้ใช้งานไม่ได้หรือทำให้เกิดข้อจำกัดใหม่ๆ สำหรับข้อมูลเมตาที่มีอยู่ซึ่งเกี่ยวข้องกับป้ายกำกับจะถูกปฏิเสธ ตัวอย่างเช่น การเปลี่ยนแปลงต่อไปนี้ที่ทำกับป้ายกำกับจะถูกปฏิเสธหลังจากที่เผยแพร่ป้ายกำกับแล้ว: * คุณไม่สามารถลบป้ายกำกับได้โดยตรง ต้องปิดใช้ก่อนแล้วจึงลบออก * Field.FieldType เปลี่ยนแปลงไม่ได้ * การเปลี่ยนแปลงตัวเลือกการตรวจสอบช่องจะปฏิเสธรายการที่ยอมรับไปก่อนหน้านี้ไม่ได้ * ลดจำนวนรายการสูงสุด

คำขอ HTTP

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

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

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

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

string

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

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

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

boolean

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

writeControl

object (WriteControl)

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

languageCode

string

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

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

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

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

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

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

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