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

คุณสามารถแบ่งปันไฟล์และโฟลเดอร์ของ 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 ได้รับการตั้งค่าในส่วนหัว HTTP X-Goog-Drive-Resource-Keys

คำขอที่ส่งไปยัง 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