Google 相簿 API 更新

發布時間：2024 年 9 月。

這個頁面提供了 Google 相簿具體變更的詳細資料 相互整合請詳閱本頁說明，瞭解您使用的做法和範圍可能受到的影響。如要進一步瞭解這些公告 相關網誌文章中的變更。

注意： 所有變更將於 2025 年 3 月生效。

Library API：對常見用途的影響

以下各節將詳細說明近期異動對常見使用方式的影響 用途

上傳媒體項目和建立相簿

變更內容：不會變更。您可以繼續上傳媒體項目 使用 photoslibrary.appendonly 範圍建立相簿。

建議做法：

如果您的應用程式要上傳媒體項目或建立相簿，請務必使用 photoslibrary.appendonly 範圍，而非 photoslibrary 範圍。 正在移除 photoslibrary 個範圍。

列出、搜尋及擷取媒體項目和專輯

變更內容：現在您只能列出、搜尋及擷取應用程式建立的專輯和媒體項目。

建議做法：

• 如果您的應用程式需要使用者從整個相片庫中選取相片或相簿，請使用新的 Google 相簿挑選工具 API。這可讓您 讓使用者能輕鬆存取特定內容
• 如果您的應用程式需要存取使用者的完整程式庫，您可能需要 重新評估您的應用程式，或考慮採用其他做法。

共享和共享相簿

異動詳情：共享相簿與相關聯的 API 功能 (分享、 取消分享、取得、加入、離開和清單) 會在之後傳回 403 PERMISSION_DENIED 2025 年 3 月 31 日。

建議做法：

引導使用者前往 Google 相簿應用程式，自行管理共享設定。你可以 在應用程式中提供清楚的操作說明或深層連結，引導使用者前往相關頁面。

管理應用程式建立的相簿：充實功能和專輯內容

異動內容：將 photoslibrary.edit.appcreatedata 新增到 以下三種概念一致性的方法：

• albums.addEnrichment
• albums.batchAddMediaItems
• albums.batchRemoveMediaItems

建議做法：

• 如果您的應用程式本來就使用這些方法，請考慮採用 可簡化授權作業的 photoslibrary.edit.appcreatedata 個範圍 上傳資料集之後，您可以運用 AutoML 自動完成部分資料準備工作

程式庫 API：受影響的範圍和方法

我們對 Google 相簿 API 進行了以下變更。

如更新版授權說明 頁面，下列範圍 ，在 2025 年 3 月 31 日後從 Library API 中移除：

• photoslibrary.readonly
• photoslibrary.sharing
• photoslibrary

下列範圍仍會維持：

• photoslibrary.appendonly
• photoslibrary.readonly.appcreateddata
• photoslibrary.edit.appcreateddata

下表詳細說明受影響的 Library API 方法和範圍。

更新	方法	範圍
現在，這些方法只能用於應用程式建立的相簿和媒體項目。這包括使用 Picker API 選取的媒體項目，並透過 Library API 新增至使用者的媒體庫。	albums.create mediaItems.batchCreate	剩餘範圍： photoslibrary.appendonly 已移除的範圍： photoslibrary photoslibrary.sharing
	albums.get albums.list mediaItems.batchGet mediaItems.get mediaItems.list mediaItems.search	剩餘範圍： photoslibrary.readonly.appcreatedata ，瞭解如何調查及移除這項存取權。 已移除的範圍： photoslibrary photoslibrary.readonly
這些方法將無法使用。	albums.share albums.unshare sharedAlbums.get sharedAlbums.join sharedAlbums.leave sharedAlbums.list	剩餘範圍： 無 ，瞭解如何調查及移除這項存取權。 已移除的範圍： photoslibrary.sharing ，瞭解如何調查及移除這項存取權。 注意： sharedAlbums.list，因為應用程式建立的共享相簿將不再可供清單使用。
這些方法會新增 photoslibrary.edit.appcreatedata。 這些方法現在只能搭配應用程式建立的相簿和媒體項目使用。這包括使用 Picker API 選取的媒體項目，並透過 Library API 新增至使用者的媒體庫。	albums.addEnrichment albums.batchAddMediaItems	剩餘範圍： photoslibrary.appendonly photoslibrary.edit.appcreatedata 已移除的範圍： photoslibrary
	albums.batchRemoveMediaItems	剩餘範圍： photoslibrary.edit.appcreatedata ，瞭解如何調查及移除這項存取權。 已移除的範圍： photoslibrary
