ภาพรวมของ Drive Label API

ป้ายกำกับคือข้อมูลเมตาที่คุณกำหนดเพื่อช่วยผู้ใช้จัดระเบียบ ค้นหา และใช้นโยบายกับไฟล์ใน Google ไดรฟ์ Drive Labels API เป็น RESTful API ที่รองรับกระบวนการทางธุรกิจโดยการแนบข้อมูลเมตากับไฟล์ในไดรฟ์ การใช้งานทั่วไปสำหรับ API นี้มีดังนี้

  • จัดประเภทเนื้อหาตามกลยุทธ์การกำกับดูแลข้อมูล - สร้างป้ายกำกับเพื่อระบุเนื้อหาหรือข้อมูลที่ละเอียดอ่อนซึ่งต้องมีการจัดการพิเศษ เช่น คุณอาจสร้างป้ายกำกับที่มีป้าย (ป้ายกำกับที่มีค่าตัวเลือกที่กำหนดรหัสสี) ชื่อ "ความละเอียดอ่อน" โดยมีค่าเป็น "ลับที่สุด" "เป็นความลับ" และ "สาธารณะ"

  • ใช้นโยบายกับรายการในไดรฟ์ - สร้างป้ายกำกับเพื่อจัดการเนื้อหาในไดรฟ์ตลอดอายุการใช้งานและตรวจสอบว่าเนื้อหาเป็นไปตามแนวทางปฏิบัติในการเก็บบันทึกระเบียนขององค์กร เช่น ใช้ป้ายกำกับเพื่อ จัดการนโยบายการป้องกันข้อมูลรั่วไหล (DLP) ซึ่งไฟล์ที่มีป้ายกำกับ "ระดับความละเอียดอ่อน" ที่ตั้งค่าเป็น "ลับสุดยอด" จะดาวน์โหลดลงในคอมพิวเตอร์ไม่ได้

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

ต่อไปนี้คือรายการคำศัพท์ทั่วไปที่ใช้ใน Drive Labels API

ป้ายกำกับ

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

ชื่อป้ายกำกับ
ชื่อทรัพยากรของป้ายกำกับ รหัสป้ายกำกับเป็นส่วนหนึ่งของ ชื่อป้ายกำกับ ชื่อจะอยู่ในรูปแบบต่อไปนี้ ขึ้นอยู่กับคำขอ labels/{id} หรือ labels/{id}@{revisionId} ดูข้อมูลเพิ่มเติมได้ที่การแก้ไขป้ายกำกับด้านล่าง
รหัสค่ายเพลง
ตัวระบุที่ไม่ซ้ำกันทั่วโลกสำหรับป้ายกำกับ โดยรหัสนี้เป็นส่วนหนึ่งของ ชื่อป้ายกำกับ แต่จะแตกต่างจากชื่อตรงที่จะสอดคล้องกันระหว่างการแก้ไข

ป้ายกำกับมี 2 รูปแบบ ได้แก่

ป้ายกำกับที่มีตราสถานะ

ป้ายกำกับที่มีประเภทฟิลด์ SelectionOptions ซึ่งมีตัวเลือกที่สามารถกำหนดรหัสสีเพื่อระบุ ความสำคัญได้ โดยทำได้โดยการตั้งค่า badgeConfig ผ่านProperties ของ Choice

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

ป้ายกำกับมาตรฐาน

ป้ายกำกับที่มีประเภทฟิลด์ 0 รายการขึ้นไป ป้ายกำกับมาตรฐานอาจมีชื่อป้ายกำกับ เช่น "Project Moonshot" และระบุไฟล์ทั้งหมดที่เกี่ยวข้องกับโปรเจ็กต์ ป้ายกำกับมาตรฐานอาจมีฟิลด์ที่มีโครงสร้างหลายฟิลด์ด้วย เช่น ป้ายกำกับที่มีชื่อว่า "สัญญา" อาจมีฟิลด์สำหรับ "บริษัท" "วันที่ครบกำหนด" "สถานะ" และ "ผู้ลงนาม" แต่ละฟิลด์มีประเภทที่เฉพาะเจาะจง (ข้อความ วันที่ การเลือก หรือผู้ใช้)

แผนภาพป้ายกำกับที่มีตราสถานะ
รูปที่ 1 ป้ายกำกับที่มีตราสถานะ
แผนภาพป้ายกำกับมาตรฐาน
รูปที่ 2 ป้ายกำกับมาตรฐาน
ฟิลด์

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

ประเภทฟิลด์
ประเภทข้อมูลของค่าที่เชื่อมโยงกับฟิลด์ กำหนดค่าเป็น ข้อความ จำนวนเต็ม วันที่ ผู้ใช้ หรือการเลือกได้ หากกำหนดค่าฟิลด์ด้วย ListOptions คุณจะตั้งค่าฟิลด์ผู้ใช้และฟิลด์การเลือกด้วยค่าหลายค่าได้ ประเภทที่เลือกจะมีผลต่อทั้งค่าที่ถูกต้องที่ใช้ได้กับรายการในไดรฟ์และตัวเลือกคำค้นหาที่ใช้ได้
Choice

ตัวเลือกหนึ่งในหลายๆ ตัวเลือกที่ผู้ใช้เลือกได้ภายในSelectionOptions ฟิลด์

ประเภทป้ายกำกับ

ป้ายกำกับทั้งหมดมี LabelType ป้ายกำกับมี 2 ประเภท ได้แก่

ผู้ดูแลระบบ

หากต้องการสร้างและแก้ไขป้ายกำกับที่เป็นเจ้าของโดยผู้ดูแลระบบ คุณต้องเป็นผู้ดูแลบัญชีที่มีสิทธิ์จัดการป้ายกำกับ

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

  • การแก้ไข - หากต้องการให้ผู้ใช้แก้ไขข้อมูลเมตาของรายการในไดรฟ์ที่เกี่ยวข้องกับป้ายกำกับ ที่ระบุ ผู้ใช้ต้องมีระดับสิทธิ์ที่เหมาะสมดังนี้

    • รายการในไดรฟ์: EDITOR
    • ป้ายกำกับ: APPLIER

  • การอ่าน - หากต้องการให้ผู้ใช้อ่านหรือค้นหาข้อมูลเมตาของรายการในไดรฟ์ ที่เกี่ยวข้องกับป้ายกำกับที่ระบุ ผู้ใช้ต้องมีระดับสิทธิ์ที่เหมาะสม

    • รายการในไดรฟ์: READER
    • ป้ายกำกับ: READER
แชร์

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

การจัดหมวดหมู่ป้ายกำกับ

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

ตัวอย่างการจัดหมวดหมู่ป้ายกำกับ

  • ความละเอียดอ่อน - แดง ส้ม เหลือง เขียว
  • สถานะ - ยังไม่เริ่ม, ฉบับร่าง, อยู่ระหว่างการตรวจสอบ, ฉบับไฟนอล
  • ประเภทเนื้อหา - สัญญา เอกสารการออกแบบ การจำลอง
  • แผนก - การตลาด การเงิน ทรัพยากรบุคคล การขาย
วงจรของป้ายกำกับ

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

การแก้ไขป้ายกำกับ

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

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