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();

dhflagging / php-google-people-api

维护者

详细信息