php google contacts v3 api
v2.0.0
مكتبة PHP لاتصالات جوجل الاتصالات (V3)
ملاحظة: إذا كنت تبدأ مشروعًا جديدًا ، فإننا نوصي بشدة باستخدام حزمة PHP Google People API بدلاً من ذلك. إنها أكثر قدرة من هذه الحزمة وتستخدم واجهة برمجة تطبيقات أحدث ربما سيتم دعمها لفترة أطول.
يمكن تثبيت هذه الحزمة وتبعياتها باستخدام composer .
فقط تشغيل composer require rapidwebltd/php-google-contacts-v3-api .
.config_blank.json إلى .config.json . لاحظ النقطة ( . ) في بداية اسم الملف.clientID ، clientSecret و redirectUri في .config.json .redirectUri للإشارة إلى ملف redirect-handler.php .clientID و clientSecret في وحدة التحكم في Google Developers على https://console.developers.google.com/ ضمن "APIS & Auth" -> "بيانات الاعتماد" ، بعد تمكين API.authorise-application.php في متصفح الويب. يجب أن يمنحك هذا عنوان URL لتخويل طلبك لجهات اتصال Google.redirect-handler.php .redirect-handler.php رمزًا تحديثًا. انسخ هذا في .config.json .بعد تثبيت المكتبة وتم الانتهاء من خطوات جمعية الإعداد والحساب ، يمكنك الاستفادة من المكتبة.
إذا لم يفعل إطار العمل الخاص بك هذا من أجلك ، تذكر أن تتضمن طلب ملف vendor/autoload.php على أي صفحات ترغب في الاستفادة من هذه المكتبة.
سيقوم الرمز التالي باسترداد جميع جهات الاتصال من حساب Google المرتبط.
$ contacts = rapidweb googlecontacts factories ContactFactory:: getAll ();
var_dump ( $ contacts ); ستعيد طريقة ContactFactory::getAll() مجموعة من كائنات Contact . ستكون تفاصيل جهة الاتصال متاحة كمتغيرات عامة للأعضاء لهذه الكائنات.
selfURL الموجود في كل كائن Contact هو الإشارة الفريدة إلى هذا الاتصال بالذات. إذا كنت بحاجة إلى استرداد جهة اتصال محددة في المستقبل ، فستحتاج إلى تخزين هذا selfURL .
لاسترداد جهة اتصال محددة (بواسطة Selfurl) ، استخدم الكود التالي.
$ selfURL = " ... " ;
$ contact = rapidweb googlecontacts factories ContactFactory:: getBySelfURL ( $ selfURL );
var_dump ( $ contact ); هذه ContactFactory::getBySelfURL سوف تقوم بإرجاع كائن Contact واحد.
يتم الوصول إلى خصائص الاتصال Google على النحو التالي.
$ selfURL = " ... " ;
$ contact = rapidweb googlecontacts factories ContactFactory:: getBySelfURL ( $ selfURL );
echo $ contact -> name ;
echo $ contact -> phoneNumber ;
echo $ contact -> email ;
echo $ contact -> content ;يتم تحديث جهات اتصال Google باستخدام هذه المكتبة بطريقة موجهة إلى الكائن للغاية.
يجب أولاً استرداد كائن Contact باستخدام إحدى الطرق المذكورة سابقًا. يمكنك بعد ذلك تعديل متغيرات الأعضاء العام لكائن الاتصال. لحفظ هذه التغييرات مرة أخرى إلى خدمة اتصالات Google ، تقوم بعد ذلك بتمرير الكائن المعدل إلى طريقة ContactFactory::submitUpdates($contact) .
يوضح الرمز التالي بالكامل استرداد جهة اتصال ، وتعديله وتقديم التحديثات.
$ 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 ); من السهل جدًا إنشاء جهة اتصال Google جديدة. ما عليك سوى الاتصال على ContactFactory::create($name, $phoneNumber, $emailAddress) ، تمرير عبر المعلمات المناسبة. ستعيد هذه الطريقة جهة الاتصال التي تم إنشاؤها ككائن Contact بما في ذلك selfURL المعين حديثًا.
$ name = " Frodo Baggins " ;
$ phoneNumber = " 06439111222 " ;
$ emailAddress = " [email protected] " ;
$ note = " Note for example " ;
$ newContact = rapidweb googlecontacts factories ContactFactory:: create ( $ name , $ phoneNumber , $ emailAddress , $ note );كل طريقة لها وسيطة اختيارية لتجاوز ملف التكوين. إنه مفيد عندما تريد استخدام العمل مع حسابات Google متعددة في نفس الوقت.
$ 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 );يجب عليك تحديد جميع المتغيرات حيث يتم تجاهل التكوين الأصلي تمامًا. لكي تكون أكثر دقة ، ليس من الضروري وجودها على الإطلاق.
ألقِ نظرة على الملفات التالية للحصول على أمثلة أساسية حول كيفية استرداد جهات الاتصال. يمكن استخدامها أيضًا لضمان ارتباط حساب Google الخاص بك حاليًا مع المكتبة.
