addin/google-people

📇 Google Contacts Manager (PHP Package)

Package sederhana untuk manipulasi kontak Google menggunakan People API. Mendukung:

• 🔐 Login Google (OAuth2) sekali
• 📖 Baca (read) daftar kontak
• ➕ Tambah kontak
• 📝 Update kontak
• ❌ Hapus kontak
• 🔁 Refresh token otomatis (tanpa login ulang)

📦 Instalasi

Tambahkan ke proyek kamu via Composer:

composer require addin/google-contacts

🔧 Setup Awal

• Aktifkan Google People API
  • Buka Google Cloud Console
  • Buat atau pilih project
  • Aktifkan People API
  • Buat kredensial OAuth 2.0 Client ID (application type: Desktop app)
  • Unduh credentials.json
• Pertama Kali Login & Simpan Token Jalankan perintah berikut:

php -S localhost:8080 example/authorize-server.php

buka di browser http://localhost:8080

atau bisa juga membuat authorize script sendiri dengan mencontoh file /example/authorize-server

• Script ini akan:
• Menampilkan URL untuk login ke Google
• Meminta kode verifikasi
• Menyimpan token akses ke token.json

🚀 Contoh Pemakaian Inisialisasi

use Addin\GoogleContactsManager;

require 'vendor/autoload.php';

// Inisialisasi dengan file token
$contacts = new GoogleContactsManager('credentials.json','token.json');

📖 Baca Kontak

$list = $contacts->listContacts(10);
foreach ($list as $person) {
    echo $person->getNames()[0]->getDisplayName() . PHP_EOL;
}

➕ Tambah Kontak

$contacts->addContact('John Doe', '[e-mail]');

📝 Update Kontak

$contacts->updateContact($resourceName, 'Nama Baru', '[e-mail]');

❌ Hapus Kontak

$contacts->deleteContact($resourceName);

Menggunakan Inisialisasi pakai method getService()

$contact->getService()->whatever()->method()->google();

⚠️ Catatan

• Token akan otomatis direfresh jika access token expired
• Jangan upload credentials.json dan tokens/*.json ke GitHub (gunakan .gitignore)
• Jika token dicabut oleh user atau Google, harus login ulang (php auth-google.php)