Google OAuth 2.0認証でリフレッシュトークンの取得を制御するパラメーター。

online（デフォルト）

• アクセストークンのみ取得
• ユーザーがアクティブな間のみ有効
• 通常1時間で期限切れ
• 再認証が必要

offline

• アクセストークン + リフレッシュトークンを取得
• ユーザーがオフライン時でもAPI呼び出し可能
• リフレッシュトークンでアクセストークンを自動更新
• 長期間のアクセスが可能
• 初回認証時に詳細な権限確認画面が表示される

用途

• バックグラウンド処理
• 定期的なデータ同期
• ユーザー不在時のAPI操作

注意点

• offlineはユーザーの明示的な同意が必要
• リフレッシュトークンは安全に保存する必要がある
• セキュリティリスクを考慮した実装が重要