คู่มือใช้งาน API จัดการไฟล์ Google Drive

ภาพรวม

API นี้ใช้สำหรับจัดการไฟล์บน Google Drive ผ่าน REST API โดยใช้ Google Apps Script เป็น Backend มีความสามารถในการจัดการไฟล์ขั้นพื้นฐานทั้งหมด

• URL: https://script.google.com/macros/s/AKfycbz3ENIijyea-6UgIWghQ62Sie2rsNsBLnpvGbh_NQnOuvV-Eot1ytR1Amcy-7CnM-2f/exec
• Root Folder ID: 1rg8UyC4uZiO7mTU4YkSug9_tdk4FiSHy (โฟลเดอร์ "technology file")
• Method: GET สำหรับอ่านข้อมูล, POST สำหรับเพิ่ม/แก้ไข/ลบ
• Format: ส่งและรับข้อมูลเป็น JSON

การยืนยันตัวตน (Token)

ทุกคำสั่งต้องส่ง token ไปด้วยทุกครั้ง มิฉะนั้น API จะคืน error 401 Unauthorized

วิธีตั้งค่า Token

เปิดไฟล์ google_apps_script.gs หาบรรทัดนี้แล้วใส่รหัส Token ที่ต้องการ:

const API_TOKEN = 'ใส่รหัสอะไรก็ได้ตรงนี้';

จากนั้น Deploy ใหม่ (Deploy > Manage deployments > Edit > Deploy)

วิธีส่ง Token ไปกับคำสั่ง

แบบ GET (ต่อท้าย URL):

?action=list&token=รหัสที่ตั้งไว้

แบบ POST (ใน JSON body):

{ "action": "createFolder", "name": "ใบงาน", "token": "รหัสที่ตั้งไว้" }

การใช้ PHP (GoogleDriveAPI.php):

$drive = new GoogleDriveAPI('https://script.google.com/macros/s/.../exec');
$drive->setToken('รหัสที่ตั้งไว้');

1. ดูรายการไฟล์และโฟลเดอร์

ใช้ดูไฟล์และโฟลเดอร์ทั้งหมดใน Drive หรือในโฟลเดอร์ที่กำหนด

ดูไฟล์ทั้งหมดใน root

https://script.google.com/macros/s/AKfycbz3ENIijyea-6UgIWghQ62Sie2rsNsBLnpvGbh_NQnOuvV-Eot1ytR1Amcy-7CnM-2f/exec?action=list

ดูไฟล์ในโฟลเดอร์ที่กำหนด

https://script.google.com/macros/s/.../exec?action=list&folderId=1rg8UyC4uZiO7mTU4YkSug9_tdk4FiSHy

ผลลัพธ์ที่ได้

{
  "folder": { "id": "1rg8UyC4uZiO7mTU4YkSug9_tdk4FiSHy", "name": "technology file" },
  "files": [
    { "id": "xxx", "name": "เอกสาร.pdf", "mimeType": "application/pdf", "size": 102400, "url": "https://..." }
  ],
  "folders": [
    { "id": "yyy", "name": "ใบงานที่ 1" }
  ]
}

2. ค้นหาไฟล์

?action=search&search=ใบงาน

ค้นหาจากชื่อไฟล์ ส่งกลับเป็น array ของไฟล์ที่ตรงกับคำค้น

3. สร้างโฟลเดอร์ใหม่

ตัวอย่างเรียกด้วย curl:

curl -X POST "https://script.google.com/macros/s/.../exec" \
  -H "Content-Type: application/json" \
  -d '{"action":"createFolder","name":"ใบงานที่ 1"}'

4. อัปโหลดไฟล์

5. ลบไฟล์

ไฟล์จะถูกย้ายไปถังขยะ (สามารถกู้คืนได้จากถังขยะใน Google Drive)

curl -X POST "https://script.google.com/macros/s/.../exec" \
  -H "Content-Type: application/json" \
  -d '{"action":"delete","fileId":"1MGS7V7uoAl3kf1_5lULRyNAksxLN-9F8"}'

6. เปลี่ยนชื่อ

curl -X POST "https://script.google.com/macros/s/.../exec" \
  -H "Content-Type: application/json" \
  -d '{"action":"rename","fileId":"xxx","newName":"เอกสารฉบับใหม่.pdf"}'

7. ย้ายไฟล์ไปโฟลเดอร์อื่น

8. คัดลอกไฟล์

9. แชร์ไฟล์

10. ดูรายละเอียดไฟล์

?action=info&fileId=xxx

ส่งกลับข้อมูลชื่อไฟล์, ขนาด, ประเภท, URL, เจ้าของ, วันที่สร้าง-แก้ไข

