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