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.
[null,null,["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,["# Method: sessions.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nGenerates a new session during which the user can pick photos and videos for third-party access.\n\nIf the user doesn't have an active Google Photos account, a `FAILED_PRECONDITION` error is returned.\n\nIf the client application creates too many sessions per user, a `RESOURCE_EXHAUSTED` error is returned. Clients are unlikely to reach these limits under normal circumstances. However, clients are still recommended to call `sessions.delete` after each session, to proactively stay within resource limits.\n\nOnce [a user taps the **Done**](https://developers.google.com/photos/picker/guides/picking-experience#done_screen) button to complete a picking session, the `pickerUri` will no longer work. Create a new session to allow the user to pick more photos.\n\n### HTTP request\n\n`POST https://photospicker.googleapis.com/v1/sessions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|-------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `requestId` | `string` Optional. A client-provided unique identifier for this request. This ID is used to enable the streamlined picking experience for applications using the OAuth 2.0 flow for limited-input devices. This ID must have the format of a UUID (version 4) string and follow these requirements: - Must not contain any sensitive identifying information about the user. - Must contain 32 hexadecimal characters divided into five groups separated by hyphens, in the format \"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\" (or 8-4-4-4-12). |\n\n### Request body\n\nThe request body contains an instance of [PickingSession](/photos/picker/reference/rest/v1/sessions#PickingSession).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [PickingSession](/photos/picker/reference/rest/v1/sessions#PickingSession).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/photospicker.mediaitems.readonly`"]]
