Authentification par compte de service - Google Sheets API for Laravel

​

Cas d’usage

• Accès de serveur à serveur — l’application accède à Sheets sans intervention de l’utilisateur
• Systèmes automatisés — jobs en arrière-plan, tâches cron, rapports automatiques
• Feuilles de calcul fixes — contrôle de feuilles de calcul spécifiques
• Environnement de production — fonctionne de manière fiable sans flux de consentement utilisateur

​

Prérequis

• Un projet Google Cloud Console
• Google Sheets API et Google Drive API activés
• Droits d’administration sur le projet

​

Configuration

# À ajouter au .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,
],

​

Utilisation

use Revolution\Google\Sheets\Facades\Sheets;

// Le compte de service est utilisé automatiquement
$values = Sheets::spreadsheet('your-spreadsheet-id')
    ->sheet('Sheet1')
    ->all();

// Référencer par nom de feuille de calcul (nécessite l'accès à Drive API)
$values = Sheets::spreadsheetByTitle('My Spreadsheet')
    ->sheet('Sheet1')
    ->all();

​

Bonnes pratiques de sécurité

​

1. Limiter les autorisations du compte de service

• Partagez uniquement les feuilles de calcul nécessaires
• Utilisez Éditeur plutôt que Propriétaire
• Auditez régulièrement les autorisations d’accès

​

2. Stockage sécurisé de la clé

• N’incluez pas la clé du compte de service dans le contrôle de version
• Excluez-la impérativement via .gitignore
• En production, stockez-la dans un emplacement sécurisé hors du web root
• Effectuez une rotation régulière des clés

​

3. Déploiement en production

• Stockez la clé JSON dans un emplacement sécurisé hors du web root
• Utilisez des comptes de service distincts par environnement (développement, staging, production)
• Surveillez l’utilisation de ces comptes dans la Google Cloud Console
• Journalisez et alertez sur les activités suspectes

​

Référence des variables d’environnement

​

Configuration avancée

​

Stocker la chaîne JSON dans une variable d’environnement

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),
],

​

Dépannage

​

Erreurs courantes

• Vérifiez que la feuille de calcul est bien partagée avec l’adresse e-mail du compte de service
• Pour les opérations d’écriture, vérifiez que les autorisations sont au moins Éditeur

• Vérifiez que le chemin du fichier JSON est correct
• Vérifiez que le fichier existe et est lisible par le serveur web

• Vérifiez que Google Sheets API et Google Drive API sont activés dans la Google Cloud Console
• Attendez quelques minutes après l’activation de l’API

• Vérifiez que le fichier de clé JSON est valide et non corrompu
• Vérifiez que le compte de service n’a pas été supprimé ou désactivé
• Vérifiez que l’ID du projet correspond bien au projet Google Cloud

​

Tester la configuration

// routes/web.php
Route::get('/test-sheets', function () {
    try {
        $sheets = Sheets::spreadsheetList();
        return response()->json([
            'status' => 'success',
            'message' => 'L\'authentification par compte de service fonctionne',
            'spreadsheet_count' => count($sheets)
        ]);
    } catch (\Exception $e) {
        return response()->json([
            'status' => 'error',
            'message' => $e->getMessage()
        ]);
    }
});