def style

sheet_service.py

@@ -16,7 +16,7 @@ class SheetService:
     """
     SCOPES = ['https://www.googleapis.com/auth/spreadsheets']
 
-    def __init__(self, service_account_key_string: str, api_service_name: str = 'sheets', api_version: str = 'v4'):
+    def __init__(self, service_account_key_string, api_service_name='sheets', api_version='v4'):
         """
         初始化 SheetService。
 
@@ -65,7 +65,7 @@ class SheetService:
             gid = 0
         return spreadsheet_id, gid
 
-    def get_sheet_id_by_url(self, sheet_url: str) -> str | None:
+    def get_sheet_id_by_url(self, sheet_url):
         """
         從 Google Sheets URL 中提取試算表 ID。
         """
@@ -81,7 +81,7 @@ class SheetService:
             logging.warning(f"無法從 URL 中提取有效的 Spreadsheet ID: {sheet_url}")
             return None
 
-    def get_sheet_gid_by_url(self, sheet_url: str) -> int | None:
+    def get_sheet_gid_by_url(self, sheet_url):
         """
         從 Google Sheets URL 中提取 gid (工作表分頁 ID)。
         返回整數型別的 gid 或 None (如果未指定則返回 0)。
@@ -90,7 +90,7 @@ class SheetService:
         # 即使 gid 是 0 (預設)，也將其視為有效的 gid
         return gid
 
-    def get_sheet_name_by_gid(self, spreadsheet_id: str, gid: int | None) -> str | None:
+    def get_sheet_name_by_gid(self, spreadsheet_id, gid):
         """
         使用 spreadsheetId 和 gid 獲取工作表名稱 (title)。
         如果 gid 為 None，則返回第一個工作表的名稱 (gid=0)。
@@ -134,7 +134,7 @@ class SheetService:
             logging.error(f"獲取工作表名稱時發生 API 錯誤 (ID: {spreadsheet_id}, GID: {target_gid}): {e}")
             return None
 
-    def get_sheet_name_by_url(self, sheet_url: str) -> str | None:
+    def get_sheet_name_by_url(self, sheet_url):
         """
         從 Google Sheets URL 中提取 gid 並獲取對應的工作表名稱。
         """
@@ -145,7 +145,7 @@ class SheetService:
         # 直接調用已有的 get_sheet_name_by_gid 方法
         return self.get_sheet_name_by_gid(spreadsheet_id, gid)
 
-    def get_sheet_data_by_url(self, sheet_url: str, read_range: str | None = None) -> list | None:
+    def get_sheet_data_by_url(self, sheet_url, read_range=None):
         """
         通過 Google Sheets URL 自動獲取 Spreadsheet ID 和工作表名稱，並讀取數據。
         如果 URL 中包含 gid，則讀取對應的工作表；否則讀取第一個工作表。
@@ -194,7 +194,7 @@ class SheetService:
         # 使用現有的 get_sheet_value 方法讀取數據
         return self.get_sheet_value(spreadsheet_id, range_name)
 
-    def get_sheet_value(self, spreadsheet_id: str, range_name: str) -> list | None:
+    def get_sheet_value(self, spreadsheet_id, range_name):
         """
         從指定的試算表和範圍讀取資料。
 
@@ -238,7 +238,7 @@ class SheetService:
             return None
 
     @staticmethod
-    def flatten_column_data(data: list[list[str]]) -> list[str]:
+    def flatten_column_data(data):
         """
         將從 Google Sheets API 獲取的單欄數據（列表的列表）扁平化為單一列表。
 
@@ -272,7 +272,7 @@ class SheetService:
         return True
     
     @staticmethod
-    def _col_index_to_letter(col_index: int) -> str:
+    def _col_index_to_letter(col_index):
         """將 0-based 的欄位索引轉換為 A1 表示法的字母。"""
         if col_index < 0:
             raise ValueError("Column index must be non-negative")
@@ -293,7 +293,7 @@ class SheetService:
         return letters if letters else "A" # 確保至少返回 "A"
 
     @staticmethod
-    def _col_index_to_letter_simple(col_index: int) -> str:
+    def _col_index_to_letter_simple(col_index):
         """將 0-based 的欄位索引轉換為 A1 表示法的字母 (簡化版，適用於 A-ZZ)。"""
         if col_index < 0:
             raise ValueError("Column index must be non-negative")
@@ -304,7 +304,7 @@ class SheetService:
         return letters
 
     #                 SHEET_SERVICE.update_sheet_cell(sheet_url, target_row_index, qa_col_index, qa_result)
-    def update_sheet_cell(self, sheet_url: str, target_row_index_in_data: int, qa_col_index: int, qa_result: str) -> bool:
+    def update_sheet_cell(self, sheet_url, target_row_index_in_data, qa_col_index, qa_result):
         """
         更新指定 URL 的 Google Sheet 中的單一儲存格。
 
@@ -385,7 +385,7 @@ class SheetService:
             logging.error(f"更新儲存格時發生未知錯誤 (ID: {spreadsheet_id}, Range: {range_name}): {e}")
             return False
 
-    def batch_update_cells(self, sheet_url: str, update_data: list[dict]) -> dict | None:
+    def batch_update_cells(self, sheet_url, update_data):
         """
         批次更新 Google Sheet 中的多個儲存格。