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

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