REST Resource: sessions

Zasób: PickingSession

Sesja użytkownika, podczas której może on wybierać zdjęcia i filmy w Zdjęciach Google.

Zapis JSON
{
  "id": string,
  "pickerUri": string,
  "pollingConfig": {
    object (PollingConfig)
  },
  "expireTime": string,
  "pickingConfig": {
    object (PickingConfig)
  },
  "mediaItemsSet": boolean
}
Pola
id

string

Tylko dane wyjściowe. Wygenerowany przez Google identyfikator tej sesji.

pickerUri

string

Tylko dane wyjściowe. Identyfikator URI używany do przekierowywania użytkownika do Zdjęć Google (w wersji internetowej), aby mógł wybrać zdjęcia i filmy do bieżącej sesji.

Aby wyświetlić tę stronę, użytkownik musi zalogować się w przeglądarce na konto Google, które jest właścicielem tej sesji.

Ze względów bezpieczeństwa nie można otworzyć elementu pickerUri w ramce iframe.

pollingConfig

object (PollingConfig)

Tylko dane wyjściowe. Zalecana konfiguracja, której aplikacje powinny używać podczas uzyskiwania dostępu do usługi sessions.get.

To pole jest wypełnione tylko wtedy, gdy elementy multimedialne nie zostały jeszcze wybrane w tej sesji (tzn. mediaItemsSet ma wartość false (fałsz).

expireTime

string (Timestamp format)

Tylko dane wyjściowe. Czas, w którym dostęp do tej sesji (i wybranych elementów multimedialnych) wygaśnie.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są również przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

pickingConfig

object (PickingConfig)

Opcjonalnie: Konfiguracja wyboru zdjęć, która określa, jak użytkownik będzie wybierać zdjęcia w ramach tej sesji.

Jest ona określana przez aplikację klienta podczas wywołania sessions.create i nie można jej zmienić w drobnych szczegółach (bez tworzenia nowej sesji).

mediaItemsSet

boolean

Tylko dane wyjściowe. Jeśli wartość to true, oznacza to, że w ramach tej sesji wybrano elementy multimedialne, a Twoja aplikacja może poprosić o listę wybranych elementów multimedialnych za pomocą mediaItems.list.

PollingConfig

Konfiguracja pollingu interfejsu API.

Zapis JSON
{
  "pollInterval": string,
  "timeoutIn": string
}
Pola
pollInterval

string (Duration format)

Tylko dane wyjściowe. Zalecana przerwa między prośbami o ankietę

Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „s”. Przykład: "3.5s".

timeoutIn

string (Duration format)

Tylko dane wyjściowe. Czas, po którym klient powinien przestać wysyłać zapytania.

Wartość 0 wskazuje, że klient powinien przestać wysyłać zapytania, jeśli jeszcze tego nie zrobił.

Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „s”. Przykład: "3.5s".

PickingConfig

Konfiguracja określona przez klienta w celu wyboru przez użytkownika podczas tej sesji.

Zapis JSON
{
  "maxItemCount": string
}
Pola
maxItemCount

string (int64 format)

Opcjonalnie: Maksymalna liczba elementów, które użytkownik może wybrać podczas tej sesji. Jeśli nie zostanie podany, przyjmuje się wartość 2000.

Jeśli nie zostanie podana wartość lub zostanie ustawiona wartość 0, można wybrać maksymalnie 2000 elementów. Wartości powyżej 2000 zostaną sformatowane na 2000. Wartości ujemne spowodują błąd INVALID_ARGUMENT.

Metody

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.

delete

Usunięcie określonej sesji.

get

Pobiera informacje o określonej sesji.