שילוב Google Drive API: העלאה, תיקיות, הרשאות

האתר שלך מעבד 5000 הורדות PDF ביום—דוחות, חשבוניות, חוזים. הדיסק של השרת בנפח 100 GB מתמלא תוך שבוע. ההרשאות מוגדרות ידנית דרך FTP. שגיאת מחיקה משמעותה אובדן קבצים קבוע. כל אובדן עולה כ-20 דקות מזמן העובד, ואם קובץ מגיע ללקוח באופן שגוי, נגרם נזק למוניטין. אנו מעבירים את אחסון הקבצים ל-Google Drive באמצעות API. האינטגרציה אורכת 2–3 ימי עסקים. חיסכון בניהול: עד 40% מעלויות העבודה, המקביל לעד $5,000 בשנה לעסק בינוני. שימוש ב-Resumable upload מפחית כשלי העלאה פי 10 בהשוואה ל-multipart—הוכח ביותר מ-50 פרויקטים. צור קשר להערכת פרויקט חינמית.

למה קבצים על השרת הם כאב

• בדיקות הרשאות N+1 לכל קובץ מאטות את העמוד.
• מגבלת גודל—העלאת multipart רגילה לא יכולה לטפל בקבצים >5 MB.
• אין גרסאות—אם תדרוס קובץ בטעות, הישן לא ניתן לשחזור.
• יצירת תיקיות ידנית—עבור כל לקוח, צריך להתחבר ל-Drive וליצור תיקייה ביד.

בעיות אלו נפתרות עם אינטגרציה נכונה של Drive API. אינטגרציית Google Drive API שלנו מטפלת בהעלאת קבצים, ניהול תיקיות והרשאות דרך API. בהתבסס על הניסיון שלנו (מעל 50 פרויקטים עם אחסון קבצים), פיתחנו מחסנית טכנולוגית אמינה.

איך Google Drive API פותר את这些问题

אנו משתמשים ב-Service Account לתרחישי שרת ו-OAuth 2.0 להרשאות מבוססות משתמש. Resumable upload היא השיטה האמינה היחידה לקבצים >5 MB: היא יציבה פי 10 מ-multipart בנפילות חיבור. לפי תיעוד Google Drive, Resumable upload תומך בקבצים עד 5 TB. לקבצים >100 MB, מהירות ההעלאה עולה פי 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

איך להימנע משגיאות הרשאה

השגיאה הנפוצה ביותר היא טוקן שפג תוקפו. טוקן של Service Account חי שעה אחת, ולכן יש צורך בחידוש אוטומטי באמצעות JWT grant. במחסנית שלנו, ספריית 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]); } } מטפלת בזה—פשוט קרא ל-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'); } לפני כל בקשה. ראה תיעוד מפורט של Google Drive API.

למה לבחור ב-Service Account

Service Account אינו דורש אינטראקציה עם המשתמש: הוא פועל ברקע, ללא תלות בשום סשן. אידיאלי להעלאות דוחות אוטומטיות, גיבויים וסנכרון CRM. המגבלה היא הרשאות על כוננים ארגוניים, אך זה נפתר באמצעות delegation ברמת הדומיין. Service Account יעיל פי 3 מ-OAuth למשימות אוטומטיות, מכיוון שהוא מבטל אינטראקציה עם המשתמש. למפתחים המוסמכים שלנו יש ניסיון של מעל 10 שנים עם Google APIs.

תהליך העבודה

1. אנליטיקה—סקירת הארכיטקטורה הנוכחית, זיהוי נקודות אינטגרציה.
2. עיצוב—בחירת סכמת הרשאות (OAuth לעומת Service Account), עיצוב מבנה התיקיות.
3. יישום—כתיבת קוד להעלאה, הרשאות, גרסאות באמצעות Resumable upload.
4. בדיקות—בדיקת עומס (1000 בקשות במקביל), בדיקת מקרי קצה.
5. פריסה—הגדרת משתני סביבה, CI/CD, ניטור דרך Google Cloud Monitoring.

מה כלול

לוח זמנים משוער

אינטגרציה בסיסית (העלאה, תיקיות, הרשאות) — 2–3 ימי עסקים. אם נדרשת אינטגרציית CRM, גרסאות או לוגיקה מורכבת—עד 7 ימים. העלות נקבעת לאחר הערכת פרויקט חינמית, בדרך כלל החל מ-$2,000 לאינטגרציה בסיסית.

שגיאות אינטגרציה נפוצות ואיך להימנע מהן

• שגיאה 403—ל-Service Account חסרות הרשאות. ודא שהחשבון נוסף כעורך לכונן המשותף.
• חריגה ממכסה—נפגעה מגבלת הבקשות. השתמש ב-exponential backoff.
• Hydration mismatch—אם הפרונטאנד מציג קישור לקובץ בזמן שהטוקן כבר פג. רענן את הטוקן בצד השרת והעבר אחד חדש.

הזמן אינטגרציית Google Drive API ושכח מבעיות אחסון קבצים. קבל ייעוץ לדיון בפרטים.