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