php google contacts v3 api下載php google contacts v3 api源代碼下載

php google contacts v3 api

其他類別

v2.0.0

下載

PHP Google聯繫V3 API

Google Contacts API（V3）的PHP庫

注意：如果您啟動了一個新項目，我們強烈建議您改用我們的PHP Google People API軟件包。它比此軟件包更有能力，並且使用了更新的API，該API可能會更長的時間。

安裝和依賴項

可以使用composer安裝此軟件包及其依賴關係。

只需運行composer require rapidwebltd/php-google-contacts-v3-api 。

設定

安裝所需的依賴項。請參閱上面的“依賴關係”部分。
複製或重命名.config_blank.json到.config.json 。注意文件名開頭的點（ . ）。
在.config.json中填寫clientID ， clientSecret和redirectUri 。

請注意， redirectUri應配置為指向redirect-handler.php文件。
可以在https://console.developers.google.com/下在'apis＆auth'' - >'憑據''啟用Contacts API之後，在Google Developers Console中找到clientID和clientSecret 。

轉到Web瀏覽器中的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對象的數組。聯繫人的詳細信息將作為這些對象的公共成員變量提供。

每個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 Contacts服務，然後您將修改後的對像傳遞給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 );

配置文件覆蓋

每個方法都有可選的配置文件覆蓋的參數。當您要同時使用多個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 );