版本資訊

訂閱這些版本資訊。

每次發布 Google 相簿資料庫 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 建立相片共享應用程式」程式碼研究室不是 提供更即時的 IP 位址請參閱其他範例並參閱 指南中的範例程式碼

2022 年 6 月 1 日

附註

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

2021 年 10 月 27 日

功能

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

2021 年 9 月 29 日

功能

• 推出依日期篩選搜尋結果排序的新選項 ，直接在 Google Cloud 控制台實際操作。結果可以由新到舊排序。 不僅能簡化搜尋作業，還能提供更優質的服務 目標明確的搜尋結果

2021 年 7 月 21 日

功能

• 新增 -no 影片基礎網址參數 會在沒有重疊播放按鈕的情況下載入縮圖。根據預設，影片縮圖會載入播放按鈕疊加層。這個新參數可讓您 控制項，即可隱藏影片縮圖上的播放按鈕。

已解決問題

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

2021 年 5 月 25 日

已解決問題

• 未填入以下項目的 exposureTime 屬性： photo 中繼資料 返回媒體項目中

2021 年 5 月 19 日

附註

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

2021 年 2 月 11 日

附註

• 《使用限制政策》已經 更新廣告，加入廣告內容並盡量減少資料用量。

2020 年 7 月 7 日

功能

• 這個 API 已更新為可支援 Google 相簿全新分享控制選項。 這是新欄位 isJoinable，是 現在，在共享相簿的 shareInfo 屬性中傳回。API 可以將使用者加入共享相簿 當 isJoinable 為 true 時。擁有者停用相簿的連結分享功能 在 Google 相簿中，isJoinable 會是 false，且 API 不會 使用者就能加入該相簿。
• 問題 111405623、 116379853、 117685011：您現在可以 變更相簿標題和封面相片、 及變更媒體項目的說明 要求新的 photoslibrary.edit.appcreateddata 授權範圍。

2020 年 2 月 17 日

功能

• 上傳的檔案大小上限 相片 從 75 MB 增加到 200 MB
• 現在當您上傳檔案時，您必須在 位元組上傳階段。
• 您現在可以在建立媒體項目時指定檔案名稱，而非上傳媒體位元組時指定。simpleMediaItem 中的新 fileName 屬性支援 UTF-8 字串。即使在 但我們強烈建議您更新

附註

• 《使用限制政策》已經 元件中新增其他細節，說明如何盡可能減少資料用量與儲存空間。
• 基準網址 說明文件 已經更新，現在包含動態相片。

2019 年 8 月 16 日

功能

• 問題 131874809：新屬性 shareInfo的isOwned ，以識別使用者是否是共享相簿的擁有者。詳情請參閱 透過分享 媒體 開發人員指南

已解決問題

• 問題 131711405：shareableUrl 屬性之前為 在 albums.list 中缺少 回應。
• 問題 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 Photos Library 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 已正式發布。感謝你提供意見 產生新功能並提出新功能要求
• 請參閱新的指南，瞭解如何開始使用 Java 和 PHP 用戶端程式庫。
• 我們在指南中加入 Java 和 PHP 程式碼片段範例以示範 用戶端程式庫的使用方式

2018 年 9 月 5 日

功能

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

已解決問題

• 問題 79321120：缺少 mimeType 屬性 的 mediaItems.batchCreate 影片媒體項目的回應。
• 問題 79319272：內容，例如 mediaMetadata、contributorInfo 缺少 mediaItems.batchCreate 回應。
• 問題 110237685：修正 CORS 相關檔案 上傳問題。
• 問題 79318118：不一致的訂單並非 您可將多個項目上傳至 mediaItems.batchCreate 呼叫。

附註

• 如果您儲存了 ID (例如專輯、媒體項目或擴充項目的 ID) 。 您必須取得新的 ID，才能在應用程式中使用。
• 應用程式的 totalMediaItems 屬性 相簿資源已重新命名為 mediaItemsCount。
• 字串中 pageSize 參數的最大值 mediaItems.list 和 mediaItems.search 呼叫 已變更為 100預設的 未指定 pageSize 參數已變更為 25。
• 列出程式庫內容 分享媒體和 已更新存取媒體項目指南 使用 excludeNonAppCreatedData](/photos/library/guides/apply-filters#nonapp-created) 2018 年 7 月 31 日發布了篩選功能。

2018 年 7 月 31 日

功能

• 新來電 待列出 mediaItems.list 媒體項目。
• 新篩選器 excludeNonAppCreatedData敬上 即可搜尋應用程式所建立的項目或清單相簿。
• 新的參數 存取映像檔：
  • 問題 79871479：c 裁剪參數，要裁剪 調整成確切尺寸的圖片
  • 問題 110343547， 問題 111228390：d 下載參數、 下載原始圖片。
• sharedAlbums.join 呼叫現在會傳回 相簿。
• 問題 109655786： 現付 album 包含封面相片的媒體項目 ID coverPhotoMediaItemId。
• 問題 79656863：mediaItem 現在包含媒體項目的檔案名稱 filename。

已解決問題

• 問題 79757390：上傳要求期間未設定檔案名稱。請參閱X-Goog-Upload-File-Namefile和 上傳項目中的 X-Goog-Upload-Protocol 個欄位 媒體指南。
• 問題 80182372：支援續傳的上傳作業傳回 錯誤。請參閱新推出的「支援續傳」功能 上傳指南 因此效能相當卓越
• 問題 79497397：缺少 isWriteable 屬性 albums.list 回應中的值。
• 問題 111143493：PEOPLE內容類別 篩選器傳回的結果不正確。
• 問題 111056278：BIRTHDAYS 內容類別篩選器傳回錯誤。

預覽版本 - 2018 年 5 月 8 日

Library API 的初始版本。

已知問題

• 如果 GET mediaItem 收到的媒體項目 id 適用於 來自共享相簿且非使用者擁有的媒體項目。
• batchCreate 呼叫的回應不會傳回 mediaMetadata 或 contributorInfo。
• 如果媒體項目是影片，batchCreate 呼叫就不會傳回 mimeType。
• 上傳多個項目時，batchCreate 無法維持一致的順序。
• 發生以下情況時，batchCreate 不支援排序功能 (在 position 中新增) 在共享相簿中建立媒體項目做為共享相簿的擁有者。這項服務 預設為相簿的結尾。