目的

Google Drive の 特定フォルダ内の画像を取得し、Blade で表示する。

前提

Laravel 8〜11
PHP 8.x
課金なし
個人 or 小規模利用
Google Drive 読み取り専用

STEP 1. OAuth 接続の動作確認（Drive API はまだ使わない）

1. Google Cloud 側の設定

1-1. プロジェクト作成

Google Cloud Console
新規プロジェクト作成

1-2. OAuth 同意画面

ユーザータイプ：外部（External）
公開ステータス：テスト
テストユーザー：自分の Gmail を追加
審査：不要（Drive read-only のみ）

1-3. OAuth クライアント ID

種類：Web アプリケーション
承認済みのリダイレクト URI

http://127.0.0.1:8000/auth/google/callback

※ JavaScript 生成元は不要

2. Laravel 側の準備

2-1. パッケージインストール

composer require laravel/socialite
composer require google/apiclient:^2.0

3. 環境変数（.env）

GOOGLE_CLIENT_ID=xxxxx.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=xxxxx
GOOGLE_REDIRECT_URI=http://127.0.0.1:8000/auth/google/callback

4. config/services.php

'google' => [
    'client_id' => env('GOOGLE_CLIENT_ID'),
    'client_secret' => env('GOOGLE_CLIENT_SECRET'),
    'redirect' => env('GOOGLE_REDIRECT_URI'),
],

設定後：

php artisan config:clear

5. OAuth 用 Controller（動作確認用）

namespace App\Http\Controllers;

use Laravel\Socialite\Facades\Socialite;

class GoogleAuthController extends Controller
{
    public function redirect()
    {
        return Socialite::driver('google')
            ->scopes(['https://www.googleapis.com/auth/drive.readonly'])
            ->redirect();
    }

    public function callback()
    {
        return 'callback ok';
    }
}

6. ルーティング

use App\Http\Controllers\GoogleAuthController;

Route::get('/auth/google', [GoogleAuthController::class, 'redirect']);
Route::get('/auth/google/callback', [GoogleAuthController::class, 'callback']);

7. 動作確認

ブラウザでアクセス
```
http://127.0.0.1:8000/auth/google
```
Google ログイン & 権限許可
以下が表示されれば成功
```
callback ok
```

→ ここまでで OAuth 接続は成功

STEP 2. 実際に Google Drive から画像を取得するための追加設定

※ ここから初めて Drive API を使う

1. Google Drive API を有効化

API とサービス → ライブラリ
Google Drive API を有効化

※ OAuth が通っていても、これが無いと取得不可

2. Drive の読み取り権限（すでに設定済み）

以下は OAuth リダイレクト時に設定する。

->scopes(['https://www.googleapis.com/auth/drive.readonly'])

※ callback に書いても意味はない

3. 対象フォルダの共有設定

OAuth でログインする Google アカウントが

フォルダの 閲覧権限を持っていること

4. フォルダIDを取得・設定

フォルダID取得

https://drive.google.com/drive/folders/【ここ】

.env に設定

GOOGLE_DRIVE_FOLDER_ID=xxxxxxxxxxxxxxxxxxxx

5. callback でアクセストークンを取得

public function callback()
{
    $googleUser = Socialite::driver('google')->user();
    $accessToken = $googleUser->token;

    // ここから Drive API を呼び出す
}

→ この token を使って files.list を実行する

よくハマるポイントまとめ

症状	原因
redirect_uri_mismatch	Google 側と .env が完全一致していない
org_internal / ブロック	OAuth が内部 or テストユーザー未登録
Socialite::user() で No message	callback 以外で呼んでいる
画像が0件	フォルダID違い / 共有不足 / 直下に画像なし
403	Drive API 未有効

補足：課金について

Drive API read-only は無料
アクセス数が増えても 課金されない
制限はレート制限のみ

まとめ

OAuth 接続確認（callback ok）と
Google Drive からのファイル取得は別工程
Drive API 有効化・フォルダ共有・フォルダID設定を行うことで
初めて画像取得が可能になる。

無事接続できたので、実際に画像取得してくぞーー

一旦ここまで、ではまた