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

เอกสารนี้จะอธิบายวิธีทำงานต่อไปนี้ที่เกี่ยวข้องกับป้ายกำกับ

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

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

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

เมื่อปิดใช้แล้ว ผู้ใช้จะยังคงใช้ป้ายกำกับนี้ผ่าน Google Drive Labels API ได้ ป้ายกำกับจะยังคงปรากฏในส่วนที่มีการนำไปใช้แล้วและในผลการค้นหา และสามารถลบป้ายกำกับที่ปิดใช้แล้วได้deleted

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

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

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

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

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีใช้ id ของป้ายกำกับเพื่อปิดใช้ป้ายกำกับที่ถูกต้อง

Python

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

Node.js

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

แทนที่ ID ด้วยรหัสของป้ายกำกับที่จะปิดใช้

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

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

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

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

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

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

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

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีใช้ id ของป้ายกำกับเพื่อเปิดใช้ป้ายกำกับที่ถูกต้อง

Python

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

Node.js

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

แทนที่ ID ด้วยรหัสของป้ายกำกับที่จะเปิดใช้

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

ลบป้ายกำกับ

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

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

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

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

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

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีใช้ id ของป้ายกำกับเพื่อลบป้ายกำกับที่ถูกต้อง

Python

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

Node.js

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

แทนที่ ID ด้วยรหัสของป้ายกำกับที่จะลบ

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