Method: labels.publish

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

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

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

  • คุณจะลบป้ายกำกับโดยตรงไม่ได้ คุณต้องปิดใช้ก่อน แล้วจึงลบ
  • 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

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