พร็อพเพอร์ตี้ของไฟล์ที่กําหนดเองคือคู่คีย์/ค่าที่ใช้จัดเก็บข้อมูลเมตาที่กําหนดเองสําหรับไฟล์ เช่น แท็ก รหัสจากที่เก็บข้อมูลอื่นๆ ข้อมูลที่แชร์ระหว่างแอปพลิเคชันเวิร์กโฟลว์ และอื่นๆ
หากต้องการเพิ่มพร็อพเพอร์ตี้ที่ปรากฏในแอปทั้งหมด ให้ใช้ช่อง properties ของทรัพยากร files หากต้องการเพิ่มพร็อพเพอร์ตี้ที่จํากัดลงในแอป ให้ใช้ช่อง appProperties ในทรัพยากร files
นอกจากนี้ คุณยังใช้พร็อพเพอร์ตี้ในนิพจน์การค้นหาได้อีกด้วย
นี่คือโครงสร้างของพร็อพเพอร์ตี้ทั่วไปที่อาจใช้เพื่อจัดเก็บรหัสของฐานข้อมูลสําหรับไฟล์ในไดรฟ์
Drive API v3
"appProperties": {
"additionalID": "8e8aceg2af2ge72e78",
}
Drive API v2
{
'key': 'additionalID',
'value': '8e8aceg2af2ge72e78',
'visibility': 'PRIVATE'
}
พร็อพเพอร์ตี้ที่กําหนดเองมีขีดจํากัดต่อไปนี้
- พร็อพเพอร์ตี้ที่กําหนดเองสูงสุด 100 รายการต่อไฟล์ รวมมาจากทุกแหล่งที่มา
- พร็อพเพอร์ตี้สาธารณะสูงสุด 30 รายการต่อไฟล์ รวมมาจากทุกแหล่งที่มา
- พร็อพเพอร์ตี้ส่วนตัวสูงสุด 30 รายการต่อไฟล์จากแอปพลิเคชันเดียว
- ขนาดคีย์สูงสุด 124 ไบต์ต่อพร็อพเพอร์ตี้ (รวมทั้งคีย์และค่า) ในการเข้ารหัส UTF-8 เช่น พร็อพเพอร์ตี้ที่มีคีย์ยาว 10 อักขระ จะมีได้เพียง 114 อักขระในค่า พร็อพเพอร์ตี้ที่มีอักขระ 100 ตัวสําหรับค่าสามารถใช้คีย์ได้สูงสุด 24 อักขระ
- การเขียนพร็อพเพอร์ตี้ไฟล์จะมีผลกระทบต่อประสิทธิภาพเหมือนกับการเขียนอื่นๆ
ดูข้อมูลเพิ่มเติมได้ที่ทรัพยากร files
เข้าถึงคุณสมบัติของไฟล์ที่กําหนดเอง
ระบบจะดึงข้อมูลพร็อพเพอร์ตี้เหล่านี้ได้โดยใช้คําขอที่ได้รับการตรวจสอบสิทธิ์เท่านั้น คําขอที่ตรวจสอบสิทธิ์แล้วจะใช้โทเค็นเพื่อการเข้าถึงที่ได้รับด้วยรหัสไคลเอ็นต์ OAuth 2 คุณใช้คีย์ API เพื่อดึงข้อมูลพร็อพเพอร์ตี้ส่วนตัวไม่ได้