Method: sessions.create

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

Kullanıcının etkin bir Google Fotoğraflar hesabı yoksa FAILED_PRECONDITION hatası döndürülür.

İstemci uygulaması kullanıcı başına çok fazla oturum oluşturuyorsa RESOURCE_EXHAUSTED hatası döndürülür. Müşterilerin normal koşullarda bu sınırlara ulaşması olası değildir. Ancak müşterilerin, kaynak sınırlarını proaktif olarak aşmamak için her oturumdan sonra sessions.delete çağrısı yapması önerilir.

Bir kullanıcı, toplama oturumunu tamamlamak için Bitti düğmesine dokunduğunda pickerUri artık çalışmaz. Kullanıcının daha fazla fotoğraf seçmesine izin vermek için yeni bir oturum oluşturun.

HTTP isteği

POST https://photospicker.googleapis.com/v1/sessions

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Sorgu parametreleri

Parametreler
requestId

string

İsteğe bağlı. Bu istek için istemci tarafından sağlanan benzersiz tanımlayıcı.

Bu kimlik, sınırlı girişli cihazlar için OAuth 2.0 akışını kullanan uygulamalarda basitleştirilmiş seçim deneyimini etkinleştirmek amacıyla kullanılır.

Bu kimlik, UUID (4. sürüm) dizesi biçiminde olmalı ve aşağıdaki koşulları karşılamalıdır:

  • Kullanıcıyla ilgili hassas tanımlayıcı bilgiler içermemelidir.
  • "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" (veya 8-4-4-4-12) biçiminde, kısa çizgilerle ayrılmış beş gruba bölünmüş 32 on altılı karakter içermelidir.

İstek içeriği

İstek metni, PickingSession öğesinin bir örneğini içerir.

Yanıt gövdesi

Başarılı olursa yanıt metni, yeni oluşturulmuş bir PickingSession örneği içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/photospicker.mediaitems.readonly