Picker API'yi kullanmaya başlama

Picker API, kullanıcılarınızın Google Fotoğraflar kitaplıklarındaki fotoğraf ve videoları seçip uygulamanızla paylaşmaları için güvenli bir yol sunar.

Başlamadan önce

• Genel bakışa göz atın: Picker API ile Library API'yi karşılaştırarak kullanım alanınıza en uygun API'nin Picker API olduğundan emin olun.
• 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.

Picker API akışı

Seçici API'nin işleyiş şekliyle ilgili genel bakışı aşağıda bulabilirsiniz:

1. OAuth jetonunu kontrol edin: Seçici API akışını başlatmadan önce kullanıcı için geçerli bir OAuth 2.0 erişim jetonunun olup olmadığını kontrol edin. Jeton yoksa OAuth 2.0 yetkilendirme akışını başlatarak jeton alın.

2. Oturum oluşturma: Picker API'ye yeni bir oturum oluşturma çağrısı yaparak süreci başlatın. Bu çağrı, benzersiz bir pickerUri döndürür.

3. Kullanıcıları Google Fotoğraflar uygulamasına yönlendirme: Kullanıcılarınıza pickerUri (tıklanabilir bir bağlantı veya QR kodu olarak) sağlayın. Bu URL, kullanıcının Google Fotoğraflar uygulamasını güvenli bir şekilde açar. Web tabanlı uygulamalarda, kullanıcı seçimini tamamladıktan sonra Google Fotoğraflar penceresini otomatik olarak kapatmak için bu URI'ye /autoclose ekleyebilirsiniz.

4. Kullanıcı medya öğelerini seçer: Kullanıcılar, Google Fotoğraflar uygulamasında kitaplıklarına göz atabilir ve uygulamanızla paylaşmak istedikleri fotoğraf ve videoları seçebilir. Kullanıcının seçim deneyimiyle ilgili genel bilgileri inceleyin.

5. Oturumu yoklama: Uygulamanız, durumu kontrol etmek için oturumu düzenli olarak yoklamalıdır. Kullanıcının seçimini tamamladığını belirten mediaItemsSet özelliğinin doğru değerini döndürmesini istiyorsunuz.

   Not: Bir oturumu her yokladığınızda, yoklamanızı yapılandırmak için yanıtta önerilen aralıklar ve zaman aşımları yer alır.

6. Seçilen medya öğelerini listeleme: mediaItemsSet doğru değerini döndürdüğünde, seçilen medya öğeleriyle ilgili ayrıntıları almak için liste yöntemini kullanabilirsiniz.

7. Medya öğelerini alma ve kullanma: Seçilen medya öğelerine artık erişebilirsiniz. İçeriklerini baseUrl kullanarak baseUrl getirebilir ve uygulamanızda kullanabilirsiniz.

Sonraki adımlar

• Başvuru belgelerini inceleyin: Kullanılabilir tüm yöntemler ve parametreler hakkında bilgi edinmek için ayrıntılı Picker API başvuru belgelerini inceleyin.
• Örnekleri deneyin: Picker API'nin nasıl çalıştığını görmek ve entegrasyonunuz için ilham almak üzere örneğimize göz atın.