Method: sessions.create
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.
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
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-07-25 UTC.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[[["\u003cp\u003eThis endpoint creates a session for users to select photos and videos for third-party access.\u003c/p\u003e\n"],["\u003cp\u003eA \u003ccode\u003eFAILED_PRECONDITION\u003c/code\u003e error occurs if the user lacks an active Google Photos account.\u003c/p\u003e\n"],["\u003cp\u003eExcessive session creation leads to a \u003ccode\u003eRESOURCE_EXHAUSTED\u003c/code\u003e error, though unlikely under normal use.\u003c/p\u003e\n"],["\u003cp\u003eClients should call \u003ccode\u003esessions.delete\u003c/code\u003e after each session to avoid exceeding resource limits.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/photospicker.mediaitems.readonly\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],["This describes the creation of a new session for users to grant third-party access to their photos and videos. It uses a `POST` request to `https://photospicker.googleapis.com/v1/sessions`. The request body contains a `PickingSession` instance, and a successful response returns a new `PickingSession`. Requires `photospicker.mediaitems.readonly` OAuth scope. Errors include `FAILED_PRECONDITION` for inactive accounts and `RESOURCE_EXHAUSTED` for excessive session creation. Deleting sessions with `sessions.delete` is recommended to manage resources.\n"],null,[]]
