Untuk mulai menggunakan Google Photos Library API dengan library klien Java, Anda harus menyiapkan library klien di lingkungan pengembangan Anda. Sebelum melakukannya, konfigurasi project Anda dengan mengaktifkan API melalui Konsol API Google dan menyiapkan client ID OAuth 2.0.
Aplikasi Anda berinteraksi dengan Google Foto atas nama pengguna Google Foto. Misalnya, saat Anda membuat album di galeri Google Foto pengguna atau mengupload item media ke akun Google Foto pengguna, pengguna akan mengizinkan permintaan API tersebut melalui protokol OAuth 2.0.
Client ID OAuth 2.0 memungkinkan pengguna aplikasi Anda login, mengautentikasi, dan menggunakan Library API. Library API tidak mendukung akun layanan. Untuk menggunakan API ini, pengguna harus login ke Akun Google yang valid.
Mengonfigurasi aplikasi Anda
Mengaktifkan API
Sebelum dapat menggunakan Library API, Anda harus mengaktifkannya untuk project.
- Buka Konsol Google API.
- Dari panel menu, pilih project atau buat project baru.
- Untuk membuka Google API Library, dari Menu navigasi, pilih APIs & Services > Library.
- Telusuri "Google Photos Library API". Pilih hasil yang benar, lalu klik Enable.
Meminta client ID OAuth 2.0
Ikuti langkah-langkah di bawah ini untuk meminta client ID OAuth dan mengonfigurasinya untuk aplikasi Anda. Contoh ini menggunakan aplikasi yang seluruh alur OAuth ditangani di sisi server, seperti yang ada dalam contoh kami. Proses penyiapan dapat bervariasi untuk skenario penerapan lainnya.
- Buka Konsol API Google dan pilih project Anda.
- Dari menu, pilih APIs & Services > Credentials.
- Pada halaman Credentials, klik Create Credentials > OAuth client ID.
- Pilih Jenis aplikasi. Dalam contoh ini, jenis aplikasinya adalah Aplikasi web.
Daftarkan origin tempat aplikasi Anda diizinkan untuk mengakses Google API sebagai berikut:
- Untuk mengidentifikasi client ID, masukkan nama.
Di kolom Asal JavaScript yang sah, masukkan origin untuk aplikasi Anda. Kolom ini tidak mengizinkan karakter pengganti.
Anda dapat memasukkan beberapa origin untuk mengizinkan aplikasi berjalan di berbagai protokol, domain, atau subdomain. URL yang Anda masukkan diizinkan untuk memulai permintaan OAuth.
Contoh berikut menunjukkan URL pengembangan lokal (contoh kami menggunakan
localhost:8080
) dan URL produksi.http://localhost:8080 https://myproductionurl.example.com
Kolom Authorized redirect URI adalah endpoint yang menerima respons dari server OAuth 2.0. Biasanya, lingkungan ini mencakup lingkungan pengembangan Anda dan mengarah ke jalur dalam aplikasi Anda.
http://localhost:8080/auth/google/callback https://myproductionurl.example.com/auth/google/callback
Klik Create.
-
Dari dialog klien OAuth yang dihasilkan, download file JSON yang berisi konfigurasi klien Anda. Detail klien Anda terdiri dari berikut ini:
- Client ID
- Rahasia klien
File JSON ini akan digunakan nanti untuk menyiapkan library Google Auth untuk Java yang berfungsi dengan library klien ini.
Sebelum Anda dapat meluncurkan aplikasi publik yang mengakses Library API, aplikasi Anda harus ditinjau oleh Google. Pesan "Aplikasi belum diverifikasi" akan muncul di layar saat Anda menguji aplikasi, hingga aplikasi diverifikasi.
Menyiapkan library klien
Library klien Java menangani semua panggilan API backend untuk Anda, dan mengekspos objek ramah untuk digunakan, termasuk contoh kode untuk beberapa tugas API umum. Pertama, download dan instal library klien Google Photos Library API untuk Java beserta dependensi dari GitHub. Kemudian, siapkan kredensial OAuth2 Anda untuk Java.
Opsi download
Berikut adalah beberapa opsi untuk mendownload library klien:
Dependensi Gradle:
Untuk menggunakan library ini dengan Gradle, tambahkan dependensi berikut ke file
build.gradle
Anda.repositories { mavenCentral() } dependencies { compile 'com.google.photos.library:google-photos-library-client:1.7.3' }
Dependensi Maven:
Untuk menggunakan library ini dengan Maven, tambahkan perintah berikut ke file
pom.xml
Maven.<dependency> <groupId>com.google.photos.library</groupId> <artifactId>google-photos-library-client</artifactId> <version>1.7.3</version> </dependency>
Mendownload rilis:
Halaman rilis berisi artefak yang berbeda untuk setiap rilis library, termasuk file jar.
Meng-clone repositori:
Gunakan metode ini jika Anda ingin mengubah atau berkontribusi pada library ini, misalnya, mengirimkan permintaan pull, atau jika Anda ingin mencoba contoh kami. Saat Anda meng-clone repositori, semua file dalam repositori ini akan didownload.
- Jalankan
git clone https://github.com/google/java-photoslibrary.git
di command prompt. - Anda akan mendapatkan direktori
java-photoslibrary
. Pilih dengan menjalankancd java-photoslibrary
. - Buka file
build.gradle
di IDE Anda atau jalankan./gradlew assemble
di command prompt untuk mem-build project. Lihat./gradlew tasks
untuk melihat tugas yang tersedia.
- Jalankan
Menyiapkan kredensial OAuth2 untuk Java
Library klien ini dapat digunakan dengan Library Google Auth untuk Java. Untuk informasi selengkapnya, lihat Menggunakan OAuth 2.0 dengan Library Klien Google API untuk Java.
Tentukan konfigurasi OAuth klien Anda di CredentialsProvider
saat
membuat PhotoLibrarySettings
untuk objek PhotosLibraryClient
.
Coba beberapa contoh
Coba kode di bawah ini untuk melakukan panggilan API pertama Anda menggunakan library klien Java.
// Set up the Photos Library Client that interacts with the API
PhotosLibrarySettings settings =
PhotosLibrarySettings.newBuilder()
.setCredentialsProvider(
FixedCredentialsProvider.create(/* Add credentials here. */))
.build();
try (PhotosLibraryClient photosLibraryClient =
PhotosLibraryClient.initialize(settings)) {
// Create a new Album with at title
Album createdAlbum = photosLibraryClient.createAlbum("My Album");
// Get some properties from the album, such as its ID and product URL
String id = album.getId();
String url = album.getProductUrl();
} catch (ApiException e) {
// Error during album creation
}
Ada lebih banyak contoh di GitHub yang dapat Anda coba.