โฟลเดอร์ข้อมูลแอปพลิเคชันเป็นโฟลเดอร์พิเศษที่ซ่อนอยู่ซึ่งแอปของคุณใช้ เพื่อจัดเก็บข้อมูลเฉพาะของแอปพลิเคชันได้ เช่น ไฟล์การกำหนดค่า ระบบจะสร้างโฟลเดอร์ข้อมูลแอปพลิเคชันโดยอัตโนมัติเมื่อคุณพยายามสร้างไฟล์ในโฟลเดอร์ดังกล่าว ใช้โฟลเดอร์นี้เพื่อจัดเก็บไฟล์ที่ผู้ใช้ไม่ควรโต้ตอบด้วยโดยตรง แอปของคุณเท่านั้นที่จะเข้าถึงโฟลเดอร์นี้ได้ และระบบจะซ่อนเนื้อหาของโฟลเดอร์ จากผู้ใช้และแอป 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: รหัสของไฟล์ที่ต้องการดาวน์โหลด