ปิดใช้ เปิดใช้ และลบป้ายกำกับ

หน้านี้จะอธิบายวิธีทำงานเหล่านี้ซึ่งเกี่ยวข้องกับป้ายกำกับ

• ปิดใช้ป้ายกำกับ
• เปิดใช้ป้ายกำกับ
• ลบป้ายกำกับ

ปิดใช้ป้ายกำกับ

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

เมื่อปิดใช้แล้ว ผู้ใช้จะยังคงใช้ป้ายกำกับนี้ผ่าน API ได้ ป้ายกำกับจะยังคงแสดงในตำแหน่งที่มีการใช้อยู่แล้วและในผลการค้นหา คุณลบป้ายกำกับที่ปิดใช้ได้

หากต้องการปิดใช้ป้ายกำกับที่เผยแพร่แล้ว ให้ใช้เมธอด disable ในคอลเล็กชัน labels

คุณยังต้องระบุสิ่งต่อไปนี้ด้วย

• ป้ายกำกับทรัพยากร ที่แสดงถึงป้ายกำกับทุกป้าย โดยมีทรัพยากร Name และ ID ซึ่งเป็นตัวระบุที่ไม่ซ้ำกันทั่วโลกสำหรับป้ายกำกับ

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

ตัวอย่างนี้ใช้ ID เพื่อปิดใช้ป้ายกำกับที่ถูกต้อง

Python

service.labels().disable(
name='labels/ID',
body={
  'use_admin_access': True
}).execute()

Node.js

service.labels.disable({
  'resource': {
    'use_admin_access': true
},
'name': 'labels/ID'
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

ป้ายกำกับมี State เป็น DISABLED และรหัสการแก้ไขของป้ายกำกับจะเพิ่มขึ้น ผู้ใช้ใช้ป้ายกำกับผ่าน API ได้ อย่างไรก็ตาม ป้ายกำกับที่ปิดใช้จะไม่แสดงใน UI เว้นแต่มีการกำหนดค่าพร็อพเพอร์ตี้ showInApply ของเมธอด disabledPolicy

เปิดใช้ป้ายกำกับ

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

หากต้องการเปิดป้ายกำกับที่ปิดใช้ ให้ใช้เมธอด enable

คุณยังต้องระบุสิ่งต่อไปนี้ด้วย

• ป้ายกำกับทรัพยากร ที่แสดงถึงป้ายกำกับทุกป้าย โดยมีทรัพยากร Name และ ID ซึ่งเป็นตัวระบุที่ไม่ซ้ำกันทั่วโลกสำหรับป้ายกำกับ

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

ตัวอย่างนี้ใช้ ID เพื่อเปิดใช้ป้ายกำกับที่ถูกต้อง

Python

service.labels().enable(
name='labels/ID',
body={
  'use_admin_access': True
}).execute()

Node.js

service.labels.enable({
  'resource': {
    'use_admin_access': true
},
'name': 'labels/ID'
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

ป้ายกำกับมี State เป็น PUBLISHED และรหัสการแก้ไขของป้ายกำกับจะเพิ่มขึ้น ผู้ใช้จะดูและติดป้ายกำกับ ให้ไฟล์ผ่าน API ได้

ลบป้ายกำกับ

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

หากต้องการลบป้ายกำกับ คุณต้องปิดใช้ป้ายกำกับก่อนแล้วจึงใช้วิธี delete

คุณยังต้องระบุสิ่งต่อไปนี้ด้วย

• ป้ายกำกับทรัพยากร ที่แสดงถึงป้ายกำกับทุกป้าย โดยมีทรัพยากร Name และ ID ซึ่งเป็นตัวระบุที่ไม่ซ้ำกันทั่วโลกสำหรับป้ายกำกับ

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

ตัวอย่างนี้ใช้ ID เพื่อลบป้ายกำกับที่ถูกต้อง

Python

response = service.labels().delete(
  name='labels/ID',
  useAdminAccess=True).execute()

Node.js

service.labels.delete({
  'name': 'labels/ID',
  'use_admin_access': true
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

ป้ายกำกับมี State เป็น DELETED และรหัสการแก้ไขของป้ายกำกับจะเพิ่มขึ้น ใช้ป้ายกำกับนี้ไม่ได้และระบบจะลบป้ายกำกับออกถาวรในที่สุด ดูข้อมูลเพิ่มเติมได้ที่ วงจรป้ายกำกับ