Google People API：指定标签内创建联系人不显示问题求助

针对你遇到的创建联系人关联标签后，通讯录页面不显示的问题，可按以下步骤排查解决：

1. 验证标签ID的正确性 #

确认代码中$folderId变量的实际值是你获取到的contactGroups/47b2ea780fbdabe，避免变量名混淆（比如误写为文件夹ID而非标签ID）或赋值错误。

2. 排查联系人创建后的实际关联状态 #

调用createContact后，通过API获取联系人详情，检查memberships字段是否正确关联目标标签：

// 获取创建后的联系人详情
$contact = $peopleService->people->get(
    $createdContact->getResourceName(),
    ['personFields' => 'memberships,names,emailAddresses']
);
print_r($contact);

查看返回结果中memberships数组内的contactGroupResourceName是否与目标标签ID一致，确认标签关联操作是否实际生效。

3. 排除页面显示的缓存或过滤问题 #

• Google通讯录网页端存在缓存延迟，尝试刷新页面或等待5-10分钟后再查看；
• 切换到对应的自定义标签页面查看，避免因页面过滤条件（如仅显示"我的联系人"）导致看不到目标标签下的联系人。

4. 改用单独添加成员的接口 #

如果创建联系人时关联标签的方式不生效，可拆分操作：先创建联系人，再调用contactGroups.members.modify接口将联系人添加到标签：

// 第一步：创建基础联系人（不含membership）
$person = new Google_Service_PeopleService_Person();
$names = new Google_Service_PeopleService_Name();
$names->setGivenName('Shankari');
$names->setFamilyName('s');
$person->setNames([$names]);

$email = new Google_Service_PeopleService_EmailAddress();
$email->setValue('shankari.s@example.com');
$person->setEmailAddresses([$email]);

$createdContact = $peopleService->people->createContact($person);

// 第二步：将联系人添加到指定标签
$modifyRequest = new Google_Service_PeopleService_ModifyContactGroupMembersRequest();
$modifyRequest->setResourceNamesToAdd([$createdContact->getResourceName()]);
$peopleService->contactGroups_members->modify('contactGroups/47b2ea780fbdabe', $modifyRequest);

5. 检查API权限范围 #

确保你的OAuth授权scope包含https://www.googleapis.com/auth/contacts（读写权限），只读scope（如contacts.readonly）会导致标签关联操作静默失败，无报错但不生效。

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