REST Resource: sessions

Kaynak: PickingSession

Kullanıcının Google Fotoğraflar'ı kullanarak fotoğraf ve video seçebildiği bir kullanıcı oturumunun temsili.

JSON gösterimi 
{
  "id": string,
  "pickerUri": string,
  "pollingConfig": {
    object (PollingConfig)
  },
  "expireTime": string,
  "pickingConfig": {
    object (PickingConfig)
  },
  "mediaItemsSet": boolean
}
Alanlar
id

string

Yalnızca çıkış. Bu oturum için Google tarafından oluşturulan tanımlayıcı.
pickerUri

string

Yalnızca çıkış. Kullanıcıyı Google Fotoğraflar'a (web'de) yönlendirmek için kullanılan URI. Böylece kullanıcı, mevcut oturum için fotoğraf ve video seçebilir.

Bu sayfayı başarıyla görüntülemek için kullanıcının web tarayıcısında bu oturumun sahibi olan Google Hesabı'na giriş yapmış olması gerekir.

Güvenlik nedeniyle pickerUri, iFrame'de açılamaz.

Web tabanlı uygulamalar için bu URI'ye /autoclose ekleyebilirsiniz. Kullanıcı seçim işlemini tamamladıktan sonra "Bitti" ekranı gösterilmek yerine Google Fotoğraflar penceresi veya sekmesi otomatik olarak kapanır.
pollingConfig

object (PollingConfig)

Yalnızca çıkış. Uygulamaların sessions.get yoklaması sırasında kullanması önerilen yapılandırma.

Bu alan yalnızca bu oturum için henüz medya öğesi seçilmediyse (ör. mediaItemsSet yanlış).
expireTime

string (Timestamp format)

Yalnızca çıkış. Bu oturuma (ve seçilen medya öğelerine) erişimin sona ereceği zaman.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
pickingConfig

object (PickingConfig)

İsteğe bağlıdır. Bu oturum sırasında kullanıcının seçim deneyimi için fotoğraf seçme yapılandırması.

Bu, sessions.create çağrılırken istemci uygulaması tarafından belirtilir ve daha sonra (yeni bir oturum oluşturmadan) değiştirilemez.
mediaItemsSet

boolean

Yalnızca çıkış. true olarak ayarlanırsa bu oturum için medya öğeleri seçilmiştir ve uygulamanız, seçilen medya öğelerinin listesini mediaItems.list aracılığıyla isteyebilir.

PollingConfig

API'yi yoklama yapılandırması.

JSON gösterimi 
{
  "pollInterval": string,
  "timeoutIn": string
}
Alanlar
pollInterval

string (Duration format)

Yalnızca çıkış. Anket istekleri arasında önerilen süre.

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".
timeoutIn

string (Duration format)

Yalnızca çıkış. İstemcinin yoklama yapmayı bırakması gereken süre.

0 değeri, istemcinin henüz yapmadıysa yoklama yapmayı durdurması gerektiğini gösterir.

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

PickingConfig

Bu oturum sırasında kullanıcının toplama deneyimi için istemci tarafından belirtilen yapılandırma.

JSON gösterimi 
{
  "maxItemCount": string
}
Alanlar
maxItemCount

string (int64 format)

İsteğe bağlıdır. Kullanıcının bu oturum sırasında seçebileceği maksimum öğe sayısı. Belirtilmezse varsayılan olarak 2.000'dir.

Belirtilmemişse veya 0 olarak ayarlanmışsa en fazla 2.000 öğe seçilebilir. 2000'in üzerindeki değerler 2000'e zorlanır. Negatif değerler INVALID_ARGUMENT hatasına neden olur.

Yöntemler

create

 Kullanıcının üçüncü taraf erişimi için fotoğraf ve video seçebileceği yeni bir oturum oluşturur.

delete

 Belirtilen oturumu siler.

get

 Belirtilen oturumla ilgili bilgileri alır.