ภาพรวม Drive Labels API

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

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

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

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

ด้านล่างนี้เป็นรายการคำศัพท์ทั่วไปที่ใช้ใน Drive ป้ายกำกับ 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
แชร์

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

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

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

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

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

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

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

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

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