php google people api

PHP Google People API

توفر هذه الحزمة طريقة سهلة الاستخدام للتفاعل مع جهات اتصال Google عبر واجهة برمجة تطبيقات Google People.

تثبيت

يمكن تثبيت PHP Google People API بسهولة باستخدام الملحن. فقط قم بتشغيل الأمر التالي من جذر مشروعك.

 composer require rapidwebltd/php-google-people-api

إذا لم تكن قد استخدمت أبدًا مدير الاعتماد على الملحن من قبل ، فتوجه إلى موقع الملحن لمزيد من المعلومات حول كيفية البدء.

يثبت

لاستخدام هذه الحزمة ، تحتاج إلى المصادقة مع Google عبر Oauth 2. لحسن الحظ ، أصبح هذا الأمر سهلاً بواسطة حزمة معالج Google Oauth 2.

يمكنك تشغيل البرنامج النصي إعداد الإرشاد مع الأمر التالي.

 php vendor/rapidwebltd/php-google-oauth-2-handler/src/setup.php

سيؤدي ذلك إلى إرشادك خلال عملية إعداد مشروع ، وتسجيل الدخول إلى حساب Google الذي ترغب في إدارة جهات الاتصال الخاصة به. عندما سئل عن النطاقات التي تحتاجها ، أدخل ما يلي.

 https://www.googleapis.com/auth/userinfo.profile
https://www.googleapis.com/auth/contacts
https://www.googleapis.com/auth/contacts.readonly

عند اكتماله ، سيتعين عليك رمزك ، فأنت بحاجة إلى إنشاء كائن GoogleOAuth2Handler لحساب Google هذا.

يمكنك بعد ذلك إنشاء كائن GooglePeople ، على النحو التالي.

 $ people = new GooglePeople ( $ googleOAuth2Handler );

الاستخدام

استرداد جميع جهات الاتصال

 // Retrieval all contacts
foreach ( $ people -> all () as $ contact ) {
    echo $ contact -> resourceName . ' - ' ;
    if ( $ contact -> names ) {
        echo $ contact -> names [ 0 ]-> displayName ;
    }
    echo PHP_EOL ;
}

استرداد جهة اتصال واحدة

 // Retrieve single contact (by resource name)
$ contact = $ people -> get ( ' people/c8055020007701654287 ' );

إنشاء جهة اتصال جديدة

 // Create new contact
$ contact = new Contact ( $ people );
$ contact -> names [ 0 ] = new stdClass ;
$ contact -> names [ 0 ]-> givenName = ' Testy ' ;
$ contact -> names [ 0 ]-> familyName = ' McTest Test ' ;
$ contact -> save ();

تحديث جهة اتصال

 // Update contact
$ contact -> names [ 0 ]-> familyName = ' McTest ' ;
$ contact -> save ();

حذف جهة اتصال

 // Delete contact
$ contact -> delete ();