Làm quen với Picker API

Picker 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 rồi chia sẻ với ứng dụng của bạn.

Trước khi bắt đầu

Luồng Picker API

Sau đây là thông tin tổng quan về cách hoạt động của Picker API:

  1. Kiểm tra mã thông báo OAuth: Trước khi bắt đầu quy trình Picker API, hãy kiểm tra xem người dùng có mã truy cập OAuth 2.0 hợp lệ hay không. Nếu không có mã thông báo, hãy khởi chạy quy trình uỷ quyền OAuth 2.0 để lấy mã thông báo.

  2. Tạo một phiên: Bắt đầu quy trình bằng cách gọi Picker API để tạo một phiên mới. Lệnh gọi này sẽ trả về một pickerUri duy nhất.

  3. Chuyển 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 họ một cách an toàn. Đối với các ứng dụng dựa trên web, bạn có thể thêm /autoclose vào URI này để tự động đóng cửa sổ Google Photos sau khi người dùng hoàn tất lựa chọn.

  4. 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 xem 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. Đọc thông tin tổng quan về trải nghiệm chọn của người dùng.

  5. Thăm dò ý kiến về phiên: Ứng dụng của bạn phải định kỳ thăm dò ý kiến về 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ọ.

  6. Liệt kê các mục nội dung nghe nhìn đã chọn: Sau khi mediaItemsSet trả về giá trị true, bạn có thể dùng phương thức list để nhận thông tin chi tiết về các mục nội dung nghe nhìn đã chọn.

  7. 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 đối tượng này bằng baseUrl và sử dụng chúng trong ứng dụng của mình.

Các bước tiếp theo

  • Xem tài liệu tham khảo: Khám phá tài liệu tham khảo chi tiết về Picker API để tìm hiểu về tất cả các phương thức và tham số có sẵn.
  • Dùng thử các mẫu: Hãy xem mẫu của chúng tôi để xem API Trình chọn đang hoạt động và lấy cảm hứng cho quá trình tích hợp của bạn.