Google 相簿 API 更新

發布日期：2024 年 9 月。

本頁面將詳細說明 Google 相簿 API 的特定變更。請詳閱本頁詳細說明，瞭解您使用的做法和範圍可能受到的影響。如要進一步瞭解這些異動的公告內容，請參閱相關網誌文章。

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

Library API：對常見用途的影響

以下各節將詳細說明即將生效的異動對常見用途的影響。

上傳媒體項目和建立相簿

異動內容：無異動。您可以繼續使用 photoslibrary.appendonly 範圍上傳媒體項目和建立相簿。

建議做法：

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

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

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

建議做法：

• 如果您的應用程式需要使用者從整個相片庫中選取相片或相簿，請使用新的 Google 相簿挑選工具 API。這麼做可讓使用者以安全且友善的方式授予特定內容的存取權。
• 如果應用程式需要存取使用者的整個媒體庫，您可能需要重新評估應用程式，或考慮其他方法。

共用和共享相簿

異動內容：共用相簿和相關 API 函式 (分享、取消分享、取得、加入、離開和清單) 會在 2025 年 3 月 31 日後傳回 403 PERMISSION_DENIED。

建議做法：

請引導使用者前往 Google 相簿應用程式，自行管理分享設定。您可以在應用程式中提供明確的操作說明或深層連結，引導使用者操作。

管理應用程式建立的相簿：強化內容和相簿內容

變更內容：photoslibrary.edit.appcreateddata 已新增至下列三種方法，以便維持概念一致性：

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

建議做法：

• 如果您的應用程式已使用這些方法，請考慮採用 photoslibrary.edit.appcreateddata 範圍，簡化授權程序。

Library API：受影響的範圍和方法

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

如更新的授權頁面所示，下列範圍將自 2025 年 3 月 31 日起從 Library API 中移除：

• photoslibrary.readonly
• photoslibrary.sharing
• photoslibrary

下列範圍將保留：

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

下表詳細說明受影響的 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.appcreateddata 已移除的範圍： photoslibrary photoslibrary.readonly
這些方法將無法再使用。	albums.share albums.unshare sharedAlbums.get sharedAlbums.join sharedAlbums.leave sharedAlbums.list	剩餘範圍： 無 已移除的範圍： photoslibrary.sharing 注意： sharedAlbums.list 已移除，因為您的應用程式不再會建立可列出的共用相簿。
這些方法會新增 photoslibrary.edit.appcreateddata。 這些方法目前只能用於應用程式建立的相簿和媒體項目。	albums.addEnrichment albums.batchAddMediaItems	剩餘範圍： photoslibrary.appendonly photoslibrary.edit.appcreateddata 已移除的範圍： photoslibrary
	albums.batchRemoveMediaItems	剩餘範圍： photoslibrary.edit.appcreateddata 已移除的範圍： photoslibrary
這些方法將維持不變。	albums.patch mediaItems.patch	剩餘範圍： photoslibrary.edit.appcreateddata 已移除的範圍： 無

Google 相簿 API 政策異動

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

更新相片 API 說明文件

我們已對 Photos API 說明文件進行重大變更，以反映即將推出的更新內容，並協助您享有更優質的開發體驗：

• 統一版 Photos API 網站：我們已將所有 Photos API 資源整合至單一位置 (本網站)，為開發人員提供簡化體驗。這裡提供以下資訊：
  • 集中資源：結合 設定說明和一般使用指南，以及 Picker API 和 Library API 的支援和政策資訊。
  • 專屬 API 網站：個別網站提供 Picker API 和 Library API 的詳細指南、參考說明文件和程式碼範例
• 更新 Library API 內容：Library API 說明文件已修訂，以反映 Library API 在停用期後的功能。
• 保留舊版說明文件：我們保留了原始的 Library API 說明文件，供需要遷移現有整合功能的開發人員使用。如果您要開始新的專案，請使用更新後的說明文件。如果您要更新現有專案，請在遷移期間視需要參考舊版和更新版的說明文件。

常見問題

Google 相簿 API 有哪些異動？

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

這些異動何時生效？

這些異動將於 2025 年 3 月 31 日生效。我們建議所有使用現有整合功能的使用者，盡快改用 Picker API，以便使用 Library API 挑選相片。

Library API 會受到什麼影響？

系統會移除 photoslibrary.readonly、photoslibrary.sharing 和 photoslibrary 範圍。2025 年 3 月 31 日之後，僅依賴這些範圍的 API 呼叫會傳回 403 PERMISSION_DENIED。其他幾個呼叫將僅限於處理應用程式建立的相片和影片。

如要查看完整的異動項目清單，請參閱本頁的受影響範圍和方法表格。

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

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

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

什麼是 Google Photos Picker API？

Picker API 是開發人員提供的新安全方式，可讓使用者從 Google 相簿媒體庫中選取相片和影片，並流暢地將這些內容傳回應用程式。

哪裡可以進一步瞭解這些異動內容？

您目前正在查看的頁面會提供所有變更的概要說明和摘要。

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

這篇網誌文章宣布了這些變更。

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

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