Google API People添加联系人异常：API返回成功但网页端不显示

我之前也碰到过一模一样的情况，折腾了好一会儿才摸清楚原因，给你几个实用的排查方向：

1. 先确认你的认证方式是否正确 #

如果是用服务账户调用的API，那大概率是这里出了问题：服务账户本身有独立的联系人存储空间，你创建的联系人都存在服务账户的私有空间里，自然在你个人的contacts.google.com页面看不到。

解决办法分两种情况：

• 如果你是Google Workspace用户，需要给服务账户配置域范围授权，让它能代表你的个人账户操作联系人；
• 普通个人用户的话，建议改用OAuth 2.0授权码模式，直接获取你个人账户的操作权限，这样创建的联系人就会同步到你自己的通讯录里。

2. 检查联系人是否被加入正确的通讯录组 #

People API创建联系人时默认会加入"我的联系人"组，但偶尔会因为参数设置疏漏，被放到其他组或者未分组集合里。你可以在调用listPeopleConnections时，加上personFields=memberships参数，查看联系人的归属：

$connections = $peopleService->people_connections->listPeopleConnections('people/me', [
    'personFields' => 'names,memberships',
    'requestSyncToken' => true
]);
foreach ($connections->getConnections() as $person) {
    print_r($person->getMemberships());
}

如果返回结果里没有指向contactGroups/myContacts的成员关系，那你需要在创建联系人时主动添加这个组：

// 创建"我的联系人"组的成员关系
$membership = new Google_Service_People_ContactGroupMembership();
$membership->setContactGroupResourceName('contactGroups/myContacts');

// 组装联系人对象并添加组关系
$person = new Google_Service_People_Person();
$person->setNames([/* 你的姓名配置 */]);
// 其他联系人字段配置...
$person->setMemberships([$membership]);

// 创建联系人
$peopleService->people->createContact($person);

3. 排除同步延迟的小概率情况 #

虽然大部分时候API创建后网页端会立刻同步，但偶尔会有几分钟的延迟。你可以试试手动刷新通讯录页面，或者在页面右上角的"更多"菜单里选择"刷新"选项，看看联系人会不会出现。

4. 核对API权限范围 #

确保你请求的OAuth权限包含https://www.googleapis.com/auth/contacts（这个权限允许读写联系人），而不是只读类的权限。如果用的是服务账户，也要确认授权范围里包含这个权限。

内容的提问来源于stack exchange，提问作者Ronny Drechsler-Hildebrandt