Service Account-authenticatie - Google Sheets API for Laravel

​

Gebruiksscenario’s

• Server-naar-server-toegang — de app benadert Sheets zonder gebruikersactie
• Geautomatiseerde systemen — achtergrondjobs, crontaken, automatische rapporten
• Vaste spreadsheets — beheer van specifieke spreadsheets
• Productieomgevingen — betrouwbare werking zonder toestemmingsflow voor gebruikers

​

Vereisten

• Google Cloud Console-project
• Google Sheets API en Google Drive API ingeschakeld
• Beheerdersrechten voor het project

​

Installatie

# Toevoegen aan .gitignore
storage/app/google-service-account.json

GOOGLE_SERVICE_ENABLED=true
GOOGLE_SERVICE_ACCOUNT_JSON_LOCATION=storage/app/google-service-account.json

'scopes' => [
    \Google\Service\Sheets::SPREADSHEETS,
    \Google\Service\Drive::DRIVE,
],

​

Gebruik

use Revolution\Google\Sheets\Facades\Sheets;

// Het Service Account wordt automatisch gebruikt
$values = Sheets::spreadsheet('your-spreadsheet-id')
    ->sheet('Sheet1')
    ->all();

// Verwijzen op spreadsheetnaam (vereist toegang tot de Drive API)
$values = Sheets::spreadsheetByTitle('My Spreadsheet')
    ->sheet('Sheet1')
    ->all();

​

Best practices voor beveiliging

​

1. Rechten van het Service Account beperken

• Deel alleen de spreadsheets die nodig zijn
• Gebruik Bewerker in plaats van Eigenaar
• Controleer de toegangsrechten regelmatig

​

2. Keys veilig bewaren

• Neem Service Account-keys niet op in versiebeheer
• Sluit ze betrouwbaar uit via .gitignore
• Sla ze in productie op een veilige plek buiten de webroot op
• Roteer keys regelmatig

​

3. Uitrol naar productie

• Sla de JSON-key op een veilige plek buiten de webroot op
• Gebruik per omgeving een ander Service Account (ontwikkeling, staging, productie)
• Monitor het gebruik van deze accounts in de Google Cloud Console
• Log verdachte activiteit en stel waarschuwingen in

​

Referentie omgevingsvariabelen

​

Geavanceerde configuratie

​

JSON-string opslaan in een omgevingsvariabele

GOOGLE_SERVICE_ENABLED=true
GOOGLE_SERVICE_ACCOUNT_JSON_LOCATION='{"type": "service_account", "project_id": "your-project-id", ...}'

// config/google.php
'service' => [
    'enable' => env('GOOGLE_SERVICE_ENABLED', false),
    'file' => json_decode(env('GOOGLE_SERVICE_ACCOUNT_JSON_LOCATION', ''), true),
],

​

Problemen oplossen

​

Veelvoorkomende fouten

• Controleer of de spreadsheet is gedeeld met het e-mailadres van het Service Account
• Controleer bij schrijfoperaties of de rechten minimaal Bewerker zijn

• Controleer of het pad naar het JSON-bestand klopt
• Controleer of het bestand bestaat en door de webserver kan worden gelezen

• Controleer of de Google Sheets API en Google Drive API zijn ingeschakeld in de Google Cloud Console
• Wacht na het inschakelen van de API’s enkele minuten

• Controleer of het JSON-keybestand geldig en niet beschadigd is
• Controleer of het Service Account niet is verwijderd of uitgeschakeld
• Controleer of het project-ID overeenkomt met je Google Cloud-project

​

Setup testen

// routes/web.php
Route::get('/test-sheets', function () {
    try {
        $sheets = Sheets::spreadsheetList();
        return response()->json([
            'status' => 'success',
            'message' => 'Service Account-authenticatie werkt',
            'spreadsheet_count' => count($sheets)
        ]);
    } catch (\Exception $e) {
        return response()->json([
            'status' => 'error',
            'message' => $e->getMessage()
        ]);
    }
});