版本資訊

訂閱這些版本資訊。

每次發布 Google Photos API 新版本時，本頁面都會更新。變更記錄會依日期列出版本，並包含任何新功能、錯誤修正和其他變更。

說明文件和指南會指出要使用的最新版本。

2025 年 4 月 1 日

附註

這個版本實作先前宣布的 Google 相簿 API 異動。

• 從 Library API 中移除部分權限範圍。
• 限制幾種方法，僅適用於應用程式建立的內容。
• 新的《Photos API 使用者資料與開發人員政策》已生效，取代舊的「合理使用政策」。

如需完整詳細資料，請參閱「Google Photos API 更新」。

2024 年 9 月 16 日

功能

• 推出新的 Picker API，提供安全且方便使用者挑選相片的功能。

附註

我們在本版本中宣布了 Library API 的重大異動 (自 2025 年 3 月 31 日起生效)。

• Library API 只會管理應用程式建立的相片和影片。
• 移除 photoslibrary.readonly、photoslibrary.sharing 和 photoslibrary 範圍。
• 將某些方法限制為僅適用於應用程式建立的內容。

詳情請參閱「Google Photos API 更新」頁面。

2022 年 10 月 27 日

附註

• 「使用 Google 相簿和 Flutter 建構相片分享應用程式」程式碼研究室已不再提供。查看其他範例，並參考指南中的範例程式碼。

2022 年 6 月 1 日

附註

• 新增上傳最佳做法，以便說明上傳流程、指出常見錯誤和避免方法，並提供提升上傳效率的提示。

2021 年 10 月 27 日

功能

• Google 相簿合作夥伴計畫：推出菁英等級。頂級方案是一套進階 API 功能，可運用 Google 相簿強大的機器智慧。

2021 年 9 月 29 日

功能

• 新增排序日期篩選器搜尋結果的選項。您可以選擇先顯示最新或最舊的結果。這可提供更精準的搜尋結果，讓搜尋更輕鬆、更有效率。

2021 年 7 月 21 日

功能

• 新增 -no 參數，用於影片基礎網址，以便載入不含播放按鈕重疊的縮圖。根據預設，影片縮圖會載入播放按鈕疊加層。這項新參數可讓你控制是否要隱藏影片縮圖上的播放按鈕。

已解決的問題

• 問題 181282432：影片縮圖一律會顯示播放按鈕重疊圖示。

2021 年 5 月 25 日

已解決的問題

• 未為媒體項目中的photo 中繼資料填入 exposureTime 屬性。

2021 年 5 月 19 日

附註

• 動態相片的基準網址說明文件已更新，以便說明 Android 動態相片和 iOS 動態相片的 =dv 參數行為。

2021 年 2 月 11 日

附註

• 我們已更新使用限制政策，新增廣告相關內容，並盡量減少資料使用量。

2020 年 7 月 7 日

功能

• 我們已更新 API，以支援 Google 相簿中的新共用控制項。系統現在會將新欄位 isJoinable 當作共享相簿的 shareInfo 屬性一部分傳回。當 isJoinable 為 true 時，API 可以將使用者加入共享相簿。如果相簿擁有者已停用 Google 相簿中的連結共享功能，isJoinable 就會變成 false，API 就無法將使用者加入該相簿。
• 問題 111405623、116379853、117685011：現在您可以變更專輯名稱和封面相片，以及變更說明應用程式建立的媒體項目。請要求新的 photoslibrary.edit.appcreateddata 授權範圍，以便取得更新存取權。

2020 年 2 月 17 日

功能

• 相片上傳檔案大小上限已從 75 MB 提高至 200 MB。
• 上傳檔案時，現在必須在位元組上傳階段指定 MIME 類型。
• 您現在可以在建立媒體項目時指定檔案名稱，而非上傳媒體位元組時指定。simpleMediaItem 中的新 fileName 屬性支援 UTF-8 字串。您仍可在上傳媒體位元組時指定媒體項目的檔案名稱，但我們強烈建議您更新實作方式。

