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
- Xem thông tin tổng quan: So sánh Picker API và Library API để đảm bảo Picker API phù hợp với trường hợp sử dụng của bạn.
- Định cấu hình ứng dụng: Bật API và thiết lập quy trình xác thực. Hãy xem bài viết Định cấu hình ứng dụng để biết các bước chi tiết.
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.