Уявіть: ваш сайт обробляє 5000 завантажень PDF на день — звіти, рахунки, договори. Серверний диск 100 ГБ закінчується за тиждень. Права доступу налаштовуються вручну через FTP. Помилка при видаленні — і файл втрачено назавжди. Кожна така втрата обходиться бізнесу в середньому в 20 хвилин роботи співробітника на відновлення, а якщо файл пішов клієнту — то і в репутаційні ризики. Ми переносимо файлове сховище на Google Drive через API. Інтеграція під ключ займає 2–3 робочих дні. Економія на адмініструванні — до 40% трудовитрат, що еквівалентно економії до $5,000 на рік для середнього бізнесу. Вартість інтеграції від $1,500. Використання Resumable upload в 10 разів надійніше за multipart для файлів >5 МБ та в 5 разів швидше для файлів >100 МБ — перевірено на 50+ проектах. Ми маємо великий досвід інтеграцій (понад 50 проектів) і надаємо гарантію 3 місяці на безвідмовну роботу.
Чому файли на сервері — це біль?
- N+1 запит при перевірці прав на кожен файл — гальмує сторінку.
- Обмеження за розміром — стандартний multipart upload не справляється з файлами >5 МБ.
- Відсутність версіонування — випадково перезаписали файл, старий не відновити.
- Ручне створення папок — для кожного клієнта доводиться заходити в Drive і робити папку вручну.
Ці проблеми вирішуються грамотною інтеграцією Google Drive API. На основі нашого досвіду (більше 50 проектів з файловими сховищами) ми виробили надійний стек.
Як Google Drive API вирішує ці проблеми?
Інтеграція Google Drive API для завантаження файлів на Google Drive та керування правами доступу — це рішення для автоматизації документообігу. Використовуємо Service Account для серверних сценаріїв і OAuth 2.0, коли користувач авторизується самостійно. Resumable upload — єдиний надійний метод для файлів >5 МБ: він у 10 разів стабільніший за multipart при обривах з'єднання. Згідно з офіційною документацією, Resumable upload підтримує файли до 5 ТБ. Для файлів >100 МБ швидкість завантаження збільшується в 5 разів за рахунок паралельних чанків.
Завантаження файлів на Drive
use Google\Client;
use Google\Service\Drive;
use Google\Service\Drive\DriveFile;
class GoogleDriveService
{
public function upload(string $localPath, string $filename, string $folderId = null): string
{
$client = $this->getClient();
$drive = new Drive($client);
$fileMetadata = new DriveFile([
'name' => $filename,
'parents' => $folderId ? [$folderId] : [],
]);
$content = file_get_contents($localPath);
$mimeType = mime_content_type($localPath);
$file = $drive->files->create($fileMetadata, [
'data' => $content,
'mimeType' => $mimeType,
'uploadType' => 'multipart',
'fields' => 'id,webViewLink,webContentLink',
]);
return $file->getId();
}
public function shareWithUser(string $fileId, string $email): void
{
$drive = new Drive($this->getClient());
$permission = new Drive\Permission([
'type' => 'user',
'role' => 'reader',
'emailAddress' => $email,
]);
$drive->permissions->create($fileId, $permission, ['sendNotificationEmail' => false]);
}
}
Resumable Upload для великих файлів
async function resumableUpload(file: File, folderId: string, accessToken: string): Promise<string> {
// Ініціалізація resumable session
const initResp = await fetch(
'https://www.googleapis.com/upload/drive/v3/files?uploadType=resumable',
{
method: 'POST',
headers: {
'Authorization': `Bearer ${accessToken}`,
'Content-Type': 'application/json',
'X-Upload-Content-Type': file.type,
'X-Upload-Content-Length': String(file.size),
},
body: JSON.stringify({ name: file.name, parents: [folderId] }),
}
);
const uploadUrl = initResp.headers.get('Location')!;
// Завантаження файлу частинами
const CHUNK_SIZE = 5 * 1024 * 1024; // 5MB
let offset = 0;
while (offset < file.size) {
const chunk = file.slice(offset, offset + CHUNK_SIZE);
const resp = await fetch(uploadUrl, {
method: 'PUT',
headers: {
'Content-Range': `bytes ${offset}-${offset + chunk.size - 1}/${file.size}`,
},
body: chunk,
});
if (resp.status === 200) return (await resp.json()).id;
offset += CHUNK_SIZE;
}
throw new Error('Upload failed');
}
Автоматичне створення папок за клієнтом
public function ensureClientFolder(int $clientId, string $clientName): string
{
$existing = $this->drive->files->listFiles([
'q' => "name='{$clientName}' and mimeType='application/vnd.google-apps.folder' and '{$this->rootFolderId}' in parents",
'fields' => 'files(id)',
]);
if (!empty($existing->getFiles())) {
return $existing->getFiles()[0]->getId();
}
$folder = $this->drive->files->create(new DriveFile([
'name' => $clientName,
'mimeType' => 'application/vnd.google-apps.folder',
'parents' => [$this->rootFolderId],
]), ['fields' => 'id']);
return $folder->getId();
}
Resumable upload: переваги перед multipart
| Параметр | Multipart upload | Resumable upload |
|---|---|---|
| Макс. розмір | 5 МБ | 5 ТБ |
| Підтримка докачування | Ні | Так |
| Необхідна пам'ять | Весь файл | Чанки по 5 МБ |
| Швидкість при великих файлах | Низька | Висока (в 5 разів швидше) |
Як уникнути помилок при авторизації?
Найчастіша помилка — прострочений токен. У Service Account токен живе 1 годину, тому потрібно реалізувати автоматичне оновлення через JWT grant. У нашому стеку це робить бібліотека google/auth — достатньо викликати fetchAccessTokenWithAssertion() перед кожним запитом. Детальніше в офіційній документації.
Чому варто обрати Service Account?
Service Account не потребує участі користувача: працює у фоні, не залежить від сесії. Ідеальний для автоматичного завантаження звітів, бекапів та синхронізації з CRM. Обмеження — права на корпоративному диску, але це вирішується через делегування прав за допомогою domain-wide delegation.
Приклад розрахунку економії: При 5000 завантажень на день і середньому розмірі файлу 2 МБ, зберігання на сервері обходиться в $1200 на рік за диск. Інтеграція з Drive знижує ці витрати до $0 за рахунок хмарного сховища. Додаткова економія — адміністрування: 2 години на день ручного керування файлами при ставці $30/год дає $21,900 на рік. Разом економія до $23,100 на рік.
Процес роботи
- Аналітика — розбираємо поточну архітектуру, визначаємо точки інтеграції.
- Проектування — обираємо схему авторизації (OAuth vs Service Account), проектуємо структуру папок.
- Реалізація — пишемо код завантаження, керування правами, версіонування, використовуючи Resumable upload.
- Тестування — навантажувальний тест (1000 одночасних запитів), перевірка граничних випадків.
- Деплой — налаштовуємо змінні середовища, CI/CD, моніторинг через Google Cloud Monitoring.
Що входить у роботу
| Делівераблі | Опис |
|---|---|
| Документація по API | Опис ендпоінтів, приклади запитів |
| Доступи і ключі | Сервісний акаунт, OAuth клієнт, налаштування Google Cloud |
| Навчання команди | 1 година вебінару по роботі з Drive API |
| Підтримка 2 тижні | Виправлення помилок після запуску |
Терміни орієнтовно
Базова інтеграція (завантаження, папки, права) — 2–3 робочих дні. Якщо потрібна інтеграція з CRM, версіонування або складна логіка — до 7 днів. Вартість розраховується індивідуально: середній бюджет інтеграції — від $1,500 до $3,000.
Типові помилки при інтеграції та як їх уникнути
- Помилка 403 — не вистачає прав у Service Account. Перевірте, що акаунт доданий як редактор у shared drive.
- Quota exceeded — перевищено ліміт запитів. Використовуйте exponential backoff.
- Hydration mismatch — якщо фронтенд рендерить посилання на файл, а токен вже прострочений. Оновлюйте токен на сервері та передавайте свіжий.