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

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

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

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

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

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