返回

创建谷歌联系人并添加自定义字段：从入门到精通

python

创建谷歌联系人并添加自定义字段的完整指南

引言

在管理庞大联系人列表时，添加自定义字段可以提供无与伦比的组织性和个性化。谷歌联系人 API 允许您创建包含自定义字段的联系人，例如国家/地区代码、辅助电话号码、城市和职位。本指南将带您了解在使用 Google 联系人 API 创建联系人时添加自定义字段的详细步骤，并解决您可能遇到的任何问题。

准备工作

在开始之前，确保您已启用 Google 联系人 API ，并拥有有效的 API 密钥。此外，还需要使用 Python 和 Google API 客户端库。

格式化字段值

  • 电话号码： 国家/地区代码应包含在 canonicalForm 字段中，而不是 value 字段中。

    • 格式："+1 555-123-4567"

  • 城市： addresses[].city

  • 职位： occupations[].value

  • 公司： organizations[].title

  • 国家/地区代码： phoneNumbers[].canonicalForm

添加自定义字段

在创建新联系人的请求正文中，包括以下字段：

{
  "names": [{"givenName": "John"}],
  "phoneNumbers": [{"value": "+15551234567", "canonicalForm": "+1 555-123-4567"}],
  "occupations": [{"value": "Software Engineer"}],
  "organizations": [{"title": "Google"}],
  "emailAddresses": [{"value": "john.doe@example.com"}],
  "addresses": [{"city": "San Francisco"}],
}

代码示例：

service.people().createContact(body=request_body).execute()

搜索和检索自定义字段

搜索联系人时，使用包含已添加自定义字段值的查询。

代码示例：

results = service.people().searchContacts(query="city:San Francisco").execute()

疑难解答

1. 自定义字段未填充

  • 确保使用正确的字段名称。
  • 检查值是否按预期格式化。
  • 确保使用最新的 Google 联系人 API 版本。

2. 无法检索自定义字段

  • 确保搜索查询包含已添加自定义字段值的查询。
  • 检查 API 密钥是否有效。
  • 尝试从其他设备或网络访问 API。

结论

通过遵循本指南，您现在可以轻松地在 Google 联系人 API 中创建包含自定义字段的联系人。这将使您能够有效地组织和个性化您的联系人列表，从而提高工作效率和沟通质量。

常见问题解答

  • 哪些类型的自定义字段可以添加到 Google 联系人中？

    • 任意类型的字段，例如国家/地区代码、城市、职位和公司。

  • 我可以在现有联系人中添加自定义字段吗？

    • 是的，使用 updateContact 方法。

  • 我可以添加多个自定义字段吗？

    • 是的，您可以在一个联系人中添加任意数量的自定义字段。

  • 自定义字段存储在何处？

    • 自定义字段存储在 Google 联系人 API 中，可通过搜索或查询检索。

  • 我如何从 Google 联系人中删除自定义字段？

    • 使用 deleteCustomField 方法从联系人中删除自定义字段。