Oturum oluşturma ve yönetme

Oturumlar, Picker API'nin temelini oluşturur. Kullanıcılara Google Fotoğraflar kitaplıklarından fotoğraf ve video seçmek için güvenli ve kontrollü bir yol sunar. Bu kılavuzda, uygulamanızda sorunsuz fotoğraf seçimi sağlamak için oturumları nasıl oluşturacağınız, yöneteceğiniz ve etkili bir şekilde yoklayacağınız açıklanmaktadır.

Başlamadan önce

  • Uygulamanızı yapılandırın: API'yi etkinleştirin ve kimlik doğrulamayı ayarlayın. Ayrıntılı adımlar için Uygulamanızı yapılandırma başlıklı makaleyi inceleyin.
  • Akışı anlama: Tüm fotoğraf seçme sürecine genel bir bakış için Picker API'yi kullanmaya başlama başlıklı makaleyi inceleyin.
  • Gerekli yetkilendirme kapsamlarını inceleyin: Oturumlarla çalışmak için photospicker.mediaitems.readonly kapsamı gerekir. Kapsamlar hakkında daha fazla bilgi için Yetkilendirme kapsamları başlıklı makaleyi inceleyin.

Oturum yaşam döngüsü

Picker API, oturum oluşturma, oturumlarla ilgili bilgileri alma ve oturumları silme yöntemleri sağlar. Kullanıcılarınızın kimliğini doğruladıktan sonra, fotoğraf seçme yaşam döngüsünü yönetmek için oturumları kullanabilirsiniz.

  1. Kullanıcının medya öğelerini seçmesine olanak tanımak için oturum oluşturun.
  2. Kullanıcının medya öğelerini seçmeyi ne zaman tamamladığını kontrol etmek için oturumda anket yapın.
  3. Medya öğelerini listeleme ve alma
  4. Oturumu silerek temizleyin.

Oturum oluşturma

Kullanıcılarınızın doğrudan Google Fotoğraflar uygulamasından güvenli bir şekilde fotoğraf seçip uygulamanızla paylaşabilmesi için bir oturum oluşturun.

sessions.create, yeni bir oturum oluşturur ve kullanıcılarınıza sunabileceğiniz benzersiz bir pickerUri döndürür. Oturum, kullanıcı medya öğelerini başarıyla seçene veya oturum zaman aşımına uğrayana kadar etkin kalır. Web tabanlı uygulamalarda, kullanıcı seçimini tamamladıktan sonra Google Fotoğraflar penceresini veya sekmesini otomatik olarak kapatmak için /autoclose öğesini pickerUri öğesine ekleyebilirsiniz. Ayrıntılar için Fotoğraf seçme: Kullanıcıların gördükleri başlıklı makaleyi inceleyin.

Oturum sınırları

Oturum sınırlarına dikkat edin. Picker API, sorumlu kullanımı sağlamak ve kötüye kullanımı önlemek için oluşturabileceğiniz oturum sayısına sınır getirir. Normal koşullarda bu sınırlara ulaşmanız olası değildir. Ancak sorun yaşamamak için oturumları izlemeniz ve proaktif olarak temizlemeniz gerekir.

Anket ve izleme oturumları

Bir oturum oluşturulduktan sonra, oturumun durumunu almak için sessions.get uç noktasını düzenli olarak yoklayın. Yanıtın mediaItemsSet özelliği, kullanıcı seçimini tamamladığında true değerini döndürür.

Verimli yoklama kullandığınızdan emin olun. sessions.get yanıtı pollingConfig nesnesini içerir. Gereksiz aramaları önlemenize ve sorunsuz bir kullanıcı deneyimi oluşturmanıza yardımcı olması için aşağıdaki alanları kullanın:

  • pollInterval: optimal yoklama aralıkları
  • timeoutIn: zaman aşımı süresi

Daha fazla bilgi için Örnek yoklama akışı bölümüne bakın.

Oturumları silme ve temizleme

sessions.delete, oturumu kaldırır. Genellikle kullanıcı medya seçme işlemini tamamladıktan sonra veya oturum zaman aşımına uğradığında temizlik için kullanılır.

Kullanıcı medya öğelerini seçtikten ve uygulamanız medya öğesi baytlarını aldıktan sonra oturumları silmek en iyi uygulamadır.

Örnek anket akışı

Bu örnekte, oturum oluşturma ve oturumda anket yapma gösterilmektedir. Kullanıcınızın kimliğini ilk kez doğruladıktan sonra yeni bir oturum oluşturun.

  1. Oturum oluşturma: Yeni bir oturum başlatmak ve pickerUri almak için sessions.create numaralı telefonu arayın.
  2. pickerUri belgesini kullanıcıya sunun: URL'yi gösterin veya kullanıcının taraması için bir QR kodu oluşturun. Kullanıcının seçim deneyimine genel bir bakış okuyun.
  3. Oturumda anket yapma:
    1. pollingConfig tarafından önerilen pollInterval değerini kullanın.
    2. mediaItemsSet ifadesinin doğru olup olmadığını kontrol edin.
      1. true ise seçilen medya öğelerini listelemeye devam edin.
      2. false ise timeoutIn'ye ulaşılana kadar anket yapmaya devam edin.
    3. Zaman aşımlarını ve iptalleri sorunsuz şekilde yönetin.
GET https://photoslibrary.googleapis.com/v1/sessions/{sessionId}

Örnek yanıt:

{
  "id": string,
  "pickerUri": string,
  "pollingConfig": {
    object (PollingConfig)
  },
  "mediaItemsSet": boolean
}

Kullanıcıya pickerUri simgesini gösterin ve ardından oturumda anket yapmaya başlayın.

Yanıtı aşağıdaki açılardan kontrol edin:

  • mediaItemsSet: Kullanıcı medya öğelerini seçmeyi bitirdiyse true
  • pollingConfig.pollInterval: Bir sonraki anketten önce beklemeniz önerilen süre
  • pollingConfig.timeoutIn: zaman aşımına uğramadan önce beklenecek toplam süre

mediaItemsSet yanlışsa ve timeoutIn değerine ulaşılmamışsa pollInterval değerinin gelmesini bekleyin ve ardından tekrar yoklama yapın.

mediaItemsSet doğruysa seçili medya öğelerini listelemeye devam edin.

timeoutIn değerine ulaşılırsa zaman aşımı düzgün şekilde işlenmelidir.