在書籤同步功能異動前更新擴充功能

James Lee
James Lee

發布日期:2025 年 6 月 17 日

去年 8 月,我們宣布即將在 Windows、Mac 和 Linux 平台推出 Chrome 身分識別模式異動,iOS 和 Android 平台則已推出相關異動。進行這些異動的目的是為了讓 Chrome 登入功能符合目前使用者期望。使用者越來越希望只要登入就能存取書籤等內容,登出則可確保安全。

在推出這些更新的過程中,我們將變更 Chrome 在桌機上儲存書籤的方式。舉例來說,裝置本機儲存的書籤在登入後仍會保留在本機;使用者可以選擇個別或大量將這類資料上傳至 Google 帳戶。為讓擴充功能支援這些功能,我們將在 Chrome 擴充功能 API 中公開新資料。如果您是使用 chrome.bookmarks API 的 Chrome 擴充功能作者,請參閱下列資訊。

總覽

目前使用者一律只有一組頂層資料夾,包括「書籤列」和「其他書籤」資料夾。這些資料夾中的資料是否會同步處理,取決於使用者是否已登入並啟用同步功能。

為配合身分識別模型異動,Chrome 會將同步處理和未同步處理的書籤,分別歸入書籤樹狀結構的兩個子樹狀結構。如果使用者未選擇將所有書籤上傳至帳戶,有時可能會同時擁有同步處理和未同步處理的書籤資料夾。使用書籤 API 的擴充功能可能需要更新,才能以使用者清楚明瞭的方式顯示書籤樹狀結構。

詳細 API 變更

如果使用者同時有同步和未同步的書籤,書籤 API 可能會在 getTree API 上傳回類似下列的樹狀結構:

  • id=A (name: "Bookmarks bar", folderType: "bookmarks-bar", syncing: true)
  • id=B (name: "Other bookmarks", folderType: "other", syncing: true)
  • id=C (name: "Bookmarks bar", folderType: "bookmarks-bar", syncing: false)
  • id=D (name: "Other bookmarks", folderType: "other", syncing: false)

為協助擴充功能開發人員區分這些頂層資料夾,API 新增了兩項屬性:

  • folderType:擴充功能可藉此識別「特殊」資料夾,例如書籤列。請注意,nameid 不應用於此用途 (name 取決於語言代碼,而 id 則不固定)
  • syncing:允許擴充功能區分樹狀結構中同步處理和未同步處理的部分。如果使用者已登入並啟用同步功能,這項設定會在身分識別模型變更前true生效。

擴充功能更新

如果擴充功能符合下列任一情況,您可能需要更新:

  • 如果擴充功能向使用者顯示 getTree 的完整結果,可避免顯示名稱相同的版本 (例如書籤列)。您可能想在名稱後方加上字尾,或是提供其他 UI 處理方式。
  • 如果擴充功能嘗試比對書籤列、其他或行動裝置永久資料夾 (使用 idname),這些方法原本就不受支援。
  • 如果擴充功能假設書籤列、其他或行動裝置永久資料夾的執行個體數量為零或一

測試

新的 folderTypesyncing 擴充功能 API 屬性已記錄在文件中,並在最新的 Chrome Canary 版本 (138.0.7196.0 以上版本) 中提供。

穩定版 Chrome 通道的使用者只有一個儲存空間 (也就是每種資料夾類型最多一個)。如要進行測試,可以按照下列步驟啟用雙重儲存空間:

  1. 在 chrome://flags 中啟用下列兩項設定,然後重新啟動 Chrome
    • sync-enable-bookmarks-in-transport-mode
    • enable-bookmarks-selected-type-on-signin-for-testing
  2. 新增 Chrome 設定檔 (https://support.google.com/chrome/answer/2364824)
    • 不登入:選擇「繼續而不登入帳戶」。
  3. 如果您將頁面加入書籤,系統會將這些頁面新增至非同步儲存空間。
  4. 現在登入 Chrome:
    • 按一下右上角三點選單旁邊的顯示圖片。
    • 按一下「登入 Chrome」,然後按照提示操作。
    • 系統詢問是否要開啟同步功能時,請選擇「不用了」。
  5. 如果將網頁加入書籤,系統會將這些網頁新增至同步儲存空間 (方便您測試雙儲存空間案例)。

時間表

我們將逐步推出雙重儲存空間的變更,並於 2025 年 6 月底前,開始為部分 Chrome 穩定版使用者推出這項功能,一開始只會開放給少部分使用者,之後幾週內再逐步擴大範圍。