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, zostanie zwrócony 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 nie są skłonni do przekroczenia tych limitów. Nadal zalecamy jednak, aby po każdej sesji wywołać 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.
Treść żądania
Treść żądania zawiera wystąpienie elementu PickingSession
.
Treść odpowiedzi
Jeśli operacja się uda, 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