開始使用 Library API

Library API 可讓您與使用者的 Google 相簿圖庫中相片、影片和相簿互動，但有一個重要的重點：您只能存取及管理應用程式建立的內容。

事前準備

• 查看總覽：比較 Picker API 和 Library API，確認 Library API 是否適合您的用途。
• 設定應用程式：啟用 API 並設定驗證機制。如需詳細步驟，請參閱「設定應用程式」。

Library API 的主要用途

Library API 非常適合用於以下情況：

• 上傳及儲存媒體：將應用程式產生的相片和影片安全匯入使用者的 Google 相簿。
• 整理內容：建立及管理相簿，協助使用者整理應用程式相關媒體。
• 強化相片和相簿：運用標題、說明或位置資訊等充實內容，為媒體項目和相簿添加背景資訊。
• 存取應用程式建立的資料：擷取應用程式先前建立的相片、影片和相簿，並與這些內容互動。

一般 Library API 工作流程

雖然 Library API 提供多種功能，但常見的工作流程可能會涉及以下步驟：

1. 上傳媒體：使用上傳端點，將相片或影片位元組安全地上傳到 Google 相簿。這個步驟會產生 uploadToken。

2. 建立媒體項目：使用 mediaItems.batchCreate 方法提供 uploadToken，在使用者的媒體庫中建立媒體項目。

3. 建立相簿 (選用)：使用 albums.create 方法在使用者媒體庫中建立相簿，以便整理媒體項目。

4. 管理相簿：

   • 使用 albums.batchAddMediaItems 將媒體項目 (由應用程式建立) 新增至相簿。
   • 使用 albums.batchRemoveMediaItems 從相簿移除媒體項目。
   • 使用 albums.addEnrichment 為相簿新增強化資料 (例如標題或地點)。
   • 使用 albums.get 擷取特定相簿的資訊。
   • 使用 albums.list 列出應用程式建立的相簿。

5. 存取應用程式建立的媒體：

   • 使用 mediaItems.get 或 mediaItems.batchGet 擷取特定媒體項目的詳細資料。
   • 使用 mediaItems.search 搜尋應用程式建立的媒體項目。
   • 使用 mediaItems.search 和專輯 ID，列出特定應用程式建立的專輯內的媒體項目。

後續步驟

• 查看參考文件：探索詳細的 Library API 參考資料說明文件，瞭解所有可用的方法和參數。
• 試用範例：查看我們的範例，瞭解 Library API 的實際運作情形，並獲得整合的靈感。