Method: sessions.create
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
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 klienta 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 wywoływanie funkcji sessions.delete po każdej sesji, aby aktywnie utrzymywać się w ramach limitów zasobów.
Gdy użytkownik kliknie przycisk Gotowe, aby zakończyć sesję kompletowania, element pickerUri przestanie działać. Utwórz nową sesję, aby umożliwić użytkownikowi wybranie większej liczby zdjęć.
Żą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-07-25 UTC.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-07-25 UTC."],[],["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"]]
