求助：使用Google People API创建的联系人未在Google Contacts保存同步

使用Google People API创建新联系人，接口返回成功响应，但联系人未出现在Google Contacts中，也无报错。创建联系人的代码如下：

$client = new GoogleClient(config('google'));
$googleClient = $client->getClient();
$peopleService = new PeopleService($googleClient);

$newContact = new \Google\Service\PeopleService\Person();
$newContact->setNames([new Google_Service_PeopleService_Name(['givenName' => 'John', 'familyName' => 'Doe'])]);
$newContact->setEmailAddresses([new Google_Service_PeopleService_EmailAddress(['value' => 'johndoe@example.com'])]);

$respose = $peopleService->people->createContact($newContact);
dd($respose); // 返回Person对象

尝试了同步连接的代码，仍未在Contacts中看到该联系人：

$client = new GoogleClient(config('google'));
$googleClient = $client->getClient();
$peopleService = new PeopleService($googleClient);

$params = [
    'personFields' => 'metadata,names,emailAddresses,phoneNumbers',
    'pageSize' => 2000,
    'requestSyncToken' => true
];

$fullSyncResponse = $peopleService->people_connections->listPeopleConnections('people/me', $params);
while ($fullSyncResponse->getNextPageToken() != null) {
    $fullSyncResponse = $peopleService->people_connections->listPeopleConnections('people/me', [
        'personFields' => 'metadata,names,emailAddresses,phoneNumbers',
        'pageSize' => 2000,
        'requestSyncToken' => true,
        'pageToken' => $fullSyncResponse->getNextPageToken()
    ]);
}

// 使用同步令牌获取增量变更
$incrementalSyncResponse = $peopleService->people_connections->listPeopleConnections('people/me', [
    'personFields' => 'metadata,names,emailAddresses,phoneNumbers',
    'pageSize' => 2000,
    'syncToken' => $fullSyncResponse->getNextSyncToken()
]);

if ($incrementalSyncResponse->getConnections() != null)
    foreach ($incrementalSyncResponse->getConnections() as $person) {
        $this->handlePerson($person);
    }

while ($incrementalSyncResponse->getNextPageToken() != null) {
    $incrementalSyncResponse = $peopleService->people_connections->listPeopleConnections('people/me', [
        'personFields' => 'metadata,names,emailAddresses,phoneNumbers',
        'pageToken' => $incrementalSyncResponse->getNextPageToken(),
        'pageSize' => 2000,
        'syncToken' => $fullSyncResponse->getNextSyncToken()
    ]);

    if ($incrementalSyncResponse->getConnections() != null)
        foreach ($incrementalSyncResponse->getConnections() as $person) {
            $this->handlePerson($person);
        }
}

dd($fullSyncResponse, $incrementalSyncResponse); // 返回listPeopleConnections响应

public function handlePerson(PeopleService\Person $person)
{
    if ($person->getMetadata()->getDeleted()) {
        // 处理删除的联系人
    } else {
        // 处理变更的联系人
    }
}

请问可能的原因是什么？如何让联系人保存并同步到Google Contacts？

可能的原因及解决办法 #

1. 权限范围不足 #

创建联系人需要可写权限，确保客户端配置的OAuth权限范围包含 https://www.googleapis.com/auth/contacts，readonly 权限无法创建联系人。检查GoogleClient的权限配置，确认包含可写权限。

2. 联系人被创建到"其他联系人"分组 #

Google People API默认将新联系人存入「其他联系人」而非主联系人列表，需手动指定分组：

// 创建时添加到主联系人组
$newContact->setMemberships([
    new \Google\Service\PeopleService\Membership([
        'contactGroupMembership' => [
            'contactGroupResourceName' => 'contactGroups/myContacts'
        ]
    ])
]);

3. 验证联系人是否真实创建成功 #

通过API查询返回的联系人资源，确认其存在：

$createdPerson = $peopleService->people->get($respose->getResourceName(), [
    'personFields' => 'names,emailAddresses,metadata'
]);
dd($createdPerson);

若能查询到，说明联系人已在服务器端，只是未显示在主列表；若查不到，说明创建存在隐性错误。

4. 类名命名空间混用问题 #

代码中混用了全局类名和命名空间类名，统一使用命名空间版本避免加载错误：

// 替换原有类实例化代码
$newContact->setNames([new \Google\Service\PeopleService\Name(['givenName' => 'John', 'familyName' => 'Doe'])]);
$newContact->setEmailAddresses([new \Google\Service\PeopleService\EmailAddress(['value' => 'johndoe@example.com'])]);

5. 同步延迟 #

Google Contacts网页端/移动端可能存在同步延迟，等待几分钟后刷新页面或重启设备同步功能再检查。

6. 客户端凭据验证问题 #

确认GoogleClient使用的OAuth凭据正确，且访问令牌有效。打印 $googleClient->getAccessToken() 检查令牌权限范围是否包含联系人可写权限，同时确认授权流程已完整完成。

内容的提问来源于stack exchange，提问作者Najathi