Method: sessions.create

Tạo một phiên mới, trong đó người dùng có thể chọn ảnh và video để bên thứ ba truy cập.

Nếu người dùng không có tài khoản Google Photos đang hoạt động, hệ thống sẽ trả về lỗi FAILED_PRECONDITION.

Nếu ứng dụng khách tạo quá nhiều phiên trên mỗi người dùng, lỗi RESOURCE_EXHAUSTED sẽ được trả về. Trong trường hợp bình thường, khách hàng khó có thể đạt đến các giới hạn này. Tuy nhiên, bạn vẫn nên gọi sessions.delete sau mỗi phiên để chủ động duy trì trong giới hạn tài nguyên.

Sau khi người dùng nhấn vào nút Xong để hoàn tất một phiên chọn, pickerUri sẽ không còn hoạt động nữa. Tạo một phiên mới để cho phép người dùng chọn thêm ảnh.

Yêu cầu HTTP

POST https://photospicker.googleapis.com/v1/sessions

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số truy vấn

Thông số
requestId

string

Không bắt buộc. Giá trị nhận dạng duy nhất do ứng dụng khách cung cấp cho yêu cầu này.

Mã nhận dạng này được dùng để cung cấp trải nghiệm chọn được tinh giản cho các ứng dụng sử dụng quy trình OAuth 2.0 cho các thiết bị có phương thức nhập hạn chế.

Mã nhận dạng này phải có định dạng chuỗi UUID (phiên bản 4) và tuân thủ các yêu cầu sau:

  • Không được chứa bất kỳ thông tin nhận dạng nhạy cảm nào về người dùng.
  • Phải chứa 32 ký tự hệ thập lục phân được chia thành 5 nhóm, phân tách nhau bằng dấu gạch nối, theo định dạng "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" (hoặc 8-4-4-4-12).

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của PickingSession.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể PickingSession mới tạo.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/photospicker.mediaitems.readonly