11. ดูโครงสร้างโฟลเดอร์

?action=tree

แสดงโครงสร้างแบบต้นไม้ (tree) ทั้งหมดของ Drive

ตัวอย่างการเรียก API ด้วย PHP

ดาวน์โหลดไฟล์ GoogleDriveAPI.php แล้วนำไปใช้ในโปรเจกต์:

<?php
require_once 'GoogleDriveAPI.php';

$drive = new GoogleDriveAPI('https://script.google.com/macros/s/AKfycbz3ENIijyea-6UgIWghQ62Sie2rsNsBLnpvGbh_NQnOuvV-Eot1ytR1Amcy-7CnM-2f/exec');

// ดูรายการไฟล์
$data = $drive->listFiles();

// ดูในโฟลเดอร์ที่กำหนด
$data = $drive->listFiles('FOLDER_ID');

// ค้นหา
$data = $drive->searchFiles('ใบงาน');

// สร้างโฟลเดอร์
$drive->createFolder('ชื่อโฟลเดอร์', 'PARENT_FOLDER_ID');

// อัปโหลด (จาก path ในเครื่อง)
$drive->uploadFromPath('การบ้าน.pdf');

// อัปโหลด (จากตัวแปร content)
$drive->uploadFile('file.pdf', $content, 'application/pdf');

// เปลี่ยนชื่อ
$drive->renameFile('FILE_ID', 'ชื่อใหม่.pdf');

// ย้าย
$drive->moveFile('FILE_ID', 'TARGET_FOLDER_ID');

// คัดลอก
$drive->copyFile('FILE_ID', 'สำเนา', 'FOLDER_ID');

// แชร์
$drive->shareFile('FILE_ID', 'teacher@school.ac.th', 'reader');

// ลบ
$drive->deleteFile('FILE_ID');

// ดูรายละเอียดไฟล์
$info = $drive->getFileInfo('FILE_ID');

// ดูโครงสร้าง
$tree = $drive->getFolderTree();
?>

ตัวอย่างการเรียก API ด้วย JavaScript

const API = 'https://script.google.com/macros/s/AKfycbz3ENIijyea-6UgIWghQ62Sie2rsNsBLnpvGbh_NQnOuvV-Eot1ytR1Amcy-7CnM-2f/exec';

// ดูรายการไฟล์
fetch(API + '?action=list')
  .then(r => r.json())
  .then(console.log);

// สร้างโฟลเดอร์
fetch(API, {
  method: 'POST',
  body: JSON.stringify({ action: 'createFolder', name: 'ใบงานที่ 1' })
}).then(r => r.json()).then(console.log);

// อัปโหลดไฟล์
async function upload(file) {
  const b64 = btoa(String.fromCharCode(...new Uint8Array(await file.arrayBuffer())));
  return fetch(API, {
    method: 'POST',
    body: JSON.stringify({ action: 'upload', name: file.name, content: b64, mimeType: file.type })
  }).then(r => r.json());
}

// ลบไฟล์
fetch(API, {
  method: 'POST',
  body: JSON.stringify({ action: 'delete', fileId: 'FILE_ID' })
});

ตัวอย่างการเรียก API ด้วย Python

import requests, base64, json

API = 'https://script.google.com/macros/s/AKfycbz3ENIijyea-6UgIWghQ62Sie2rsNsBLnpvGbh_NQnOuvV-Eot1ytR1Amcy-7CnM-2f/exec'

# ดูรายการ
r = requests.get(API, params={'action': 'list'})
print(r.json())

# สร้างโฟลเดอร์
r = requests.post(API, json={'action': 'createFolder', 'name': 'ใบงาน'})

# อัปโหลด
with open('doc.pdf', 'rb') as f:
    content = base64.b64encode(f.read()).decode()
r = requests.post(API, json={
    'action': 'upload', 'name': 'doc.pdf',
    'content': content, 'mimeType': 'application/pdf'
})

# ลบ
r = requests.post(API, json={'action': 'delete', 'fileId': 'FILE_ID'})

ตัวอย่างการประยุกต์ใช้

<form method="POST" enctype="multipart/form-data">
  ชื่อ: <input name="name">
  ไฟล์: <input type="file" name="file">
  <button>ส่งการบ้าน</button>
</form>

<?php
require_once 'GoogleDriveAPI.php';
$drive = new GoogleDriveAPI('https://script.google.com/macros/s/.../exec');

if ($_POST) {
    $folder = $drive->createFolder($_POST['name']);
    $drive->uploadFromPath($_FILES['file']['tmp_name'], $folder['id']);
    echo "ส่งการบ้านสำเร็จ!";
}
?>