REST Resource: sessions
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Kaynak: PickingSession
Kullanıcının Google Fotoğraflar'ı kullanarak fotoğraf ve video seçebileceği bir kullanıcı oturumunu temsil eder.
| 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üleyebilmek için kullanıcının web tarayıcısında bu oturumun sahibi olan Google Hesabı'nda oturum açmış olması gerekir. pickerUri, güvenlik nedeniyle bir iframe'de açılamaz.
|
pollingConfig |
object (PollingConfig)
Yalnızca çıkış. Uygulamaların sessions.get anketi sırasında kullanması önerilen yapılandırma. Bu alan yalnızca bu oturum için medya öğeleri henüz seçilmemişse (ör. mediaItemsSet yanlıştır).
|
expireTime |
string (Timestamp format)
Yalnızca çıkış. Bu oturuma (ve seçilen medya öğelerine) erişimin sona ereceği saat. Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de 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ı. Kullanıcının bu oturumdaki fotoğraf seçme 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 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 mediaItems.list aracılığıyla seçilen medya öğelerinin listesini isteyebilir.
|
PollingConfig
API'yi yoklamak için yapılandırma.
| JSON gösterimi |
{
"pollInterval": string,
"timeoutIn": string
} |
| Alanlar |
pollInterval |
string (Duration format)
Yalnızca çıkış. Anket istekleri arasındaki ö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 anket yapmayı bırakması gereken süre. 0 değeri, istemcinin henüz yapmadıysa anket yapmayı bırakması 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 seçim deneyimi için istemci tarafından belirtilen yapılandırma.
| JSON gösterimi |
{
"maxItemCount": string
} |
| Alanlar |
maxItemCount |
string (int64 format)
İsteğe bağlı. Kullanıcının bu oturum sırasında seçebileceği maksimum öğe sayısı. Belirtilmezse varsayılan olarak 2000 değerine ayarlanır. Belirtilmemişse veya 0 olarak ayarlanmışsa en fazla 2.000 öğe seçilebilir. 2000'den yüksek değerler 2000 olarak zorlanacaktır. Negatif değerler INVALID_ARGUMENT hatasına neden olur.
|
Yöntemler |
|
|
Kullanıcının üçüncü taraf erişimi için fotoğraf ve video seçebileceği yeni bir oturum oluşturur. |
|
|
Belirtilen oturumu siler. |
|
|
Belirtilen oturumla ilgili bilgileri getirir. |
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-25 UTC.
[null,null,["Son güncelleme tarihi: 2025-07-25 UTC."],[[["\u003cp\u003eGoogle Photos Picker API provides sessions for users to select photos and videos.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ePickingSession\u003c/code\u003e resource represents the user's selection session, including a URI to redirect users to Google Photos for picking media.\u003c/p\u003e\n"],["\u003cp\u003eApplications can poll the API using the recommended \u003ccode\u003ePollingConfig\u003c/code\u003e to check for session updates and retrieve selected media items.\u003c/p\u003e\n"],["\u003cp\u003eSessions have an expiration time and can be programmatically created, retrieved, and deleted using the API methods.\u003c/p\u003e\n"]]],["A `PickingSession` represents a user's photo/video selection process in Google Photos, identified by a unique ID. It provides a `pickerUri` to direct users to Google Photos for media selection. `PollingConfig` defines API polling parameters with `pollInterval` and `timeoutIn`. A session expires at a specified `expireTime`, after which access ends. Once `mediaItemsSet` is true, selected media can be requested. Methods allow to `create`, `get` and `delete` sessions.\n"],null,["# REST Resource: sessions\n\n- [Resource: PickingSession](#PickingSession)\n - [JSON representation](#PickingSession.SCHEMA_REPRESENTATION)\n- [PollingConfig](#PollingConfig)\n - [JSON representation](#PollingConfig.SCHEMA_REPRESENTATION)\n- [PickingConfig](#PickingConfig)\n - [JSON representation](#PickingConfig.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: PickingSession\n------------------------\n\nRepresentation of a user session during which the user can pick photos and videos using Google Photos.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"id\": string, \"pickerUri\": string, \"pollingConfig\": { object (/photos/picker/reference/rest/v1/sessions#PollingConfig) }, \"expireTime\": string, \"pickingConfig\": { object (/photos/picker/reference/rest/v1/sessions#PickingConfig) }, \"mediaItemsSet\": boolean } ``` |\n\n| Fields ||\n|-----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `id` | `string` Output only. The Google-generated identifier for this session. |\n| `pickerUri` | `string` Output only. The URI used to redirect the user to Google Photos (on web) so they can pick photos and videos for the current session. To view this page successfully, the user must be logged into the Google account that owns this session in their web browser. The `pickerUri` cannot be opened in an iframe due to security reasons. |\n| `pollingConfig` | `object (`[PollingConfig](/photos/picker/reference/rest/v1/sessions#PollingConfig)`)` Output only. The recommended configuration that applications should use while polling `sessions.get`. This field is only populated if media items have not yet been picked for this session (i.e., `mediaItemsSet` is false). |\n| `expireTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Output only. Time when access to this session (and its picked media items) will expire. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`. |\n| `pickingConfig` | `object (`[PickingConfig](/photos/picker/reference/rest/v1/sessions#PickingConfig)`)` Optional. Photo-picking configuration for the user's picking experience during this session. This is specified by the client application when calling `sessions.create`, and cannot be modified after the fact (without creating a new session). |\n| `mediaItemsSet` | `boolean` Output only. If set to `true`, media items have been picked for this session and your application can request the list of picked media items via `mediaItems.list`. |\n\nPollingConfig\n-------------\n\nConfiguration for polling the API.\n\n| JSON representation |\n|---------------------------------------------------------|\n| ``` { \"pollInterval\": string, \"timeoutIn\": string } ``` |\n\n| Fields ||\n|----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pollInterval` | `string (`[Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration)` format)` Output only. Recommended time between poll requests. A duration in seconds with up to nine fractional digits, ending with '`s`'. Example: `\"3.5s\"`. |\n| `timeoutIn` | `string (`[Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration)` format)` Output only. The length of time after which the client should stop polling. A value of 0 indicates that the client should stop polling if it hasn't already. A duration in seconds with up to nine fractional digits, ending with '`s`'. Example: `\"3.5s\"`. |\n\nPickingConfig\n-------------\n\nClient-specified configuration for the user's picking experience during this session.\n\n| JSON representation |\n|------------------------------------|\n| ``` { \"maxItemCount\": string } ``` |\n\n| Fields ||\n|----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `maxItemCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Optional. The maximum number of items that the user can pick during this session. Defaults to 2000 if not specified. If unspecified or set to 0, at most 2000 items can be picked. Values above 2000 will be coerced to 2000. Negative values will result in an `INVALID_ARGUMENT` error. |\n\n| Methods ------- ||\n|----------------------------------------------------------------|--------------------------------------------------------------------------------------------------|\n| ### [create](/photos/picker/reference/rest/v1/sessions/create) | Generates a new session during which the user can pick photos and videos for third-party access. |\n| ### [delete](/photos/picker/reference/rest/v1/sessions/delete) | Deletes the specified session. |\n| ### [get](/photos/picker/reference/rest/v1/sessions/get) | Retrieves information about the specified session. |"]]
