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

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