Google Play 商店資訊與全語系素材管理完全指南 (新手小白手把手教學)

本指南專為 完全不懂程式或終端機指令的初學者 設計。只要按照本文件的圖文步驟一步一步操作，您就能隨時修改 Google Play 商店上的 App 名稱、簡介、詳細說明、App 圖示、宣傳橫幅與手機截圖，並用「一鍵指令」直接自動同步發布到 Google Play 商店！

📌 目錄

1. 核心觀念：商店資訊是如何運作的？
2. 一、全語系商店文字與素材的檔案位置
3. 二、關於版本號與測試標籤前綴（已徹底清除說明）
4. 三、手把手教學：修改後如何「一鍵更新」Play 商店？
5. 四、兩種發布模式比較（僅改文字 vs 發布新版本）
6. 五、新手常見問題與故障排解 (FAQ)

1. 核心觀念：商店資訊是如何運作的？

在過去，每次要修改 Google Play 商店的文字或圖片，都必須手動登入 Google Play Console 網頁，在一個個輸入框中複製貼上 4 國語言、上傳一張張圖片，非常耗時且容易遺漏。

在我們的專案中，所有的商店文字與圖片都存放在本機的 google_play_assets/ 資料夾內。
您只需要：

1. 在電腦中直接打開文字檔修改內容（或替換圖片）。
2. 執行一條簡單指令。
3. 系統就會自動呼叫 Google 官方 API，在 15~30 秒內 將 4 國語言文字與所有圖片全部上傳並提交至 Google Play 商店！

2. 一、全語系商店文字與素材的檔案位置

所有商店相關的檔案都集中在專案根目錄的 google_play_assets 資料夾中。

📝 文字設定檔案對照表

💡 注意事項：

• 修改文字檔時，請使用 記事本 (Notepad) 或 VS Code 存檔為 UTF-8 編碼。
• 標題請務必控制在 30 個字元以內，簡短說明務必在 80 個字元以內，否則 Google Play API 會因超出長度而拒絕儲存。

🎨 圖片與視覺素材對照表

所有圖片均存放在 google_play_assets/：

3. 二、關於版本號與測試標籤前綴（已徹底清除說明）

以前為什麼會出現 [ Version 1.0.0 Build 257 ] [ 封閉測試 ]？

過去在早期自動化腳本中，為了讓內部測試人員能在商店頁面一眼看出當前是哪一個版本，腳本會在發布時自動把版本戳記硬塞在說明文字的最前面。

現在的改進機制：

1. 已完全移除自動前綴注入：我們已修改發布核心腳本 scripts/deploy_play_store.py，徹底取消自動添加版本號與測試軌道標籤。
2. 純淨 1:1 所見即所得：您在 ull_description_*.txt 檔案裡寫什麼，Google Play 商店呈現的就是完全一致的內容，不再會有多餘的括號或前綴字樣。

4. 三、手把手教學：修改後如何「一鍵更新」Play 商店？

當您日後自行修改了文字或換了圖片，請依照以下 3 個步驟 操作即可完成更新：

步驟 1：用記事本打開檔案並修改

1. 打開資料夾路徑：google_play_assets/。
2. 例如想修改繁體中文介紹，就點開 ull_description_zh-TW.txt。
3. 修改好文字後，按下 Ctrl + S 儲存檔案並關閉。

步驟 2：打開 PowerShell 執行一鍵指令

1. 在專案資料夾空白處，按住鍵盤的 Shift 鍵不放，同時點擊 滑鼠右鍵。
2. 選擇 「在終端機中開啟」 或 「在此處開啟 PowerShell 視窗」。
3. 在跳出的藍色/黑色視窗中，複製並貼上以下指令，然後按下 Enter：

powershell python -u scripts/deploy_play_store.py --listings-only

4. 看到以下綠色或 [SUCCESS] 字樣即代表成功：
   ext Commiting and applying changes to Google Play... [OK] Changes committed successfully. ================================================== [SUCCESS] Deployment complete! Store listings & visual assets updated for all available languages. ==================================================
   ⏱️ 整個過程僅需約 15 ~ 30 秒！

步驟 3：至 Google Play Console 確認

1. 打開瀏覽器前往 Google Play Console 預設商店資訊。
2. 重新整理頁面（按 F5），即可看見各個語系的文字與圖片均已同步變更！

5. 四、兩種發布模式比較

6. 五、新手常見問題與故障排解 (FAQ)

Q1: 執行指令時出現 python 不是內部或外部命令？

解答：請確認電腦已安裝 Python。若使用 VS Code，可直接在 VS Code 下方的 Terminal 終端機執行上述指令。

Q2: 出現 Short description must be at most 80 characters 錯誤？

解答：表示您的簡短說明文字超過了 80 個字元（注意：中文字、英文字母與標點符號都算 1 個字元）。請打開對應的 short_description_*.txt 刪減幾個字後重新執行指令即可。

Q3: 出現 Title must be at most 30 characters 錯誤？

解答：表示 App 名稱超過了 30 個字元。請打開 itle_*.txt 縮短名稱後重新執行。

Q4: 圖片更換後有尺寸限制嗎？

解答：有的！Google Play 有嚴格的尺寸驗證：

• 圖示 (icon_512.png) 必須剛好 512 x 512。
• 主題圖片 (eature_graphic_1024x500.png) 必須剛好 1024 x 500。
• 手機截圖寬高比建議為 9:16（如 1080x1920）。

指南建立日期：2026 年 8 月
維護者：PassExam 開發團隊