發布時間:2024 年 9 月。
這個頁面提供了 Google 相簿具體變更的詳細資料 相互整合請詳閱本頁說明,瞭解您使用的做法和範圍可能受到的影響。如要進一步瞭解這些公告 相關網誌文章中的變更。
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 新增至使用者的媒體庫。 | 剩餘範圍:
|
|
剩餘範圍:
|
||
這些方法將無法使用。 | 剩餘範圍:
|
|
這些方法會新增 photoslibrary.edit.appcreatedata 。這些方法現在只能搭配應用程式建立的相簿和媒體項目使用。這包括使用 Picker API 選取的媒體項目,並透過 Library API 新增至使用者的媒體庫。 |
剩餘範圍:
|
|
剩餘範圍:
|
||
這些方法將維持不變。 | 剩餘範圍:
|
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。
這篇網誌文章 公告變更時
如果我有其他問題或需要應用程式遷移協助,該怎麼辦?
如果對開發人員說明文件有任何疑問,請前往我們的支援頁面 頁面,進一步瞭解如何取得協助。