โฟลเดอร์ข้อมูลแอปพลิเคชันเป็นโฟลเดอร์พิเศษที่ซ่อนอยู่ซึ่งแอปของคุณใช้ เพื่อจัดเก็บข้อมูลเฉพาะของแอปพลิเคชันได้ เช่น ไฟล์การกำหนดค่า ระบบจะสร้างโฟลเดอร์ข้อมูลแอปพลิเคชันโดยอัตโนมัติเมื่อคุณพยายามสร้างไฟล์ในโฟลเดอร์ดังกล่าว ใช้โฟลเดอร์นี้เพื่อจัดเก็บไฟล์ที่ผู้ใช้ไม่ควรโต้ตอบด้วยโดยตรง แอปของคุณเท่านั้นที่จะเข้าถึงโฟลเดอร์นี้ได้ และระบบจะซ่อนเนื้อหาของโฟลเดอร์ จากผู้ใช้และแอป Google ไดรฟ์อื่นๆ
ระบบจะลบโฟลเดอร์ข้อมูลแอปพลิเคชันเมื่อผู้ใช้ถอนการติดตั้งแอปจากไดรฟ์ของฉัน นอกจากนี้ ผู้ใช้ยังลบโฟลเดอร์ข้อมูลของแอปด้วยตนเองได้ด้วย
ขอบเขตโฟลเดอร์ข้อมูลแอปพลิเคชัน
ก่อนที่จะเข้าถึงโฟลเดอร์ข้อมูลแอปพลิเคชันได้ คุณต้องขอสิทธิ์เข้าถึงhttps://www.googleapis.com/auth/drive.appdata
ขอบเขตที่ไม่ละเอียดอ่อน ดูข้อมูลเพิ่มเติมเกี่ยวกับขอบเขตและวิธีขอสิทธิ์เข้าถึงได้ที่เลือกขอบเขต Google Drive API ดูข้อมูลเพิ่มเติมเกี่ยวกับขอบเขต OAuth 2.0 ที่เฉพาะเจาะจงได้ที่ขอบเขต OAuth 2.0 สำหรับ Google APIs
โฟลเดอร์ข้อมูลแอปพลิเคชันแตกต่างจากโฟลเดอร์ข้อมูลสำรองของไดรฟ์อย่างไร
โฟลเดอร์ข้อมูลแอปพลิเคชันจะแยกจากโฟลเดอร์ข้อมูลสำรองของไดรฟ์
โฟลเดอร์ข้อมูลแอปพลิเคชันคือโฟลเดอร์การกำหนดค่าที่สร้างขึ้นสำหรับแอปของบุคคลที่สามแต่ละแอป และแอปของบุคคลที่สามแต่ละแอปจะจัดเก็บข้อมูลในโฟลเดอร์นี้ได้ เฉพาะแอปพลิเคชันที่สร้างข้อมูลใน appDataFolder
เท่านั้นที่จะเข้าถึงข้อมูลดังกล่าวได้ เข้าถึงโฟลเดอร์ไม่ได้โดยใช้อินเทอร์เฟซผู้ใช้ (UI) ของไดรฟ์
โฟลเดอร์ข้อมูลสำรองของไดรฟ์เป็นโฟลเดอร์ที่สงวนไว้ซึ่งไดรฟ์จะเขียนข้อมูลสำรองของอุปกรณ์ลงในโฟลเดอร์นี้ และจะแสดงใน UI ของไดรฟ์
ข้อจำกัดเกี่ยวกับโฟลเดอร์ข้อมูลแอปพลิเคชัน
ระบบจะบังคับใช้ข้อจำกัดต่อไปนี้เมื่อทำงานกับโฟลเดอร์ข้อมูลแอปพลิเคชัน
คุณแชร์ไฟล์หรือโฟลเดอร์ภายในโฟลเดอร์ข้อมูลแอปพลิเคชันไม่ได้ การพยายามดำเนินการดังกล่าวจะทำให้เกิดข้อผิดพลาด
notSupportedForAppDataFolderFiles
พร้อมข้อความแสดงข้อผิดพลาดต่อไปนี้ "ระบบไม่รองรับเมธอดสำหรับไฟล์ภายใน โฟลเดอร์ข้อมูลแอปพลิเคชัน"คุณย้ายไฟล์ใน
appDataFolder
ระหว่างตำแหน่งที่จัดเก็บข้อมูล (พื้นที่) ไม่ได้ การพยายามดำเนินการดังกล่าวจะทำให้เกิดnotSupportedForAppDataFolderFiles
ข้อผิดพลาดพร้อมข้อความแสดงข้อผิดพลาดต่อไปนี้ "ไม่รองรับเมธอดสำหรับไฟล์ภายในโฟลเดอร์ Application Data" ดูข้อมูลเพิ่มเติมได้ที่การจัดระเบียบ ไฟล์คุณจะย้ายไฟล์หรือโฟลเดอร์ภายในโฟลเดอร์ข้อมูลแอปพลิเคชันไปที่ถังขยะไม่ได้ การพยายามดำเนินการดังกล่าวจะทำให้เกิด
notSupportedForAppDataFolderFiles
ข้อผิดพลาด พร้อมข้อความแสดงข้อผิดพลาดต่อไปนี้ "ทิ้งไฟล์ในโฟลเดอร์ข้อมูลแอปพลิเคชันไม่ได้"
สร้างไฟล์ในโฟลเดอร์ข้อมูลแอปพลิเคชัน
หากต้องการสร้างไฟล์ในโฟลเดอร์ข้อมูลแอปพลิเคชัน ให้ระบุ appDataFolder
ในพร็อพเพอร์ตี้ parents
ของไฟล์ แล้วใช้เมธอด files.create
เพื่อสร้างไฟล์ในโฟลเดอร์
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีแทรกไฟล์ลงในโฟลเดอร์โดยใช้ ไลบรารีของไคลเอ็นต์และคำสั่ง curl
Java
Python
Node.js
PHP
.NET
curl
คำขอ
curl --request POST \ 'https://content.googleapis.com/drive/v3/files' \ -H 'authorization: Bearer ACCESS_TOKEN' \ -H 'content-type: application/json' \ -H 'x-origin: https://explorer.apis.google.com' \ --data-raw '{"name": "config.json", "parents":["appDataFolder"]}'
แทนที่ ACCESS_TOKEN ด้วยโทเค็น OAuth 2.0 ของแอป
คำตอบ
{ "kind": "drive#file", "id": FILE_ID, "name": "config.json", "mimeType": "application/json" }
ดูข้อมูลเพิ่มเติมเกี่ยวกับการสร้างไฟล์ในโฟลเดอร์ได้ที่สร้างและ ป้อนข้อมูลในโฟลเดอร์
ค้นหาไฟล์ในโฟลเดอร์ข้อมูลแอปพลิเคชัน
หากต้องการค้นหาไฟล์ในโฟลเดอร์ข้อมูลแอปพลิเคชัน ให้ตั้งค่าฟิลด์ spaces
เป็น appDataFolder
แล้วใช้วิธี files.list
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีค้นหาไฟล์ในโฟลเดอร์ข้อมูลแอปพลิเคชัน โดยใช้ไลบรารีของไคลเอ็นต์และคำสั่ง curl
Java
Python
Node.js
PHP
.NET
curl
คำขอ
curl \ -X GET \ -H "Authorization: Bearer ACCESS_TOKEN" \ "https://www.googleapis.com/drive/v3/files?spaces=appDataFolder&fields=files(id,name,mimeType,size,modifiedTime)"
แทนที่ ACCESS_TOKEN ด้วยโทเค็น OAuth 2.0 ของแอป
คำตอบ
{ "files": [ { "mimeType": "application/json", "size": "256", "id": FILE_ID, "name": "config.json", "modifiedTime": "2025-04-03T23:40:05.860Z" }, { "mimeType": "text/plain", "size": "128", "id": FILE_ID, "name": "user_settings.txt", "modifiedTime": "2025-04-02T17:52:29.020Z" } ] }
ดาวน์โหลดไฟล์จากโฟลเดอร์ข้อมูลแอปพลิเคชัน
หากต้องการดาวน์โหลดไฟล์จากโฟลเดอร์ข้อมูลแอปพลิเคชัน ให้ใช้เมธอด files.get
กับพารามิเตอร์ URL alt=media
เพื่อ ดึงเนื้อหาของไฟล์ในส่วนเนื้อหาของการตอบกลับ ดูข้อมูลเพิ่มเติมและ ดูตัวอย่างโค้ดได้ที่ดาวน์โหลดเนื้อหาไฟล์ Blob
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีดาวน์โหลดไฟล์ในโฟลเดอร์ข้อมูลแอปพลิเคชัน โดยใช้คำสั่ง curl เนื้อหาการตอบกลับจะแตกต่างกันไปตามสิ่งที่ บันทึกไว้
curl
คำขอ
curl \ -X GET \ -H "Authorization: Bearer ACCESS_TOKEN" \ "https://www.googleapis.com/drive/v3/files/FILE_ID?alt=media"
แทนที่ค่าต่อไปนี้
- ACCESS_TOKEN: โทเค็น OAuth 2.0 ของแอป
- FILE_ID: รหัสของไฟล์ที่ต้องการดาวน์โหลด