開始使用 Picker API

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

事前準備

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

Picker API 流程

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

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

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

3. 將使用者導向 Google 相簿應用程式：提供 pickerUri 給使用者 (可點選連結或 QR code)。這個網址將安全地開啟其 Google 相簿應用程式。

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

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

   注意： 每次輪詢工作階段時，回應都會包含建議的間隔和逾時時間，以便設定輪詢作業。

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

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

後續步驟

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