Oturum oluşturma ve yönetme

Oturumlar, Picker API'nin merkezinde yer alır ve kullanıcıların Google Fotoğraflar kitaplıklarından fotoğraf ve albüm seçmeleri için güvenli ve kontrollü bir yol sunar. Bu kılavuzda, uygulamanızda sorunsuz bir fotoğraf seçimi sağlamak için oturumların nasıl oluşturulacağı, yönetileceği ve etkili bir şekilde ankete tabi tutulacağı açıklanmaktadır.

Başlamadan önce

  • Uygulamanızı yapılandırın: API'yi etkinleştirin ve kimlik doğrulamayı ayarlayın. Görüntüleyin Ayrıntılı bilgi için uygulamanızı yapılandırın adım.
  • Akışı anlama: Picker API'yi kullanmaya başlama başlıklı makaleyi inceleyin. sayfasına göz atın.
  • Gerekli yetkilendirme kapsamlarını incele: Oturumlarla çalışmak için photospicker.mediaitems.readonly kapsamı. Kapsamlar hakkında daha fazla bilgi için Yetkilendirme kapsamları başlıklı makaleyi inceleyin.

Oturum yaşam döngüsü

Picker API'si, kullanıcılarınızla ilgili bilgi oluşturma, alma silme. Kullanıcılarınızın kimliğini doğruladıktan sonra oturumları kullanarak yaşam döngüsünü ilerleteceksiniz.

  1. Bir kullanıcının medya öğelerini seçmesini sağlamak için oturum oluşturun.
  2. Kullanıcının şu işlemleri ne zaman yaptığını kontrol etmek için oturumu yoklayın. medya öğelerini seçmeyi bitirdi.
  3. Medya öğelerini listeleme ve alma.
  4. Oturumu silerek temizleyin.

Oturum oluşturma

Kullanıcılarınızın doğrudan kendi cihazlarından güvenli bir şekilde fotoğraf seçebilmeleri için bir oturum oluşturun paylaşıp tekrar uygulamanızda paylaşabilirsiniz.

sessions.create, yeni bir oturum oluşturur ve oturumu açık olan benzersiz bir pickerUri döndürür. sunabileceğiniz birkaç farklı adım vardır. Oturum, kullanıcı veya oturum zaman aşımına uğrar.

Oturum sınırları

Oturum sınırlarını göz önünde bulundurun. Picker API, sorumlu kullanım sağlamak ve kötüye kullanımı önlemek için oluşturabileceğiniz oturum sayısıyla ilgili sınırlar uygular. Şunun altında: normal koşullarda bu sınırlara ulaşmanız pek olası değildir. Ancak oturumları proaktif olarak izleyin ve sorunları.

Oturumları anket ve izleme

Bir oturum oluşturulduktan sonra, sessions.get uç noktasını düzenli aralıklarla anket yaparak oturumun durumunu gösterir. Yanıttaki mediaItemsSet özelliği şu sonuçları döndürür: Kullanıcı seçimini tamamladığında true.

Etkili yoklama kullandığınızdan emin olun. sessions.get yanıtı pollingConfig nesnesini içerir. Gereksiz durumlardan kaçınmak için aşağıdaki alanları kullanın ve sorunsuz bir kullanıcı deneyimi sunmak için:

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

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

Oturumları silme ve temizleme

sessions.delete, bir oturumu kaldırır. Bu işlev genellikle kullanıcı medya seçimini tamamladıktan sonra veya oturum zaman aşımına uğradığında temizlik için kullanılır.

En iyi uygulama, kullanıcı medya öğelerini seçtikten sonra oturumları silmektir ve uygulamanız medya öğesini aldı bayt olarak kabul edilir.

Örnek anket akışı

Bu, oturum oluşturma ve yoklama örneğidir. Kullanıcınızın kimliğini 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'yi arayın.
  2. pickerUri öğesini kullanıcıya gösterin: URL'yi gösterin veya QR kodu oluşturun. kullanıcının tarayabileceği bir kod içerir.
  3. Oturumda anket yapın:
    1. pollingConfig tarafından önerilen PolInterval değerini kullanın.
    2. mediaItemsSet değerinin doğru olup olmadığını kontrol edin.
      1. true ise seçilen medya öğelerini listelemeye devam edin.
      2. false ise timeoutIn değerine ulaşılana kadar yoklamaya devam edin.
    3. Zaman aşımlarını ve iptalleri sorunsuz şekilde ele alın.
GET https://photoslibrary.googleapis.com/v1/sessions/{sessionId}

Örnek bir yanıt şöyle:

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

pickerUri'ü kullanıcıya gösterin ve ardından oturumu anketlemeye başlayın.

Yanıtta aşağıdakileri kontrol edin:

  • mediaItemsSet: Kullanıcı medya öğelerini seçmeyi tamamladıysa doğru değerini döndürür.
  • pollingConfig.pollInterval: Sonraki ankete geçmeden önce beklemeniz önerilen süre
  • pollingConfig.timeoutIn: öncesinde beklenecek toplam süre zaman aşımı

mediaItemsSet false (yanlış) değerine ayarlanmışsa ve timeoutIn adlı kullanıcıya ulaşılmadıysa şunun için bekleyin: pollInterval, ardından tekrar anket yapın.

mediaItemsSet doğruysa seçili medya öğelerini listeleyebilirsiniz.

timeoutIn e-posta adresine ulaşılırsa zaman aşımını sorunsuz bir şekilde giderin.