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

แผนภาพป้ายกำกับที่มีตราสถานะ
รูปที่ 1 ป้ายกำกับที่มีป้าย
แผนภาพป้ายกำกับมาตรฐาน
รูปที่ 2 ป้ายกำกับมาตรฐาน
ช่อง

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

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

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

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

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

ผู้ดูแลระบบ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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