訂閱這些版本資訊。
本頁面會隨著 Google Photos Library 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 Live Photos 的
=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 Photos Library API 建構相片共享應用程式。詳情請參閱範例指南。
2019 年 4 月 29 日
功能
問題 109505022：針對相簿新增和移除現有媒體項目的呼叫：
這些呼叫支援應用程式建立的媒體項目和相簿。詳情請參閱「管理專輯」開發人員指南。
如果部分媒體項目無法建立，則建立媒體項目的 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 日
功能
- 建立新的
sharedAlbums.get呼叫，使用shareToken取得相簿。 shareInfo中的新屬性isJoined可識別使用者是否已加入共享相簿。
已解決問題
- 問題 79321120：影片媒體項目的 mediaItems.batchCreate 回應缺少
mimeType屬性。 - 問題 79319272：mediaItems.batchCreate 回應中缺少
mediaMetadata、contributorInfo等屬性。 - 問題 110237685：修正 CORS 相關的檔案上傳問題。
- 問題 79318118：透過 mediaItems.batchCreate 呼叫將多個項目上傳至相簿時，系統並未保留一致的順序。
附註
- 如果您在 2018 年 9 月 5 日之前儲存 ID (例如相簿、媒體項目或擴充項目項目的 ID)，這些 ID 可能會因格式變更而停止運作。您必須取得新的 ID，才能在應用程式中使用。
- 專輯資源的
totalMediaItems屬性已重新命名為mediaItemsCount。 - mediaItems.list 和 mediaItems.search 呼叫中的
pageSize參數最大值已變更為 100。如未指定pageSize參數，則傳回的媒體項目預設數量變更為 25。 - 清單媒體庫內容、「分享媒體」和「存取媒體項目」指南已更新](/photos/library/guides/apply-filters#nonapp-created) 篩選功能，這項功能已於 2018 年 7 月 31 日發布。
excludeNonAppCreatedData
2018 年 7 月 31 日
功能
- 新的呼叫
mediaItems.list可列出媒體項目。 - 新增篩選器
excludeNonAppCreatedData，可搜尋應用程式所建立的項目或清單。 - 新的存取圖片參數：
- 問題 79871479：
c裁剪參數，以便將圖片裁剪為確切尺寸。 - 問題 110343547、問題 111228390：
d下載參數，用於下載原始圖片。
- 問題 79871479：
sharedAlbums.join呼叫現在會傳回專輯。- 問題 109655786：
album現在包含封面相片的媒體項目 IDcoverPhotoMediaItemId。 - 問題 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 的初始版本。
已知問題
- 如果收到的媒體項目
id是來自共享相簿且非使用者擁有的媒體項目，GET mediaItem會擲回錯誤。 batchCreate呼叫的回應不會傳回mediaMetadata或contributorInfo。- 如果媒體項目是影片，
batchCreate呼叫不會傳回mimeType。 - 上傳多個項目時，
batchCreate不會保持一致的順序。 - 在共享相簿中建立媒體項目做為共享相簿擁有者時，
batchCreate不支援排序 (在position中新增)。預設為專輯結尾。