เข้าถึงไฟล์ในไดรฟ์ที่แชร์ลิงก์โดยใช้คีย์ทรัพยากร

คุณสามารถแชร์ไฟล์และโฟลเดอร์ใน Google ไดรฟ์กับผู้อื่นได้โดยใช้ UI ของไดรฟ์หรือผ่าน Google Drive API เมื่อแชร์จากไดรฟ์ คุณสามารถควบคุมได้ว่าจะให้ผู้อื่นแก้ไข แสดงความคิดเห็น หรือเปิดไฟล์ได้เท่านั้น

คีย์ทรัพยากรช่วยปกป้องไฟล์จากการเข้าถึงโดยไม่ได้ตั้งใจ คีย์ทรัพยากรเป็นพารามิเตอร์เพิ่มเติมที่ส่งเพื่อให้ผู้ใช้เข้าถึงไฟล์บางไฟล์ที่แชร์โดยใช้ลิงก์ได้ ผู้ใช้ที่ไม่เคยดูไฟล์มาก่อนจะต้องระบุคีย์ทรัพยากรเพื่อรับสิทธิ์เข้าถึง ผู้ที่ดูไฟล์หรือมีสิทธิ์เข้าถึงโดยตรงเมื่อเร็วๆ นี้จะไม่จําเป็นต้องใช้คีย์ทรัพยากรเพื่อเข้าถึงไฟล์

ไฟล์ในไดรฟ์ที่แชร์ด้วยลิงก์จะค้นพบได้โดยผู้ใช้ที่เข้าถึงไฟล์ได้เนื่องจากทรัพยากร 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 จะตั้งค่าไว้ในส่วนหัว X-Goog-Drive-Resource-Keys HTTP

คำขอไปยัง Drive API สามารถระบุคีย์ทรัพยากรอย่างน้อย 1 รายการด้วยX-Goog-Drive-Resource-Keysส่วนหัว HTTP

ไวยากรณ์

คู่รหัสไฟล์และคีย์ทรัพยากรจะตั้งค่าในส่วนหัวโดยใช้ตัวคั่นเครื่องหมายทับ (/) ส่วนหัวสร้างขึ้นจากการรวมรหัสไฟล์และคู่คีย์ทรัพยากรทั้งหมดโดยใช้ตัวคั่นด้วยคอมมา (,)

เช่น ลองพิจารณาคำขอย้ายไฟล์ fileId1 จากโฟลเดอร์ fileId2 ไปยังโฟลเดอร์ fileId3 สมมติว่าคีย์แหล่งข้อมูลของไฟล์ทั้ง 3 ไฟล์นี้คือ resourceKey1, resourceKey2 และ resourceKey3 ตามลำดับ ส่วนหัวที่สร้างขึ้นจากค่าเหล่านี้โดยใช้เครื่องหมายทับและเครื่องหมายคอมมาเป็นตัวคั่นมีดังนี้

    X-Goog-Drive-Resource-Keys: fileId1/resourceKey1,fileId2/resourceKey2,fileId3/resourceKey3