Mulai menggunakan Library API

Library API memungkinkan Anda berinteraksi dengan foto, video, dan album dalam library Google Foto pengguna, tetapi dengan fokus penting: Anda hanya dapat mengakses dan mengelola konten yang dibuat oleh aplikasi Anda.

Sebelum memulai

• Lihat ringkasannya: Bandingkan Picker API dan Library API untuk memastikan Library API sesuai untuk kasus penggunaan Anda.
• Mengonfigurasi Aplikasi: Aktifkan API dan siapkan autentikasi. Lihat Mengonfigurasi aplikasi untuk mengetahui langkah-langkah mendetail.

Kasus penggunaan utama Library API

Library API cocok untuk skenario saat aplikasi Anda harus:

• Mengupload dan menyimpan media: Mengimpor foto dan video (yang dibuat oleh aplikasi Anda) ke galeri Google Foto pengguna dengan aman.
• Mengelola konten: Buat dan kelola album untuk membantu pengguna mengelola media terkait aplikasi mereka.
• Meningkatkan kualitas foto dan album: Menambahkan konteks ke item media dan album melalui pengayaan seperti judul, deskripsi, atau informasi lokasi.
• Mengakses data yang dibuat aplikasi: Mengambil dan berinteraksi dengan foto, video, dan album yang sebelumnya dibuat oleh aplikasi Anda.

Alur kerja Library API standar

Meskipun Library API menawarkan berbagai fungsi, alur kerja umum mungkin melibatkan langkah-langkah berikut:

1. Upload media: Gunakan endpoint upload untuk mengupload byte foto atau video ke Google Foto dengan aman. Langkah ini akan menghasilkan uploadToken.

2. Membuat item media: Gunakan metode mediaItems.batchCreate, yang menyediakan uploadToken, untuk membuat item media di galeri foto pengguna.

3. Membuat album (opsional): Gunakan metode albums.create untuk membuat album dalam galeri foto pengguna guna mengatur item media.

4. Mengelola album:

   • Tambahkan item media (yang dibuat oleh aplikasi Anda) ke album menggunakan albums.batchAddMediaItems.
   • Hapus item media dari album menggunakan albums.batchRemoveMediaItems.
   • Tambahkan pengayaan ke album (seperti judul atau lokasi) menggunakan albums.addEnrichment.
   • Mengambil informasi tentang album tertentu menggunakan albums.get.
   • Buat daftar album yang dibuat oleh aplikasi Anda menggunakan albums.list.

5. Mengakses media yang dibuat aplikasi:

   • Mengambil detail tentang item media tertentu menggunakan mediaItems.get atau mediaItems.batchGet.
   • Telusuri item media yang dibuat oleh aplikasi Anda menggunakan mediaItems.search.
   • Cantumkan item media dalam album tertentu yang dibuat aplikasi menggunakan mediaItems.search dengan ID album.

Langkah berikutnya

• Tinjau dokumen referensi: Pelajari dokumentasi referensi Library API yang mendetail untuk mempelajari semua metode dan parameter yang tersedia.
• Coba contoh: Lihat contoh kami untuk melihat cara kerja Library API dan mendapatkan inspirasi untuk integrasi Anda.