這些方法將維持不變。	albums.patch mediaItems.patch	剩餘範圍： photoslibrary.edit.appcreatedata ，瞭解如何調查及移除這項存取權。 已移除的範圍： 無

Photos API 政策更新

自 2025 年 3 月 31 日起，現行的使用規定政策將改為新的《Photos API User Data and Developer Policy》。新版政策已適用於 預覽。

更新相片 API 說明文件

為反映，我們對 Photos API 說明文件做出大幅調整 即將推出的更新和支援您的開發體驗：

• Unified Photos API 網站：我們已整合所有 Photos API 資源 放在方便處理的單一位置 (本網站)，提供簡化的 打造一個絕佳的體驗您會看到：
  • 集中式資源：結合設定操作說明和一般性 使用指引 支援和政策資訊， Picker API 和 Library API
  • 專屬 API 網站：提供詳細指南的個別網站 Picker挑選器的參考文件和程式碼範例 API與程式庫 API
• 更新的 Library API 內容：程式庫 API 說明文件 已根據服務終止期的規定進行修訂。 在更新過的說明文件中，您會發現某些標籤會醒目顯示 內容已變更或移除，並附上相應舊版內容的連結 供參考。
• 保留舊版說明文件：我們保留了原始的 Library API 說明文件，供需要遷移現有整合功能的開發人員使用。如要建立新專案，請使用 新版說明文件。如果 更新現有專案時，請同時參照舊版和 說明文件。

常見問題

Google Photos API 有哪些異動？

我們推出全新的 Google 相簿 Picker API，可安全地挑選相片，並更新現有的 Library API，專注於管理應用程式建立的相片和影片。

這些異動何時生效？

這些異動將於 2025 年 3 月 31 日生效。我們鼓勵所有使用者 現有的整合功能使用 Library API 挑選相片遷移至 Picker API

Library API 會受到什麼影響？

《photoslibrary.readonly》、《photoslibrary.sharing》和《photoslibrary》 範圍。僅仰賴這些範圍的 API 呼叫會傳回 403 PERMISSION_DENIED。其他通話功能將受到限制 顯示由應用程式建立的相片和影片。

您可以在本頁頂端的表格中查看完整變更項目。

如果我的應用程式目前使用受影響的權限範圍或方法，該怎麼辦？

如果您的應用程式使用了任何受影響的範圍或方法，建議您採取下列做法： 步驟如下：

• 用於選取相片：遷移至 Google 相簿挑選器 API。
• 其他功能：請查看更新版的 Library API 說明文件，瞭解變更內容，並找出應用程式中可能已無法使用的功能。您可能需要調整應用程式的功能，或探索 某些用途的替代解決方案

什麼是 Google 相簿挑選器 API？

Picker API 可讓開發人員讓使用者選取相片，並以安全無虞的新方式 輕鬆將相簿和相簿傳送到 應用程式Picker API 提供強大的相片選取功能。 包括選取個別項目、選取相簿中的所有項目，以及 搜尋 Google 相簿相片庫的內容

哪裡可以找到有關這些異動的資訊？

您目前檢視的頁面會提供 「總覽」以及所有變更的摘要

我們已更新網站上的其他說明文件，以反映更新後的 API。

這篇網誌文章 公告變更時

如果我有其他問題或需要應用程式遷移協助，該怎麼辦？

如果對開發人員說明文件有任何疑問，請前往我們的支援頁面 頁面，進一步瞭解如何取得協助。