คุณแชร์ไฟล์และโฟลเดอร์ใน 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
คำขอไปยัง 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