php google contacts v3 api ดาวน์โหลด - php google contacts v3 api Source Source Download

php google contacts v3 api

หมวดหมู่อื่นๆ

v2.0.0

ดาวน์โหลด

PHP Google ติดต่อ V3 API

ไลบรารี PHP สำหรับ Google ติดต่อ API (V3)

หมายเหตุ: หากคุณกำลังเริ่มโครงการใหม่เราขอแนะนำอย่างยิ่งให้ใช้แพ็คเกจ PHP Google People API แทน มันมีความสามารถมากกว่าแพ็คเกจนี้และใช้ API ใหม่ซึ่งอาจได้รับการสนับสนุนนานขึ้น

การติดตั้งและการพึ่งพา

แพ็คเกจนี้และการพึ่งพาของมันสามารถติดตั้งได้โดยใช้ composer

เพียงแค่เรียกใช้ composer require rapidwebltd/php-google-contacts-v3-api

การตั้งค่า

ติดตั้งการพึ่งพาที่ต้องการ ดูส่วน 'การพึ่งพา' ด้านบน
คัดลอกหรือเปลี่ยนชื่อ .config_blank.json ถึง . .config.json หมายเหตุ dot ( . ) ที่จุดเริ่มต้นของชื่อไฟล์
เติม 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
ไปที่ URL การอนุญาตที่จัดทำโดยขั้นตอนก่อนหน้า
ยอมรับสิทธิ์ที่ร้องขอในหน้าเว็บที่แสดง จากนั้นคุณควรถูกเปลี่ยนเส้นทางกลับไปยังไฟล์ redirect-handler.php
หน้าสร้างโดยไฟล์ redirect-handler.php ควรนำเสนอโทเค็นรีเฟรชให้คุณ คัดลอกสิ่งนี้ลงใน .config.json ของคุณ
การตั้งค่าเสร็จสิ้นแล้ว!

การใช้งาน

หลังจากติดตั้งไลบรารีแล้วและขั้นตอนการตั้งค่าและการเชื่อมโยงบัญชีเสร็จสิ้นแล้วคุณสามารถใช้ประโยชน์จากไลบรารีได้

หากเฟรมเวิร์กของคุณไม่ได้ทำเพื่อคุณอย่าลืมใส่ไฟล์ vendor/autoload.php ในหน้าใด ๆ ที่คุณต้องการใช้ประโยชน์จากไลบรารีนี้

ดึงรายชื่อผู้ติดต่อของ Google

รหัสต่อไปนี้จะดึงผู้ติดต่อทั้งหมดจากบัญชี 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 ที่มีอยู่

การอัปเดตผู้ติดต่อของ 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 ใหม่

การสร้างผู้ติดต่อ 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 );

กำหนดค่าไฟล์แทนที่

แต่ละวิธีมีอาร์กิวเมนต์เสริมสำหรับการแทนที่ไฟล์ config มันมีประโยชน์เมื่อคุณต้องการใช้งานกับบัญชี 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 );