คุณสมบัติของไฟล์ที่กำหนดเองคือคู่คีย์-ค่าที่ใช้ในการจัดเก็บข้อมูลเมตาที่กำหนดเองสำหรับ ไฟล์ Google ไดรฟ์ (เช่น แท็ก), รหัสจากพื้นที่เก็บข้อมูลอื่นๆ, ข้อมูล แชร์ระหว่างแอปพลิเคชันเวิร์กโฟลว์ และอื่นๆ เช่น คุณสามารถเพิ่มไฟล์ ให้กับเอกสารทั้งหมดที่ฝ่ายขายสร้างขึ้นในไตรมาสที่ 1
หากต้องการเพิ่มพร็อพเพอร์ตี้ที่แอปพลิเคชันทั้งหมดมองเห็นได้ ให้ใช้ฟิลด์ properties
ของ
แหล่งข้อมูล files
วิธีเพิ่มพร็อพเพอร์ตี้
จำกัดเฉพาะแอปของคุณ ให้ใช้ช่อง appProperties
ของแหล่งข้อมูล files
นอกจากนี้ยังสามารถใช้คุณสมบัติในการค้นหา นิพจน์
นี่คือโครงสร้างของพร็อพเพอร์ตี้ทั่วไปที่อาจใช้จัดเก็บ รหัสฐานข้อมูลของไฟล์ในไดรฟ์ในไฟล์
API ไดรฟ์ v3
"appProperties": {
"additionalID": "ID",
}
API ไดรฟ์ v2
{
'key': 'additionalID',
'value': 'ID',
'visibility': 'PRIVATE'
}
การใช้งานพร็อพเพอร์ตี้ไฟล์ที่กำหนดเอง
ส่วนนี้อธิบายวิธีดำเนินการงานเกี่ยวกับพร็อพเพอร์ตี้ไฟล์ที่กำหนดเอง ซึ่ง มีผลกับแอปพลิเคชันทั้งหมด
เพิ่มหรืออัปเดตคุณสมบัติไฟล์ที่กำหนดเอง
หากต้องการเพิ่มหรืออัปเดตพร็อพเพอร์ตี้ที่เปิดเผยต่อแอปพลิเคชันทั้งหมด ให้ใช้
files.update
ในการตั้งค่า
ฟิลด์ properties
ของ files
ทรัพยากร
PATCH https://www.googleapis.com/drive/v3/files/FILE_ID
{ "properties": { "name": "wrench", "mass": "1.3kg", "count": "3" } }
คุณสามารถเพิ่มคุณสมบัติที่กำหนดเองลงในไฟล์ได้โดยใช้ บริการไดรฟ์ใน Google Apps Script สำหรับข้อมูลเพิ่มเติม โปรดดู การเพิ่มที่กำหนดเอง พร็อพเพอร์ตี้
รับหรือแสดงรายการพร็อพเพอร์ตี้ไฟล์ที่กำหนดเอง
หากต้องการดูพร็อพเพอร์ตี้ที่แอปพลิเคชันทั้งหมดมองเห็นได้ ให้ใช้
files.get
เพื่อเรียกข้อมูล
คุณสมบัติของไฟล์ที่กำหนดเอง
GET https://www.googleapis.com/drive/v3/files/FILE_ID
?fields=properties
การตอบสนองประกอบด้วยออบเจ็กต์ properties
ที่มีคอลเล็กชันของ
คู่คีย์-ค่า
{ "properties": { "name": "wrench", "mass": "1.3kg", "count": "3" } }
ลบคุณสมบัติไฟล์ที่กำหนดเอง
หากต้องการลบค่าพร็อพเพอร์ตี้ที่แอปพลิเคชันทั้งหมดมองเห็นได้ ให้ใช้
files.update
ในการตั้งค่า
ฟิลด์ properties
ของ files
ทรัพยากรเป็นค่าว่าง
PATCH https://www.googleapis.com/drive/v3/files/FILE_ID
{ "name": null }
หากต้องการดูการเปลี่ยนแปลง ให้เรียก
files.get
เพื่อเรียกข้อมูล
properties
สำหรับไฟล์
{ "properties": { "mass": "1.3kg", "count": "3" } }
ขีดจํากัดของพร็อพเพอร์ตี้ไฟล์ที่กําหนดเอง
พร็อพเพอร์ตี้ที่กำหนดเองมีขีดจำกัดดังต่อไปนี้
- พร็อพเพอร์ตี้ที่กําหนดเองสูงสุด 100 รายการต่อไฟล์ ซึ่งรวมมาจากแหล่งที่มาทั้งหมด
- พร็อพเพอร์ตี้สาธารณะสูงสุด 30 รายการต่อไฟล์ ซึ่งรวมมาจากแหล่งที่มาทั้งหมด
- พร็อพเพอร์ตี้ส่วนตัวสูงสุด 30 รายการต่อไฟล์จากแอปพลิเคชัน 1 รายการ
- สูงสุด 124 ไบต์ต่อสตริงพร็อพเพอร์ตี้ (รวมทั้งคีย์และค่า) ใน การเข้ารหัส UTF-8 เช่น พร็อพเพอร์ตี้ที่มีคีย์ยาว 10 อักขระ ต้องมี 114 อักขระสำหรับค่าเท่านั้น ในทำนองเดียวกัน พร็อพเพอร์ตี้ที่ ค่าต้องมีอักขระไม่เกิน 100 ตัวและใช้อักขระได้สูงสุด 24 ตัว
ดูข้อมูลเพิ่มเติมได้ที่files
ทรัพยากร สำหรับ Drive API v2 โปรดดู
แหล่งข้อมูล properties
เข้าถึงคุณสมบัติส่วนตัวของไฟล์ที่กำหนดเอง
คุณสามารถดึงข้อมูลพร็อพเพอร์ตี้ส่วนตัวโดยใช้ช่อง appProperties
เท่านั้นผ่าน
คำขอที่ได้รับการตรวจสอบสิทธิ์ซึ่งใช้โทเค็นเพื่อการเข้าถึงที่ได้รับด้วย OAuth 2.0
รหัสไคลเอ็นต์ คุณใช้คีย์ API เพื่อเรียกข้อมูลพร็อพเพอร์ตี้ส่วนตัวไม่ได้