README

此包提供了一种通过Google People API与Google联系人进行友好交互的方式。

安装

使用Composer可以轻松安装PHP Google People API。只需从项目的根目录运行以下命令。

composer require rapidwebltd/php-google-people-api

如果您之前从未使用过Composer依赖项管理器，请访问Composer网站获取有关如何开始的信息。

配置

要使用此包，您需要通过OAuth 2与Google进行身份验证。幸运的是，PHP Google OAuth 2 Handler包使得这个过程变得简单。

您可以使用以下命令运行其引导设置脚本。

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

完成后，您将需要编写代码来为该Google账户创建一个GoogleOAuth2Handler对象。

然后您可以创建一个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();