發布日期: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
:擴充功能可藉此識別「特殊」資料夾,例如書籤列。請注意,name
和id
不應用於此用途 (name
取決於語言代碼,而id
則不固定)syncing
:允許擴充功能區分樹狀結構中同步處理和未同步處理的部分。如果使用者已登入並啟用同步功能,這項設定會在身分識別模型變更前true
生效。
擴充功能更新
如果擴充功能符合下列任一情況,您可能需要更新:
- 如果擴充功能向使用者顯示 getTree 的完整結果,可避免顯示名稱相同的版本 (例如書籤列)。您可能想在名稱後方加上字尾,或是提供其他 UI 處理方式。
- 如果擴充功能嘗試比對書籤列、其他或行動裝置永久資料夾 (使用
id
或name
),這些方法原本就不受支援。 - 如果擴充功能假設書籤列、其他或行動裝置永久資料夾的執行個體數量為零或一
測試
新的 folderType
和 syncing
擴充功能 API 屬性已記錄在文件中,並在最新的 Chrome Canary 版本 (138.0.7196.0 以上版本) 中提供。
穩定版 Chrome 通道的使用者只有一個儲存空間 (也就是每種資料夾類型最多一個)。如要進行測試,可以按照下列步驟啟用雙重儲存空間:
- 在 chrome://flags 中啟用下列兩項設定,然後重新啟動 Chrome
- sync-enable-bookmarks-in-transport-mode
- enable-bookmarks-selected-type-on-signin-for-testing
- 新增 Chrome 設定檔 (https://support.google.com/chrome/answer/2364824)
- 不登入:選擇「繼續而不登入帳戶」。
- 如果您將頁面加入書籤,系統會將這些頁面新增至非同步儲存空間。
- 現在登入 Chrome:
- 按一下右上角三點選單旁邊的顯示圖片。
- 按一下「登入 Chrome」,然後按照提示操作。
- 系統詢問是否要開啟同步功能時,請選擇「不用了」。
- 如果將網頁加入書籤,系統會將這些網頁新增至同步儲存空間 (方便您測試雙儲存空間案例)。
時間表
我們將逐步推出雙重儲存空間的變更,並於 2025 年 6 月底前,開始為部分 Chrome 穩定版使用者推出這項功能,一開始只會開放給少部分使用者,之後幾週內再逐步擴大範圍。