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