Mulai menggunakan REST

Untuk mulai menggunakan Google Photos Library API, konfigurasi project Anda dengan mengaktifkan API tersebut melalui Konsol API Google dan menyiapkan ID klien OAuth 2.0.

Aplikasi Anda berinteraksi dengan Google Foto atas nama pengguna Google Foto. Misalnya, saat Anda membuat album di Galeri Google Foto atau upload item media ke galeri foto pengguna akun Google Foto, pengguna mengizinkan permintaan API ini melalui OAuth 2.0.

Client ID OAuth 2.0 memungkinkan pengguna aplikasi Anda untuk login, mengautentikasi, sehingga menggunakan Library API. Library API tidak mendukung akun layanan; untuk menggunakan API ini, pengguna harus login ke menggunakan Akun Layanan Anda.

Mengonfigurasi aplikasi Anda

Mengaktifkan API

Sebelum dapat menggunakan Library API, Anda harus mengaktifkannya untuk project Anda.

  1. Buka Konsol Google API.
  2. Dari panel menu, pilih project atau buat project baru.
  3. Untuk membuka Google API Library, dari Navigation menu, pilih API & Layanan > Library.
  4. Telusuri "Google Photos Library API". Pilih hasil yang benar, lalu klik Aktifkan.

Meminta client ID OAuth 2.0

Ikuti langkah-langkah di bawah ini untuk meminta client ID OAuth dan mengonfigurasinya untuk aplikasi. Contoh ini menggunakan aplikasi yang seluruh alur OAuth yang ditangani sisi server, seperti yang ada dalam contoh kami. Proses penyiapan dapat bervariasi untuk skenario penerapan lainnya.

  1. Buka Konsol API Google lalu pilih project Anda.
  2. Dari menu, pilih API & Layanan > Kredensial.
  3. Di halaman Credentials, klik Create Credentials > Client ID OAuth yang baru.
  4. Pilih Application type Anda. Dalam contoh ini, jenis aplikasinya adalah Aplikasi web.
  5. Mendaftarkan origin tempat aplikasi Anda diizinkan untuk mengakses Google API sebagai berikut:

    1. Untuk mengidentifikasi client ID, masukkan nama.
    2. Di kolom Asal JavaScript yang sah, masukkan origin untuk . Kolom ini tidak mengizinkan karakter pengganti.

      Anda dapat memasukkan beberapa origin untuk memungkinkan 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
      
    3. Kolom Authorized redirect URI adalah endpoint yang menerima respons dari server OAuth 2.0. Biasanya, hal ini mencakup pengembangan aplikasi dan menunjuk ke jalur dalam aplikasi Anda.

      http://localhost:8080/auth/google/callback
      https://myproductionurl.example.com/auth/google/callback
      
    4. Klik Buat.

  1. Dari dialog klien OAuth yang dihasilkan, salin hal berikut:

    • Client ID
    • Rahasia klien

    Aplikasi Anda dapat mengakses Google API yang diaktifkan menggunakan nilai ini.

Sebelum Anda dapat meluncurkan aplikasi publik yang mengakses Library API, aplikasi Anda harus ditinjau oleh Google. "Aplikasi belum terverifikasi" muncul pada saat Anda menguji aplikasi, hingga terverifikasi.

Mencoba sampel

Setelah mengonfigurasi project untuk digunakan dengan Library API, lihat aplikasi contoh di GitHub. Aplikasi contoh menunjukkan cara membuat bingkai foto cerdas menggunakan Library API.