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

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

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

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

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

เมื่อปิดใช้แล้ว ผู้ใช้จะยังคงใช้ป้ายกำกับนี้ผ่าน 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 และรหัสการแก้ไขของป้ายกํากับจะเพิ่มขึ้น ระบบจะใช้ป้ายกำกับไม่ได้และระบบจะลบป้ายกำกับที่ลบไปแล้วในท้ายที่สุด ดูข้อมูลเพิ่มเติมได้ที่วงจรป้ายกำกับ