Untuk mulai menggunakan Google Foto API, konfigurasi project Anda dengan mengaktifkan Photos API yang diperlukan menggunakan 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 tersebut akan mengizinkan permintaan API ini menggunakan protokol OAuth 2.0.
Client ID OAuth 2.0 memungkinkan pengguna aplikasi Anda untuk login, mengautentikasi, dan menggunakan Photos API. Photos API tidak mendukung akun layanan. Untuk menggunakan API ini, pengguna harus login ke Akun Google yang valid.
Mengonfigurasi aplikasi Anda
Aktifkan API terlebih dahulu, lalu minta client ID OAuth 2.0.
Mengaktifkan API
Sebelum dapat menggunakan Photos API, Anda harus mengaktifkannya di project Anda.
- Buka Konsol Google API.
- Dari panel menu, pilih project atau buat project baru.
- Untuk membuka salah satu Google Photos API, dari menu Navigation, pilih APIs & Services > Library.
- Telusuri "Foto". Pilih satu atau beberapa Photos API, lalu klik Enable.
Meminta client ID OAuth 2.0
Ikuti langkah-langkah berikut untuk meminta client ID OAuth dan mengonfigurasinya untuk aplikasi Anda. Contoh ini menggunakan aplikasi tempat seluruh alur OAuth ditangani sisi server, seperti yang ada dalam contoh kami. Proses penyiapan dapat bervariasi untuk skenario penerapan lainnya.
- Buka Konsol API Google, lalu pilih project Anda.
- Dari menu, pilih APIs & Services > Credentials.
Di halaman Credentials, klik Create Credentials > OAuth client ID.
Pilih Application type Anda. 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 asal untuk aplikasi Anda. Kolom ini tidak mengizinkan karakter pengganti.
Anda dapat memasukkan beberapa origin untuk mengizinkan aplikasi Anda berjalan di protokol, domain, atau subdomain yang berbeda. URL yang Anda masukkan akan 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 ``` 1. The **Authorized redirect URI** field is the endpoint that receives responses from the OAuth 2.0 server. Typically, this includes your development environment and points to a path in your application. ```none http://localhost:8080/auth/google/callback https://myproductionurl.example.com/auth/google/callback ``` 1. Click **Create**.
-
Dari dialog klien OAuth yang dihasilkan, salin hal berikut:
- ID Klien
- Rahasia klien
Aplikasi Anda dapat mengakses Google API yang diaktifkan menggunakan nilai ini.
Sebelum dapat meluncurkan aplikasi publik yang mengakses Photos API, aplikasi Anda harus ditinjau oleh Google. Pesan "Aplikasi belum diverifikasi" akan muncul di layar saat Anda menguji aplikasi, hingga aplikasi diverifikasi.
Setelah mengonfigurasi aplikasi, Anda siap untuk memulai:
Mengubah client ID
Resource yang dibuat melalui Google Photos API hanya dapat diakses atau diubah menggunakan client ID asli yang digunakan untuk membuatnya. Misalnya, jika Anda membuat 'sesi' di Picker API dengan client ID tertentu, lalu mengubah client ID tersebut di aplikasi, aplikasi Anda akan kehilangan akses ke resource API apa pun yang dibuat dengan client ID sebelumnya.
Rencanakan dengan cermat dan pilih jenis client ID yang tepat untuk Photos API yang Anda gunakan. Ubah client ID Anda hanya jika benar-benar diperlukan untuk menghindari masalah akses.