Làm quen với Picker API
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Bộ chọn API mang đến cho người dùng một cách an toàn để chọn ảnh và video trong thư viện Google Photos của họ và chia sẻ những nội dung đó với ứng dụng của bạn.
Trước khi bắt đầu
Quy trình của API Bộ chọn
Dưới đây là thông tin tổng quan về cách hoạt động của API Bộ chọn:
Kiểm tra mã thông báo OAuth: Trước khi bắt đầu quy trình API bộ chọn, hãy kiểm tra mã truy cập OAuth 2.0 hợp lệ cho người dùng. Nếu không có mã thông báo, hãy bắt đầu quy trình uỷ quyền OAuth 2.0 để lấy mã thông báo.
Tạo phiên: Bắt đầu quy trình bằng cách gọi đến API Bộ chọn để tạo một phiên mới. Lệnh gọi này sẽ trả về một pickerUri duy nhất.
Chuyển hướng người dùng đến ứng dụng Google Photos: Cung cấp pickerUri cho người dùng (dưới dạng đường liên kết có thể nhấp hoặc mã QR). URL này sẽ mở ứng dụng Google Photos của trẻ một cách an toàn.
Người dùng chọn các mục nội dung nghe nhìn: Trong ứng dụng Google Photos, người dùng có thể duyệt qua thư viện của họ và chọn những bức ảnh và video mà họ muốn chia sẻ với ứng dụng của bạn. Hãy đọc thông tin tổng quan về trải nghiệm chọn của người dùng.
Thăm dò ý kiến phiên: Ứng dụng của bạn phải định kỳ thăm dò ý kiến phiên để kiểm tra trạng thái. Bạn đang tìm thuộc tính mediaItemsSet để trả về giá trị true, cho biết người dùng đã hoàn tất lựa chọn của họ.
Liệt kê các mục nội dung nghe nhìn đã chọn: Sau khi mediaItemsSet trả về true, bạn có thể sử dụng phương thức danh sách để xem thông tin chi tiết về các mục nội dung nghe nhìn đã chọn.
Truy xuất và sử dụng các mục nội dung nghe nhìn: Giờ đây, bạn có quyền truy cập vào các mục nội dung nghe nhìn đã chọn. Bạn có thể tìm nạp nội dung của các ứng dụng đó bằng cách sử dụng baseUrl và sử dụng nội dung đó trong ứng dụng của mình.
Các bước tiếp theo
- Xem lại tài liệu tham khảo: Khám phá tài liệu tham khảo chi tiết về API bộ chọn để tìm hiểu về tất cả các phương thức và tham số có sẵn.
- Thử các mẫu: Hãy xem mẫu của chúng tôi để xem API bộ chọn hoạt động như thế nào và lấy cảm hứng để tích hợp.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-29 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-29 UTC."],[[["\u003cp\u003eThe Picker API lets users securely select photos and videos from their Google Photos library and share them with your application.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the Picker API, ensure it's the right fit for your use case and properly configure your app with the necessary API and authentication setup.\u003c/p\u003e\n"],["\u003cp\u003eThe Picker API flow involves creating a session, directing users to the Google Photos app for selection, polling the session for completion, and then retrieving the selected media items.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers should check the provided resources like reference documentation and samples for detailed information and implementation examples.\u003c/p\u003e\n"]]],["The Picker API enables users to share media from Google Photos with your app. First, check for and obtain an OAuth token. Then, create a new session via the Picker API, generating a `pickerUri`. Direct users to this URI to select media. Periodically poll the session until `mediaItemsSet` is true. Use the list method to retrieve details of selected items, and then access their content using `baseUrl` for use in your application.\n"],null,["# Get started with the Picker API\n\nThe Picker API provides a secure way for your users to select photos and videos\nfrom their Google Photos library and share them with your application.\n\nBefore you start\n----------------\n\n- **Check out the overview:** [Compare the Picker API and the Library API](/photos/overview/about) to make sure the Picker API is the right fit for your use case.\n- **Configure your app:** Enable the API and set up authentication. See [Configure your app](/photos/overview/configure-your-app) for detailed steps.\n\nThe Picker API flow\n-------------------\n\nHere is an overview of the how the Picker API works:\n\n1. **Check for OAuth token:** Before starting the Picker API flow, check for a\n valid OAuth 2.0 access token for the user. If there is no token, [initiate\n the OAuth 2.0 authorization flow](/identity/protocols/oauth2) to obtain one.\n\n2. **Create a session:** Initiate the process by making a call to the Picker\n API to [create a new\n session](/photos/picker/reference/rest/v1/sessions/create). This call will\n return a unique `pickerUri`.\n\n3. **Direct users to the Google Photos app:** Provide the [`pickerUri`](/photos/picker/reference/rest/v1/sessions#PickingSession.FIELDS.picker_uri)\n to your users (either as a clickable link or a QR code). This URL will\n securely open their Google Photos app.\n\n4. **User selects media items:** Within the Google Photos app, users can browse\n their library and select the photos and videos they want to share with your\n app. Read an overview of the [user's picking experience](/photos/picker/guides/picking-experience).\n\n5. **Poll the session:** Your app should periodically [poll the session](/photos/picker/reference/rest/v1/sessions/get)\n to check the status. You're looking for the\n [`mediaItemsSet`](/photos/picker/reference/rest/v1/sessions#PickingSession.FIELDS.media_items_set)\n property to return true, indicating the user has finished their selection.\n\n | **Note:** Every time you poll a session the response contains [recommended\n | intervals and\n | timeouts](/photos/picker/reference/rest/v1/sessions#PollingConfig) to configure your polling.\n6. **List selected media items:** Once `mediaItemsSet` returns true, you can\n use [the list method](/photos/picker/reference/rest/v1/mediaItems/list) to\n get details about the selected media items.\n\n7. **Retrieve and use media items:** Now you have access to the selected media\n items. You can [fetch their\n content](/photos/picker/guides/media-items#retrieve-picked-media-items)\n using the\n [`baseUrl`](/photos/picker/reference/rest/v1/mediaItems#MediaFile.FIELDS.base_url)\n and utilize them within your application.\n\nNext steps\n----------\n\n- Review the reference docs: Explore the detailed [Picker API reference\n documentation](/photos/picker/reference/rest) to learn about all the available methods and parameters.\n- Try out the samples: Check out our [sample](/photos/picker/samples) to see the Picker API in action and get inspiration for your integration."]]
