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

คุณสามารถแชร์ไฟล์และโฟลเดอร์ใน 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