附註

• 我們已更新使用限制政策，並加入一些額外細節，著重於盡量減少資料使用量和儲存空間。
• 基礎網址文件已更新，納入動態相片。

2019 年 8 月 16 日

功能

• 問題 131874809：shareInfo 中的新屬性 isOwned，用於判斷使用者是否為共享相簿的擁有者。詳情請參閱分享媒體 開發人員指南。

已解決的問題

• 問題 131711405：albums.list 回應中缺少 shareableUrl 屬性。
• 問題 113870729：mediaItems.list 有時會在頁面邊界處傳回重複的媒體項目。
• 問題 93428763：影片中繼資料的 status 欄位現在會正確傳回可用的最高品質影片的 VideoProcessingStatus。

2019 年 6 月 12 日

功能

• 問題 110188560：新增搜尋篩選器，用來選取已標示為收藏的媒體項目：FeatureFilter。
• 新內容類別：ContentFilter 可篩選符合特定類別的媒體項目：ARTS、CRAFTS、FASHION、HOUSES、GARDENS、FLOWERS、HOLIDAYS。

附註

• 更新使用者體驗指南，提供命名專案和相簿的額外指南。

2019 年 5 月 7 日

程式碼研究室

• 新的程式碼研究室：使用 Google 相簿和 Flutter 建構相片分享應用程式。瞭解如何在 Flutter 中使用 Google 相簿 API 建構相片分享應用程式。詳情請參閱範例指南。

2019 年 4 月 29 日

功能

• 問題 109505022：新增呼叫，用於在相簿中新增及移除現有媒體項目：

  • albums.batchAddMediaItems
  • albums.batchRemoveMediaItems

  這些呼叫支援應用程式建立的媒體項目和專輯。詳情請參閱管理相簿開發人員指南。

• 如果無法建立某些媒體項目，用於建立媒體項目的 REST 呼叫 mediaItems.batchCreate 現會傳回 HTTP 狀態 207 MULTI-STATUS，表示部分成功。詳情請參閱上傳媒體開發人員指南。

附註

• 最新版用戶端程式庫包含破壞性變更。與 MediaItem、Album 和 DateRange 相關的類別已移至新的專屬套件。功能並未變更，只有用戶端程式庫中的位置有所不同。請參閱 Java 用戶端程式庫 (1.2.0) 和 PHP 用戶端程式庫 (1.2.0) 的版本資訊。

2019 年 2 月 14 日

附註

• 從基本網址存取媒體位元組的新配額限制已生效。您可以在 Google API 控制台監控這項配額。

已解決的問題

• 問題 124355983：針對部分共用媒體項目呼叫 mediaItems.get 時，會發生 500 錯誤。

2019 年 1 月 21 日

已解決的問題

• 問題 121998358：albums.create 回應中缺少 isWriteable 屬性。

2019 年 1 月 7 日

已解決的問題

• 問題 118464845：mediaItems.list 傳回太多空白頁面。
• 問題 111714379：mediaItems.search 傳回一半的 pageSize。

2018 年 11 月 30 日

功能

• 新的呼叫 mediaItems.batchGet，可根據 ID 擷取多個媒體項目。
• 問題 111279349：新增呼叫 sharedAlbums.leave，以便離開已加入的相簿。
• 問題 111279347：新增呼叫 albums.unshare，將共享相簿標示為私人。

已解決的問題

• 問題 113978705：在 mediaItems.batchCreate 中設定的說明已轉換為 HTML 實體。
• 問題 114462217：無法為 mediaItems.batchCreate 中的影片檔案設定檔案名稱。
• 問題 118475587：媒體項目傳回無效的產品網址。
• 問題 111862704：存取基礎網址時發生 403 錯誤。
• 問題 115932469：上傳作業因配額錯誤而失敗。

