"""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