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 |
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:
|
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