46dc038e26
RefreshError showed only a generic message; include Google's error code and explain client ID/secret mismatch (unauthorized_client). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
185 lines
9.7 KiB
Python
185 lines
9.7 KiB
Python
"""Google 슬라이드(회의록 보드) 공통 계층 — 공유 드라이브 폴더에 빈 슬라이드를 만들거나 찾는다.
|
|
|
|
인증은 google_sheets 와 같은 설정을 쓰되 권한 범위(scope)가 다르다(Drive + Slides).
|
|
설정된 쪽을 자동 선택(서비스 계정 우선).
|
|
|
|
1) 사용자 OAuth 리프레시 토큰
|
|
· `GOOGLE_SLIDES_OAUTH_REFRESH_TOKEN` — 없으면 `GOOGLE_SHEETS_OAUTH_REFRESH_TOKEN`
|
|
토큰은 Drive·Slides 권한까지 받아야 한다: `python scripts/google_sheets_authorize.py`(스프레드시트·Drive·Slides 한 번에)
|
|
· `GOOGLE_SHEETS_OAUTH_CLIENT_ID` / `..._SECRET`(없으면 로그인용 `GOOGLE_CLIENT_ID` / `GOOGLE_CLIENT_SECRET`)
|
|
2) 서비스 계정 JSON — `GOOGLE_SHEETS_CREDENTIALS` / `GOOGLE_SHEETS_CREDENTIALS_JSON`
|
|
서비스 계정 이메일을 대상 공유 드라이브의 **콘텐츠 관리자** 이상으로 추가해야 한다.
|
|
|
|
- 회의록 보드 폴더: `MEETING_BOARD_FOLDER_ID`(기본 = 회의록 보드 공유 드라이브).
|
|
- 같은 주차 보드를 다시 누르면 새로 만들지 않고 Drive 파일 appProperties(`dbxMeetingWeek` = 주차 시작일)로 찾는다
|
|
— 파일 이름을 바꿔도 같은 보드가 열린다. 휴지통에 버리면 다음에 새로 만든다.
|
|
- 비밀값(키/토큰)은 로그·화면에 절대 출력하지 않는다. 라이브러리·설정이 없으면 `enabled = False`.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import json
|
|
import os
|
|
import re
|
|
import threading
|
|
from typing import Any
|
|
|
|
SCOPES = ["https://www.googleapis.com/auth/drive", "https://www.googleapis.com/auth/presentations"]
|
|
TOKEN_URI = "https://oauth2.googleapis.com/token"
|
|
DEFAULT_BOARD_FOLDER_ID = "0AGF3CIEboPQiUk9PVA"
|
|
PRESENTATION_MIME = "application/vnd.google-apps.presentation"
|
|
WEEK_KEY = "dbxMeetingWeek"
|
|
|
|
# googleapiclient 의 HTTP 클라이언트는 스레드 안전하지 않고, 같은 주차를 두 사람이 동시에 누르면
|
|
# 보드가 두 개 생길 수 있으므로 찾기·만들기는 한 번에 하나씩.
|
|
_LOCK = threading.Lock()
|
|
|
|
|
|
class GoogleSlidesError(RuntimeError):
|
|
"""화면에 보여도 되는 사유(비밀값 없음)."""
|
|
|
|
|
|
def board_folder_id() -> str:
|
|
return (os.getenv("MEETING_BOARD_FOLDER_ID") or "").strip() or DEFAULT_BOARD_FOLDER_ID
|
|
|
|
|
|
def board_url(file_id: str) -> str:
|
|
return f"https://docs.google.com/presentation/d/{file_id}/edit"
|
|
|
|
|
|
class GoogleSlidesClient:
|
|
def __init__(self) -> None:
|
|
self.enabled = False
|
|
self.reason = ""
|
|
self.auth_mode = ""
|
|
self._drive: Any = None
|
|
self._slides: Any = None
|
|
try:
|
|
from googleapiclient.discovery import build
|
|
except ImportError:
|
|
self.reason = "google-api-python-client 미설치"
|
|
return
|
|
creds = self._service_account_creds()
|
|
if creds is None:
|
|
creds = self._oauth_creds()
|
|
if creds is None:
|
|
if not self.reason:
|
|
self.reason = "Google 인증 미설정(GOOGLE_SLIDES_OAUTH_REFRESH_TOKEN 또는 GOOGLE_SHEETS_* 설정 필요)"
|
|
return
|
|
try:
|
|
self._drive = build("drive", "v3", credentials=creds, cache_discovery=False)
|
|
self._slides = build("slides", "v1", credentials=creds, cache_discovery=False)
|
|
except Exception as exc: # noqa: BLE001 — 사유만(비밀값 미출력)
|
|
self.reason = f"Google 클라이언트 생성 실패: {type(exc).__name__}"
|
|
return
|
|
self.enabled = True
|
|
|
|
# ── 인증(google_sheets 와 같은 설정, 범위만 Drive·Slides) ──
|
|
def _service_account_creds(self) -> Any:
|
|
raw = (os.getenv("GOOGLE_SHEETS_CREDENTIALS_JSON") or "").strip()
|
|
path = (os.getenv("GOOGLE_SHEETS_CREDENTIALS") or "").strip()
|
|
if not raw and not path:
|
|
return None
|
|
try:
|
|
info = json.loads(raw) if raw else json.loads(open(path, encoding="utf-8").read())
|
|
from google.oauth2.service_account import Credentials
|
|
|
|
creds = Credentials.from_service_account_info(info, scopes=SCOPES)
|
|
except Exception as exc: # noqa: BLE001
|
|
self.reason = f"서비스 계정 인증 실패: {type(exc).__name__}"
|
|
return None
|
|
self.auth_mode = "service_account"
|
|
return creds
|
|
|
|
def _oauth_creds(self) -> Any:
|
|
token = (os.getenv("GOOGLE_SLIDES_OAUTH_REFRESH_TOKEN") or os.getenv("GOOGLE_SHEETS_OAUTH_REFRESH_TOKEN") or "").strip()
|
|
if not token:
|
|
return None
|
|
cid = (os.getenv("GOOGLE_SHEETS_OAUTH_CLIENT_ID") or os.getenv("GOOGLE_CLIENT_ID") or "").strip()
|
|
secret = (os.getenv("GOOGLE_SHEETS_OAUTH_CLIENT_SECRET") or os.getenv("GOOGLE_CLIENT_SECRET") or "").strip()
|
|
if not cid or not secret:
|
|
self.reason = "GOOGLE_SHEETS_OAUTH_CLIENT_ID/SECRET 미설정"
|
|
return None
|
|
try:
|
|
from google.oauth2.credentials import Credentials
|
|
|
|
creds = Credentials(token=None, refresh_token=token, token_uri=TOKEN_URI,
|
|
client_id=cid, client_secret=secret, scopes=SCOPES)
|
|
except Exception as exc: # noqa: BLE001
|
|
self.reason = f"OAuth 자격 생성 실패: {type(exc).__name__}"
|
|
return None
|
|
self.auth_mode = "oauth"
|
|
return creds
|
|
|
|
# ────────────────────────────────────────────────
|
|
def open_week_board(self, *, folder_id: str, week_key: str, title: str) -> dict[str, Any]:
|
|
"""그 주차 보드(빈 슬라이드)를 찾고, 없으면 폴더에 만든다 → {id, url, created}."""
|
|
if not self.enabled:
|
|
raise GoogleSlidesError(self.reason or "Google 슬라이드 연동이 꺼져 있습니다.")
|
|
with _LOCK:
|
|
try:
|
|
found = self._find(folder_id, week_key)
|
|
if found:
|
|
return {"id": found, "url": board_url(found), "created": False}
|
|
file_id = self._create_blank(folder_id, week_key, title)
|
|
except GoogleSlidesError:
|
|
raise
|
|
except Exception as exc: # noqa: BLE001
|
|
raise GoogleSlidesError(_friendly(exc)) from None
|
|
return {"id": file_id, "url": board_url(file_id), "created": True}
|
|
|
|
def _find(self, folder_id: str, week_key: str) -> str | None:
|
|
q = (f"'{folder_id}' in parents and trashed = false and mimeType = '{PRESENTATION_MIME}' "
|
|
f"and appProperties has {{ key='{WEEK_KEY}' and value='{week_key}' }}")
|
|
res = self._drive.files().list(
|
|
q=q, fields="files(id)", pageSize=1, supportsAllDrives=True, includeItemsFromAllDrives=True,
|
|
corpora="allDrives",
|
|
).execute()
|
|
files = res.get("files") or []
|
|
return files[0]["id"] if files else None
|
|
|
|
def _create_blank(self, folder_id: str, week_key: str, title: str) -> str:
|
|
meta = {"name": title, "mimeType": PRESENTATION_MIME, "parents": [folder_id],
|
|
"appProperties": {WEEK_KEY: week_key}}
|
|
file_id = self._drive.files().create(body=meta, fields="id", supportsAllDrives=True).execute()["id"]
|
|
# 새 프레젠테이션의 첫 장은 "제목·부제목" 틀(TITLE 레이아웃) — 틀 없는 빈 장(BLANK) 하나만 남긴다
|
|
pres = self._slides.presentations().get(presentationId=file_id, fields="slides.objectId").execute()
|
|
reqs: list[dict[str, Any]] = [{"createSlide": {"insertionIndex": 0, "slideLayoutReference": {"predefinedLayout": "BLANK"}}}]
|
|
reqs += [{"deleteObject": {"objectId": s["objectId"]}} for s in pres.get("slides") or []]
|
|
self._slides.presentations().batchUpdate(presentationId=file_id, body={"requests": reqs}).execute()
|
|
return file_id
|
|
|
|
|
|
def _friendly(exc: Exception) -> str:
|
|
"""Google API 오류 → 화면용 문구(비밀값·원문 응답 미포함)."""
|
|
status = getattr(getattr(exc, "resp", None), "status", None)
|
|
text = str(exc)
|
|
# 토큰 갱신 실패(RefreshError) — Google 이 준 OAuth 오류 코드(비밀값 아님)를 보여 원인을 바로 알 수 있게
|
|
m = re.search(r"\b(invalid_scope|invalid_grant|invalid_client|unauthorized_client|deleted_client|access_denied|invalid_request)\b", text)
|
|
code = m.group(1) if m else ""
|
|
if code in ("unauthorized_client", "invalid_client", "deleted_client"):
|
|
return (f"Google 토큰 갱신 실패({code}) — 토큰을 발급한 OAuth 클라이언트와 서버 .env 의 "
|
|
"GOOGLE_SHEETS_OAUTH_CLIENT_ID/SECRET(없으면 GOOGLE_CLIENT_ID/SECRET)이 다릅니다.")
|
|
if "invalid_scope" in text or "insufficient" in text.lower() or "ACCESS_TOKEN_SCOPE_INSUFFICIENT" in text:
|
|
return "Google 권한(Drive·Slides)이 없는 토큰입니다. 토큰을 다시 발급해 주세요(scripts/google_sheets_authorize.py)."
|
|
if "invalid_grant" in text:
|
|
return "Google 토큰이 만료·폐기되었습니다. 토큰을 다시 발급해 주세요."
|
|
if status == 404:
|
|
return "회의록 보드 폴더를 찾을 수 없습니다(MEETING_BOARD_FOLDER_ID·공유 드라이브 접근 권한 확인)."
|
|
if status == 403:
|
|
return "Google Drive·Slides 접근이 거부되었습니다(API 사용 설정·공유 드라이브 권한 확인)."
|
|
return f"Google 슬라이드 처리 실패({type(exc).__name__}{f' {status}' if status else ''}{f' {code}' if code else ''})."
|
|
|
|
|
|
_CLIENT: GoogleSlidesClient | None = None
|
|
_CLIENT_LOCK = threading.Lock()
|
|
|
|
|
|
def get_client() -> GoogleSlidesClient:
|
|
"""프로세스당 하나(설정이 비어 있으면 매번 다시 확인 — .env 를 고치고 재시작 없이도 사유가 갱신되게)."""
|
|
global _CLIENT
|
|
with _CLIENT_LOCK:
|
|
if _CLIENT is None or not _CLIENT.enabled:
|
|
_CLIENT = GoogleSlidesClient()
|
|
return _CLIENT
|