ป้ายกำกับคือข้อมูลเมตาที่คุณกำหนดเพื่อช่วยผู้ใช้จัดระเบียบ ค้นหา และใช้นโยบายกับไฟล์ใน Google ไดรฟ์ Drive Labels API คือ RESTful API ที่รองรับกระบวนการทางธุรกิจโดยการแนบข้อมูลเมตาลงในไฟล์ในไดรฟ์ การใช้งานทั่วไปของ API นี้คือ
แยกประเภทเนื้อหาตามกลยุทธ์การกำกับดูแลข้อมูล - สร้างป้ายกำกับเพื่อระบุเนื้อหาหรือข้อมูลที่ละเอียดอ่อนที่ต้องมีการจัดการพิเศษ ตัวอย่างเช่น คุณอาจสร้างป้ายกำกับที่มีตราสถานะ (ป้ายกำกับที่มีค่าตัวเลือกสี) ที่มีชื่อว่า "ความละเอียดอ่อน" โดยมีค่าเป็น "ข้อมูลลับสุดยอด" "ข้อมูลลับ" และ "สาธารณะ"
ใช้นโยบายกับรายการในไดรฟ์ - สร้างป้ายกำกับเพื่อจัดการเนื้อหาในไดรฟ์ตลอดอายุ และตรวจสอบว่าเนื้อหาเป็นไปตามแนวทางปฏิบัติในการเก็บบันทึกข้อมูลขององค์กร เช่น ใช้ป้ายกำกับเพื่อจัดการนโยบายข้อมูลรั่วไหล (DLP) ซึ่งจะทำให้ไฟล์ที่มีป้ายกำกับ "ความละเอียดอ่อน" ตั้งค่าเป็น "ข้อมูลลับสุดยอด" จะดาวน์โหลดลงในคอมพิวเตอร์ไม่ได้
ดูแลจัดการและค้นหาไฟล์ สร้างป้ายกำกับเพื่อเพิ่มความสามารถในการค้นหาเนื้อหาของบริษัท โดยให้ผู้ใช้ในองค์กรค้นหารายการตามป้ายกำกับและช่องของตนได้ เช่น ผู้ใช้ในองค์กรอาจใช้ตัวเลือกการค้นหาในไดรฟ์เพื่อค้นหาสัญญาทั้งหมดที่กำลังรอลายเซ็นตามวันที่ที่ระบุ
ด้านล่างนี้เป็นรายการคำศัพท์ทั่วไปที่ใช้ใน Drive Labels API
- ป้ายกำกับ
ข้อมูลเมตาที่มีโครงสร้างที่วางไว้ในไฟล์ในไดรฟ์ โดยผู้ใช้ไดรฟ์จะกำหนดป้ายกำกับและกำหนดค่าของช่องป้ายกำกับให้กับไฟล์ได้ ป้ายกำกับประกอบด้วยสิ่งต่อไปนี้
- ชื่อป้ายกำกับ
- ชื่อทรัพยากรของป้ายกำกับ รหัสป้ายกำกับเป็นส่วนหนึ่งของชื่อป้ายกำกับ ชื่อจะอยู่ในรูปแบบ
labels/{id}
หรือlabels/{id}@{revisionId}
ซึ่งขึ้นอยู่กับคำขอ ดูข้อมูลเพิ่มเติมได้ที่การแก้ไขป้ายกำกับด้านล่าง - รหัสป้ายกำกับ
- ตัวระบุที่ไม่ซ้ำกันทั่วโลกสำหรับป้ายกำกับ รหัสเป็นส่วนหนึ่งของชื่อป้ายกำกับ แต่ต่างจากชื่อตรงที่จะสอดคล้องกันระหว่างการแก้ไขต่างๆ
ป้ายกำกับมี 2 รูปแบบ ได้แก่
- ป้ายกำกับที่มีตราสถานะ
ป้ายกำกับที่มีประเภทช่อง
SelectionOptions
ซึ่งมีตัวเลือกที่สามารถเข้ารหัสสีเพื่อระบุความสำคัญ ซึ่งทำโดยการตั้งค่าbadgeConfig
ผ่านProperties
ของChoice
ไดรฟ์จะแสดงสีของตัวเลือกที่เลือกไว้สำหรับแต่ละไฟล์ เพื่อให้ผู้ใช้เข้าใจสถานะ การแยกประเภท และอื่นๆ ของไฟล์ได้อย่างชัดเจน ตัวอย่างเช่น ตัวเลือก "ข้อมูลลับสุดยอด" สำหรับป้ายกำกับที่มีป้าย "ความละเอียดอ่อน" อาจแสดงเป็นสีแดง คุณจะมีป้ายกำกับที่มีตราสถานะได้ครั้งละ 1 รายการเท่านั้น
- ป้ายกำกับมาตรฐาน
ป้ายกำกับที่มีประเภทช่องเป็นศูนย์หรือมากกว่า ป้ายกำกับมาตรฐานอาจมีชื่อป้ายกำกับ เช่น "Project Moonshot" และระบุไฟล์ทั้งหมดที่เกี่ยวข้องกับโปรเจ็กต์ ป้ายกำกับมาตรฐานอาจมีช่องที่มีโครงสร้างหลายช่องด้วย เช่น ป้ายกำกับที่มีชื่อว่า "สัญญา" อาจมีช่องสำหรับ "บริษัท" "วันที่ครบกำหนด" "สถานะ" และ "ผู้ลงนาม" อยู่ด้วย แต่ละช่องเป็นประเภทที่เฉพาะเจาะจง (ข้อความ วันที่ การเลือก หรือผู้ใช้)
- ฟิลด์
ส่วนประกอบที่ตั้งค่าได้แต่ละรายการของป้ายกำกับ ป้ายกำกับอาจมีช่องเป็น 0 หรือ มากกว่านั้นที่เชื่อมโยงอยู่
- ประเภทช่อง
- ประเภทข้อมูลของค่าที่เชื่อมโยงกับช่อง สามารถกำหนดค่าเป็นข้อความ จำนวนเต็ม วันที่ ผู้ใช้ หรือการเลือก หากกำหนดค่าช่องนี้ด้วย
ListOptions
คุณจะตั้งค่าฟิลด์ผู้ใช้และการเลือกด้วยค่าหลายรายการได้ ประเภทที่เลือกจะส่งผลต่อทั้งค่าที่ถูกต้องสำหรับรายการในไดรฟ์และตัวเลือกคำค้นหาที่มี
- ตัวเลือก
หนึ่งในตัวเลือกต่างๆ ที่ผู้ใช้เลือกได้ในช่อง
SelectionOptions
- ประเภทป้ายกำกับ
ป้ายกำกับทั้งหมดมี
LabelType
ป้ายกำกับมี 2 ประเภทดังนี้- ผู้ดูแลระบบ
หากต้องการสร้างและแก้ไขป้ายกำกับที่ผู้ดูแลระบบเป็นเจ้าของ คุณต้องเป็นผู้ดูแลระบบบัญชีที่มีสิทธิ์จัดการป้ายกำกับ
ผู้ดูแลระบบสามารถแชร์ป้ายกำกับผู้ดูแลระบบกับผู้ใช้รายใดก็ได้ เพื่อให้ผู้ใช้ดังกล่าวสามารถดูและนำไปใช้กับรายการในไดรฟ์ได้ การแก้ไขหรืออ่านค่าของป้ายกำกับในรายการในไดรฟ์ต้องใช้สิทธิ์ต่อไปนี้
การแก้ไข - ผู้ใช้ต้องมีระดับสิทธิ์ที่เหมาะสมเพื่อให้ผู้ใช้แก้ไขข้อมูลเมตาของรายการในไดรฟ์ที่เกี่ยวข้องกับป้ายกำกับที่กำหนดได้ ดังนี้
- รายการในไดรฟ์:
EDITOR
- ป้ายกำกับ:
APPLIER
- รายการในไดรฟ์:
การอ่าน - ผู้ใช้ต้องมีระดับสิทธิ์ที่เหมาะสมเพื่อให้ผู้ใช้อ่านหรือค้นหาข้อมูลเมตาของรายการในไดรฟ์ที่เกี่ยวข้องกับป้ายกำกับที่กำหนด ดังนี้
- รายการในไดรฟ์:
READER
- ป้ายกำกับ:
READER
- รายการในไดรฟ์:
ผู้ใช้ที่ไม่ใช่ผู้ดูแลระบบจะสร้างป้ายกำกับที่ใช้ร่วมกันซึ่งผู้อื่นนำไปใช้กับรายการในไดรฟ์ได้ ทีมสามารถสร้างและจัดระเบียบป้ายกำกับของตนเอง เพื่อใช้ในทีมได้โดยไม่ต้องมีผู้ดูแลระบบ
- การจัดหมวดหมู่ป้ายกำกับ
ช่องป้ายกำกับที่กำหนดค่าไว้ในปัจจุบันที่พร้อมใช้งานสำหรับผู้ใช้สำหรับแอปพลิเคชันกับไฟล์ในไดรฟ์ เรียกอีกอย่างว่าสคีมาของป้ายกำกับ
ตัวอย่างการจัดหมวดหมู่ป้ายกำกับ
- ความไว - แดง ส้ม เหลือง เขียว
- สถานะ - ยังไม่เริ่ม ฉบับร่าง อยู่ระหว่างการตรวจสอบ ขั้นสุดท้าย
- ประเภทเนื้อหา ได้แก่ สัญญา เอกสารการออกแบบ การจำลอง
- แผนกการตลาด การเงิน ทรัพยากรบุคคล การขาย
- วงจรของป้ายกำกับ
ป้ายกำกับจะเข้าสู่วงจรตั้งแต่การสร้าง เผยแพร่ อัปเดต และอื่นๆ อีกมากมาย เนื่องจากป้ายกำกับจะค่อยๆ ตลอดวงจร การแก้ไขป้ายกำกับก็จะเพิ่มขึ้น ดูข้อมูลเพิ่มเติมได้ที่วงจรของป้ายกํากับ
- การแก้ไขป้ายกำกับ
ตัวอย่างของป้ายกำกับ ทุกครั้งที่มีการสร้าง อัปเดต เผยแพร่ หรือเลิกใช้งานป้ายกำกับ การแก้ไขป้ายกำกับจะเพิ่มขึ้น
- การแก้ไขฉบับร่าง
- หมายเลขการแก้ไขของอินสแตนซ์ฉบับร่างปัจจุบันของป้ายกำกับ คุณสามารถทำการอัปเดตป้ายกำกับได้หลายรายการ โดยแต่ละรายการจะเพิ่มจำนวนการแก้ไขฉบับร่าง โดยไม่ส่งผลต่อการแก้ไขที่เผยแพร่แล้ว ความสามารถในการมีป้ายกำกับฉบับร่างช่วยให้คุณทดสอบการอัปเดตป้ายกำกับก่อนเผยแพร่ได้
- การแก้ไขที่เผยแพร่แล้ว
- หมายเลขการแก้ไขของป้ายกำกับเวอร์ชันที่เผยแพร่ ป้ายกำกับที่เผยแพร่เป็นอินสแตนซ์ของป้ายกำกับที่ผู้ใช้สามารถใช้งานได้ในปัจจุบัน
หัวข้อที่เกี่ยวข้อง
หากต้องการดูข้อมูลเกี่ยวกับการพัฒนาด้วย Google Workspace API รวมถึงการจัดการการตรวจสอบสิทธิ์และการให้สิทธิ์ โปรดดูหัวข้อเริ่มต้นใช้งานในฐานะนักพัฒนาซอฟต์แวร์ Google Workspace
หากต้องการดูวิธีกำหนดค่าและเรียกใช้แอป Labels API อย่างง่าย ให้ลองใช้ การเริ่มต้นใช้งาน Python อย่างรวดเร็ว