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