Shopify 博客自動發布接入

Shopify 使用官方 API（Admin GraphQL，當前版本 2026-07）接入，全程無需改動店鋪文件。

• 同步店鋪內的 Blog（博客）作為發布分類，最多讀取 100 個。
• 發布使用 Shopify 官方的 Article 接口，文章直接為正式發布狀態。
• Token 與店鋪域名加密儲存在你的帳戶內，介面不回顯明文。

1. 在 Shopify 後台為店鋪創建具有 read_content 和 write_content 權限的自定義應用（或 Admin API Access Token），拿到形如 shpat_... 的令牌。
2. 在平台新增網站：填寫myshopify.com 原始店鋪域名（例如 your-store.myshopify.com，不是自定義前臺域名）、可選的文章作者名、Access Token。
3. 平台驗證連接：讀取店鋪名稱、主域名和全部 Blog，並核對網站域名與店鋪一致。
4. 選擇目標 Blog 同步映射，之後導入標題、生成並發布文章。

注意：平台會校驗填寫的網站域名與店鋪主域名一致，避免把文章發到錯誤的店鋪。

• 分類：只讀取現有 Blog，不在店鋪中創建或刪除 Blog。
• 文章：發布為正式 Article，寫入標題、正文、摘要、標籤、URL handle 與作者名；帶圖片的文章會使用 Shopify 支援的圖片字段。
• 更新：同一平台文章再次發布時更新原 Article，不重複創建。
• 發布後：可繼續向百度站長平台與 Bing IndexNow 提交連結，狀態獨立重試。

Shopify 接入不需要在店鋪上傳任何文件。Access Token 屬於站點整合憑據金鑰域，AES-256-GCM 加密儲存（詳見 資安中心）；平台僅使用該 Token 調用你授權的 Blog 內容接口，不觸碰訂單、客戶或其他店鋪資料。

需要斷開時，在平台刪除網站，並在 Shopify 後台撤銷對應應用或 Token。

• 域名無效（SHOPIFY_DOMAIN_INVALID）：必須填寫 xxx.myshopify.com 原始域名，自定義前臺域名會被拒絕。
• 沒有博客（SHOPIFY_BLOG_NOT_FOUND）：店铺至少需要一个 Blog；在 Shopify 后台「在线商店 > 博客」創建後再同步。
• 域名不匹配（SHOPIFY_SITE_DOMAIN_MISMATCH）：平台新增的網站域名與店鋪主域名不一致，改用一致的域名重新驗證。
• 權限錯誤：確認 Token 具有 read_content 和 write_content 權限。