ภาพรวมของ 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 ป้ายกำกับมาตรฐาน
ฟิลด์

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

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

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

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

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

ผู้ดูแลระบบ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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