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

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