Method: sessions.create
Generuje nową sesję, podczas której użytkownik może wybrać zdjęcia i filmy, do których ma uzyskać dostęp aplikacja innej firmy.
Jeśli użytkownik nie ma aktywnego konta Zdjęć Google, zwracany jest błąd FAILED_PRECONDITION.
Jeśli aplikacja kliencka tworzy zbyt wiele sesji na użytkownika, zwracany jest błąd RESOURCE_EXHAUSTED. W normalnych okolicznościach klienci raczej nie osiągną tych limitów. Nadal zalecamy jednak, aby po każdej sesji wywoływać funkcję sessions.delete, aby aktywnie dbać o nieprzekraczanie limitów zasobów.
Żądanie HTTP
POST https://photospicker.googleapis.com/v1/sessions
Adres URL używa składni transkodowania gRPC.
Parametry zapytania
| Parametry |
requestId |
string
Opcjonalnie: Unikalny identyfikator podany przez klienta dla tego żądania. Ten identyfikator służy do uproszczenia procesu wybierania w przypadku aplikacji korzystających z protokołu OAuth 2.0 na urządzeniach z ograniczonymi możliwościami wprowadzania danych. Identyfikator musi mieć format ciągu znaków UUID (wersja 4) i spełniać te wymagania:
- Nie może zawierać żadnych poufnych informacji umożliwiających identyfikację użytkownika.
- Musi zawierać 32 znaki szesnastkowe podzielone na 5 grup rozdzielonych myślnikami w postaci „xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx” (lub 8-4-4-4-12).
|
Treść żądania
Treść żądania zawiera wystąpienie elementu PickingSession.
Treść odpowiedzi
Jeśli operacja się powiedzie, treść odpowiedzi będzie zawierała nowo utworzoną instancję PickingSession.
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/photospicker.mediaitems.readonly
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-03-10 UTC.
[null,null,["Ostatnia aktualizacja: 2025-03-10 UTC."],[[["This endpoint creates a session for users to select photos and videos for third-party access."],["A `FAILED_PRECONDITION` error occurs if the user lacks an active Google Photos account."],["Excessive session creation leads to a `RESOURCE_EXHAUSTED` error, though unlikely under normal use."],["Clients should call `sessions.delete` after each session to avoid exceeding resource limits."],["Requires the `https://www.googleapis.com/auth/photospicker.mediaitems.readonly` OAuth scope for authorization."]]],["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"]]