2018 年 9 月 6 日

功能

• 現已推出 Java 和 PHP 用戶端程式庫。

附註

• Google Photos Library API 已進入一般發布階段。感謝您在 Library API 開發人員預覽期間提供意見回饋和功能要求。
• 請參閱新的指南，瞭解如何開始使用 Java 和 PHP 用戶端程式庫。
• 我們已在指南中加入 Java 和 PHP 程式碼範例，以示範用戶端程式庫的用法。

2018 年 9 月 5 日

功能

• 使用 shareToken 的新呼叫 sharedAlbums.get，取得相簿。
• shareInfo 中的新屬性 isJoined，用於識別使用者是否已加入共享相簿。

已解決的問題

• 問題 79321120：影片媒體項目的 mediaItems.batchCreate 回應中缺少 mimeType 屬性。
• 問題 79319272：mediaItems.batchCreate 回應中缺少 mediaMetadata、contributorInfo 等屬性。
• 問題 110237685：修正 CORS 相關的檔案上傳問題。
• 問題 79318118：在 mediaItems.batchCreate 呼叫中，上傳多個項目至相簿時，系統未維持一致的順序。

附註

• 如果您在 2018 年 9 月 5 日前儲存 ID (例如專輯、媒體項目或強化項目的 ID)，由於格式已變更，這些 ID 將無法再使用。您必須取得新的 ID，才能在應用程式中使用。
• album 資源的 totalMediaItems 屬性已重新命名為 mediaItemsCount。
• mediaItems.list 和 mediaItems.search 呼叫中的 pageSize 參數上限已變更為 100。未指定 pageSize 參數時，傳回的媒體項目數量預設值已變更為 25。
• 列出媒體庫內容、分享媒體和存取媒體項目指南已更新為 2018 年 7 月 31 日推出的 excludeNonAppCreatedData](/photos/library/guides/apply-filters#non-app-created) 篩選器功能。

2018 年 7 月 31 日

功能

• 新增呼叫 mediaItems.list，用於列出媒體項目。
• 新增篩選器 excludeNonAppCreatedData，用於搜尋項目或列出應用程式建立的專輯。
• 存取圖片的新參數：
  • 問題 79871479：c 裁剪參數，用於將圖片裁剪為精確的尺寸。
  • 問題 110343547、問題 111228390：d 下載參數，用於下載原始圖片。
• sharedAlbums.join 呼叫現在會傳回 album。
• 問題 109655786：album 現在包含封面相片 coverPhotoMediaItemId 的媒體項目 ID。
• 問題 79656863：mediaItem 現在包含媒體項目的檔案名稱 filename。

已解決的問題

• 問題 79757390：上傳要求期間未設定檔案名稱。請參閱上傳媒體指南中的 X-Goog-Upload-File-Namefile 和 X-Goog-Upload-Protocol 欄位。
• 問題 80182372：支援續傳的上傳作業傳回錯誤。如需瞭解更新後的通訊協定，請參閱新的支援續傳的上傳作業指南。
• 問題 79497397：albums.list 回應中缺少 isWriteable 屬性。
• 問題 111143493：PEOPLE 內容類別篩選器會傳回不正確的結果。
• 問題 111056278：BIRTHDAYS 內容類別篩選器傳回錯誤。

預覽版 - 2018 年 5 月 8 日

Library API 的初始版本。

已知問題

• 如果 GET mediaItem 收到的媒體項目 id 是來自共用相簿的媒體項目，且並非使用者擁有，則會擲回錯誤。
• batchCreate 呼叫的回應不會傳回 mediaMetadata 或 contributorInfo。
• 如果媒體項目是影片，batchCreate 呼叫就不會傳回 mimeType。
• batchCreate 上傳多個項目時，不會維持一致的順序。
• batchCreate 不支援在共享相簿中以共享相簿擁有者的身分建立媒體項目時排序 (加入 position)。預設為專輯結尾。