เพิ่มพร็อพเพอร์ตี้ของไฟล์ที่กําหนดเอง

คุณสมบัติของไฟล์ที่กำหนดเองคือคู่คีย์-ค่าที่ใช้ในการจัดเก็บข้อมูลเมตาที่กำหนดเองสำหรับ ไฟล์ 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 เพื่อเรียกข้อมูลพร็อพเพอร์ตี้ส่วนตัวไม่ได้