Picker API menyediakan cara aman bagi pengguna untuk memilih foto dan video dari library Google Foto mereka dan membagikannya ke aplikasi Anda.
Sebelum memulai
- Lihat ringkasan: Membandingkan Picker API dan Library API untuk memastikan Picker API sesuai untuk kasus penggunaan Anda.
- Konfigurasikan aplikasi Anda: Aktifkan API dan siapkan autentikasi. Lihat Mengonfigurasi aplikasi untuk mengetahui langkah-langkah mendetail.
Alur Picker API
Berikut ringkasan cara kerja Picker API:
Periksa token OAuth: Sebelum memulai alur Picker API, periksa token akses OAuth 2.0 yang valid untuk pengguna. Jika tidak ada token, mulai alur otorisasi OAuth 2.0 untuk mendapatkannya.
Buat sesi: Mulai proses dengan melakukan panggilan ke Picker API untuk membuat sesi baru. Panggilan ini akan menampilkan
pickerUri
unik.Arahkan pengguna ke aplikasi Google Foto: Berikan
pickerUri
kepada pengguna Anda (baik sebagai link yang dapat diklik atau kode QR). URL ini akan membuka aplikasi Google Foto mereka dengan aman.Pengguna memilih item media: Dalam aplikasi Google Foto, pengguna dapat menjelajahi library dan memilih foto serta video yang ingin dibagikan dengan aplikasi Anda. Baca ringkasan pengalaman pemilihan pengguna.
Polling sesi: Aplikasi Anda harus melakukan polling secara berkala untuk memeriksa statusnya. Anda mencari properti
mediaItemsSet
untuk menampilkan benar, yang menunjukkan bahwa pengguna telah menyelesaikan pilihannya.Mencantumkan item media yang dipilih: Setelah
mediaItemsSet
menampilkan benar, Anda dapat menggunakan metode daftar untuk mendapatkan detail tentang item media yang dipilih.Mengambil dan menggunakan item media: Sekarang Anda memiliki akses ke item media yang dipilih. Anda dapat mengambil kontennya menggunakan
baseUrl
dan menggunakannya dalam aplikasi Anda.
Langkah berikutnya
- Tinjau dokumen referensi: Jelajahi dokumentasi referensi Picker API yang mendetail untuk mempelajari semua metode dan parameter yang tersedia.
- Coba contoh: Lihat contoh kami untuk melihat cara kerja Picker API dan mendapatkan inspirasi untuk integrasi Anda.