Mulai menggunakan library klien PHP

Untuk mulai menggunakan Google Photos API dengan library klien PHP, Anda harus siapkan library klien di lingkungan pengembangan Anda. Sebelum melakukannya, konfigurasi project Anda dengan mengaktifkan API 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 Photos API. Photos 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 Photos API, Anda harus mengaktifkannya untuk project Anda.

  1. Buka Konsol Google API.
  2. Dari menu bar, pilih project atau buat project baru.
  3. Untuk membuka Library Google API, dari menu Navigation, pilih APIs & Services > Library.
  4. Telusuri "Google Photos 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. 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 dan pilih project Anda.
  2. Dari menu, pilih APIs & Services > Credentials.
  3. Di halaman Credentials, klik Create Credentials > Client ID OAuth yang baru.
  4. Pilih Jenis aplikasi 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 mengizinkan aplikasi berjalan di protokol, domain, atau subdomain yang berbeda. 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, ini mencakup lingkungan pengembangan dan mengarah ke jalur di 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, download file JSON yang berisi konfigurasi klien. Detail klien Anda terdiri dari hal berikut:

    • Client ID
    • Rahasia klien

    File JSON ini akan digunakan nanti untuk menyiapkan library Google Auth untuk PHP yang berfungsi dengan library klien ini.

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

Menyiapkan library klien

Library klien PHP menangani semua panggilan API backend untuk Anda, dan mengekspos objek yang mudah digunakan, termasuk contoh kode untuk beberapa tugas API umum. Pertama-tama, download dan instal library klien Google Photos API untuk PHP beserta dependensi dari GitHub. Kemudian, siapkan kredensial OAuth2 Anda untuk PHP.

Opsi download

Menggunakan composer untuk menyertakan library sebagai dependensi di lingkungan pengembangan Anda. Jalankan perintah berikut untuk menambahkan library ke konfigurasi project Anda dan download ke direktori vendor/.

composer require google/photos-library

Sebagai alternatif, Anda juga bisa meng-clone repositori atau download file terkompresi tarball.

Menyiapkan kredensial OAuth2 untuk PHP

Library klien ini berfungsi dengan Library Google Auth untuk PHP. Untuk informasi selengkapnya, lihat Menggunakan OAuth 2.0 dengan Library Klien Google API untuk PHP.

Gunakan kredensial autentikasi yang ditampilkan oleh library autentikasi saat menyiapkan PhotosLibraryClient.

Mencoba beberapa contoh

Coba kode di bawah ini untuk melakukan panggilan API pertama Anda menggunakan library klien PHP.

use Google\Auth\Credentials\UserRefreshCredentials;
use Google\Photos\Library\V1\PhotosLibraryClient;
use Google\Photos\Library\V1\PhotosLibraryResourceFactory;

try {
    // Use the OAuth flow provided by the Google API Client Auth library
    // to authenticate users. See the file /src/common/common.php in the samples for a complete
    // authentication example.
    $authCredentials = new UserRefreshCredentials( /* Add your scope, client secret and refresh token here */ );

    // Set up the Photos Library Client that interacts with the API
    $photosLibraryClient = new PhotosLibraryClient(['credentials' => $authCredentials]);

    // Create a new Album object with at title
    $newAlbum = PhotosLibraryResourceFactory::album("My Album");

    // Make the call to the Library API to create the new album
    $createdAlbum = $photosLibraryClient->createAlbum($newAlbum);

    // The creation call returns the ID of the new album
    $albumId = $createdAlbum->getId();
} catch (\Google\ApiCore\ApiException $exception) {
    // Error during album creation
} catch (\Google\ApiCore\ValidationException $e) {
    // Error during client creation
    echo $exception;
}

Ada lebih banyak contoh di GitHub yang dapat Anda coba.