Mulai menggunakan Picker API

Picker API menyediakan cara yang aman bagi pengguna Anda untuk memilih foto dan video dari koleksi Google Foto mereka dan membagikannya ke aplikasi Anda.

Sebelum memulai

Alur Picker API

Berikut ringkasan cara kerja Picker API:

  1. Periksa token OAuth: Sebelum memulai alur Picker API, periksa apakah ada token akses OAuth 2.0 yang valid untuk pengguna. Jika tidak ada token, mulai alur otorisasi OAuth 2.0 untuk mendapatkannya.

  2. Buat sesi: Mulai proses dengan melakukan panggilan ke Picker API untuk membuat sesi baru. Panggilan ini akan menampilkan pickerUri unik.

  3. Mengarahkan 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. Untuk aplikasi berbasis web, Anda dapat menambahkan /autoclose ke URI ini untuk menutup jendela Google Foto secara otomatis setelah pengguna menyelesaikan pilihannya.

  4. Pengguna memilih item media: Dalam aplikasi Google Foto, pengguna dapat menjelajahi koleksi mereka dan memilih foto dan video yang ingin dibagikan ke aplikasi Anda. Baca ringkasan pengalaman pemilihan pengguna.

  5. Polling sesi: Aplikasi Anda harus melakukan polling sesi secara berkala untuk memeriksa status. Anda mencari properti mediaItemsSet yang menampilkan nilai benar (true), yang menunjukkan bahwa pengguna telah menyelesaikan pilihannya.

  6. Mencantumkan item media yang dipilih: Setelah mediaItemsSet menampilkan nilai benar, Anda dapat menggunakan metode daftar untuk mendapatkan detail tentang item media yang dipilih.

  7. Mengambil dan menggunakan item media: Sekarang Anda memiliki akses ke item media yang dipilih. Anda dapat mengambil kontennya menggunakan baseUrl dan memanfaatkannya dalam aplikasi Anda.

Langkah berikutnya

  • Tinjau dokumen referensi: Pelajari dokumentasi referensi Picker APIyang 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.