คุณสามารถแชร์ไฟล์และโฟลเดอร์ Google ไดรฟ์กับผู้อื่นโดยใช้ UI ของไดรฟ์หรือผ่าน API ของ Google ไดรฟ์ เมื่อแชร์จากไดรฟ์ คุณจะกำหนดได้ว่าบุคคลอื่นสามารถแก้ไข แสดงความคิดเห็น หรือเปิดไฟล์ได้อย่างเดียว
คีย์ทรัพยากรช่วยปกป้องไฟล์จากการเข้าถึงโดยไม่ได้ตั้งใจ คีย์ทรัพยากรคือพารามิเตอร์เพิ่มเติมที่ส่งเพื่อให้ผู้ใช้เข้าถึงไฟล์บางไฟล์ที่แชร์โดยใช้ลิงก์ได้ ส่วนผู้ใช้ที่ยังไม่เคยดูไฟล์ก่อน ต้องระบุคีย์ทรัพยากรเพื่อรับสิทธิ์เข้าถึง ผู้ที่ดูไฟล์เมื่อเร็วๆ นี้หรือมีสิทธิ์เข้าถึงโดยตรง ไม่จำเป็นต้องใช้คีย์ทรัพยากรเพื่อเข้าถึงไฟล์
มีเพียงผู้ใช้ที่เข้าถึงไฟล์ได้ซึ่งเป็นผลมาจากทรัพยากร type=user
หรือ type=group
permissions
เท่านั้นที่จะค้นพบไฟล์ในไดรฟ์ที่แชร์ด้วยลิงก์ได้ คำขอจากผู้ใช้ที่มีสิทธิ์เข้าถึงไฟล์ที่แชร์ลิงก์เหล่านี้โดยใช้สิทธิ์ type=domain
หรือ type=anyone
เท่านั้นอาจต้องใช้คีย์ทรัพยากร
โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับสิทธิ์ที่หัวข้อแชร์ไฟล์ โฟลเดอร์ และไดรฟ์ ดูรายการบทบาทและการดำเนินการทั้งหมดที่แต่ละรายการอนุญาตได้ที่บทบาทและสิทธิ์
อ่านคีย์แหล่งข้อมูลจากไฟล์
Drive API จะแสดงผลคีย์ทรัพยากรของไฟล์ในช่อง resourceKey
แบบอ่านอย่างเดียวของทรัพยากร files
หากไฟล์เป็นทางลัดของไดรฟ์ คีย์ทรัพยากรสำหรับเป้าหมายทางลัดจะแสดงในช่อง shortcutDetails.targetResourceKey
แบบอ่านอย่างเดียว
ช่องในทรัพยากร files
ที่แสดง URL เช่น exportLinks
, webContentLink
และ webViewLink
จะมี resourceKey
ด้วย ไคลเอ็นต์ที่ผสานรวมกับ UI ของไดรฟ์จะใช้ resourceKeys
ภายในพารามิเตอร์ state
ได้ด้วย ดูข้อมูลเพิ่มเติมได้ที่ดาวน์โหลดและส่งออกไฟล์
ตั้งค่าคีย์แหล่งข้อมูลในคำขอ
คีย์ทรัพยากรสำหรับไฟล์ใดก็ตามที่คำขอที่ส่งไปยัง Drive API จะตั้งค่าไว้ที่ส่วนหัว HTTP ของ X-Goog-Drive-Resource-Keys
คำขอที่ส่งไปยัง Drive API สามารถระบุคีย์ทรัพยากรอย่างน้อย 1 รายการด้วยส่วนหัว HTTP ของ X-Goog-Drive-Resource-Keys
ไวยากรณ์
รหัสไฟล์และคู่คีย์ทรัพยากรจะตั้งค่าในส่วนหัวโดยใช้เครื่องหมายทับ (/
) ส่วนหัวนี้สร้างขึ้นโดยการรวมรหัสไฟล์และคู่คีย์ทรัพยากรทั้งหมดโดยใช้ตัวคั่นคอมมา (,
)
ตัวอย่างเช่น ลองส่งคำขอให้ย้ายไฟล์ fileId1
จากโฟลเดอร์ fileId2
ไปยังโฟลเดอร์ fileId3
สมมติว่าคีย์แหล่งข้อมูลสำหรับ 3 ไฟล์นี้คือ resourceKey1
, resourceKey2
และ resourceKey3
ตามลำดับ ส่วนหัวที่สร้างขึ้นจากค่าเหล่านี้โดยใช้เครื่องหมายทับและตัวคั่นเครื่องหมายจุลภาคมีดังนี้
X-Goog-Drive-Resource-Keys: fileId1/resourceKey1,fileId2/resourceKey2,fileId3/resourceKey3