開始使用 Picker API

Picker API 提供安全的方式，讓使用者從 Google 相簿媒體庫選取相片和影片，並與您的應用程式分享。

事前準備

Picker API 流程

以下簡要說明 Picker API 的運作方式：

  1. 檢查 OAuth 權杖：啟動 Picker API 流程前，請先檢查使用者是否有有效的 OAuth 2.0 存取權杖。如果沒有權杖，請啟動 OAuth 2.0 授權流程來取得權杖。

  2. 建立工作階段：呼叫 Picker API 建立新工作階段，啟動程序。這項呼叫會傳回專屬的 pickerUri。

  3. 將使用者導向 Google 相簿應用程式：向使用者提供 pickerUri (可點選的連結或 QR code)。這個網址會安全地開啟 Google 相簿應用程式。如果是網頁應用程式，您可以在這個 URI 後方附加 /autoclose，讓使用者完成選取後，系統自動關閉 Google 相簿視窗。

  4. 使用者選取媒體項目：使用者可以在 Google 相簿應用程式中瀏覽媒體庫，然後選取要與應用程式分享的相片和影片。請參閱使用者選取體驗的總覽。

  5. 輪詢工作階段：應用程式應定期輪詢工作階段，檢查狀態。您要尋找會傳回 true 的 mediaItemsSet 屬性，表示使用者已完成選取。

  6. 列出所選媒體項目：mediaItemsSet 傳回 true 後，您可以使用清單方法取得所選媒體項目的詳細資料。

  7. 擷取及使用媒體項目：您現在可以存取所選媒體項目。您可以使用 baseUrl 擷取內容，並在應用程式中使用。

後續步驟

  • 參閱參考文件：詳閱 Picker API 參考說明文件，瞭解所有可用方法和參數。
  • 試用範例：查看我們的範例，瞭解 Picker API 的運作方式，並從中獲得整合靈感。