php google contacts v3 api

PHP Google Kontak V3 API

Perpustakaan PHP untuk API Kontak Google (V3)

CATATAN: Jika Anda memulai proyek baru, kami sangat menyarankan untuk menggunakan paket API PHP Google People kami sebagai gantinya. Ini lebih mampu daripada paket ini dan menggunakan API yang lebih baru yang mungkin akan didukung lebih lama.

Instalasi & Ketergantungan

Paket ini dan ketergantungannya dapat diinstal menggunakan composer .

Cukup jalankan composer require rapidwebltd/php-google-contacts-v3-api .

Pengaturan

1. Instal dependensi yang diperlukan. Lihat bagian 'Ketergantungan' di atas.
2. Salin atau ganti nama .config_blank.json ke .config.json . Perhatikan dot ( . ) Di awal nama file.
3. Isi clientID , clientSecret dan redirectUri di .config.json .

• Perhatikan bahwa redirectUri harus dikonfigurasi untuk menunjuk ke file redirect-handler.php .
• clientID dan clientSecret dapat ditemukan di konsol pengembang Google di https://console.developers.google.com/ di bawah 'APIS & auth' -> 'kredensial', setelah mengaktifkan Kontak API.

4. Buka authorise-application.php di browser web. Ini akan memberi Anda URL untuk mengesahkan aplikasi Anda untuk kontak Google.
5. Pergi ke URL otorisasi yang disediakan oleh langkah sebelumnya.
6. Terima izin yang diminta pada halaman yang ditampilkan. Anda kemudian harus dialihkan kembali ke file redirect-handler.php .
7. Halaman yang dihasilkan oleh file redirect-handler.php kemudian harus memberi Anda token refresh. Salin ini ke .config.json Anda.
8. Pengaturan selesai!

Penggunaan

Setelah perpustakaan diinstal dan langkah -langkah penyiapan dan asosiasi akun telah selesai, Anda dapat memanfaatkan perpustakaan.

Jika kerangka kerja Anda tidak melakukan ini untuk Anda, ingatlah untuk memasukkan file yang membutuhkan vendor/autoload.php pada halaman apa pun yang ingin Anda gunakan perpustakaan ini.

Mengambil kontak Google

Kode berikut akan mengambil semua kontak dari akun Google terkait.

 $ contacts = rapidweb  googlecontacts  factories ContactFactory:: getAll ();

var_dump ( $ contacts );

Metode ContactFactory::getAll() akan mengembalikan array objek Contact . Detail kontak akan tersedia sebagai variabel anggota publik dari objek -objek ini.

selfURL yang terkandung dalam setiap objek Contact adalah referensi unik untuk kontak khusus ini. Jika Anda perlu mengambil kontak tertentu di masa depan, Anda perlu menyimpan selfURL ini.

Untuk mengambil kontak tertentu (dengan selfurl -nya), gunakan kode berikut.

 $ selfURL = " ... " ;

$ contact = rapidweb  googlecontacts  factories ContactFactory:: getBySelfURL ( $ selfURL );

var_dump ( $ contact );

Metode ContactFactory::getBySelfURL ini akan mengembalikan objek Contact tunggal.

Properti kontak Google diakses sebagai berikut.

 $ selfURL = " ... " ;

$ contact = rapidweb  googlecontacts  factories ContactFactory:: getBySelfURL ( $ selfURL );

echo $ contact -> name ;
echo $ contact -> phoneNumber ;
echo $ contact -> email ;
echo $ contact -> content ;

Memperbarui kontak google yang ada

Pembaruan kontak Google menggunakan perpustakaan ini dilakukan dengan cara yang sangat berorientasi objek.

Anda harus terlebih dahulu mengambil objek Contact menggunakan salah satu metode yang disebutkan sebelumnya. Anda kemudian dapat memodifikasi variabel anggota publik objek kontak. Untuk menyimpan perubahan ini kembali ke layanan Google Contacts, Anda kemudian meneruskan objek yang dimodifikasi ke metode ContactFactory::submitUpdates($contact) .

Kode berikut menunjukkan secara penuh pengambilan kontak, memodifikasinya dan mengirimkan pembaruan.

 $ selfURL = " ... " ;

$ contact = rapidweb  googlecontacts  factories ContactFactory:: getBySelfURL ( $ selfURL );

var_dump ( $ contact );

$ contact -> name = ' Test ' ;
$ contact -> phoneNumber = ' 07812363789 ' ;
$ contact -> email = ' [email protected] ' ;
$ contact -> content = ' Note for example ' ;

$ contactAfterUpdate = rapidweb  googlecontacts  factories ContactFactory:: submitUpdates ( $ contact );

var_dump ( $ contactAfterUpdate );

Membuat Kontak Google Baru

Membuat kontak Google baru sangat mudah. Cukup hubungi metode ContactFactory::create($name, $phoneNumber, $emailAddress) , melewati parameter yang sesuai. Metode ini akan mengembalikan kontak yang dibuat sebagai objek Contact termasuk selfURL yang baru ditugaskan.

 $ name = " Frodo Baggins " ;
$ phoneNumber = " 06439111222 " ;
$ emailAddress = " [email protected] " ;
$ note = " Note for example " ;

$ newContact = rapidweb  googlecontacts  factories ContactFactory:: create ( $ name , $ phoneNumber , $ emailAddress , $ note );

Override file konfigurasi

Setiap metode memiliki argumen opsional untuk override file konfigurasi. Ini berguna ketika Anda ingin menggunakan pekerjaan dengan beberapa akun Google secara bersamaan.

 $ customConfig = ( object ) array (
    ' clientID ' => ' <clientId which you get according to setup above> ' ,
    ' clientSecret ' => ' <clientSecret which you get according to setup above> ' ,
    ' redirectUri ' => ' <your redirect uri> ' ,
    ' developerKey ' => ' <developer key> ' ,
    ' refreshToken ' => ' <refresh token specific for google account> '
);

$ contacts = ContactFactory:: getAll ( $ customConfig );

Anda harus mendefinisikan semua variabel karena konfigurasi asli sepenuhnya diabaikan. Lebih tepatnya, itu tidak harus ada sama sekali.

Contoh

Lihatlah file -file berikut untuk contoh -contoh dasar tentang cara mengambil kontak. Mereka juga dapat digunakan untuk memastikan Anda saat ini telah mengaitkan akun Google Anda dengan perpustakaan.

• test.php
• test_individual.php