用途
该技能（recipe-sync-contacts-to-sheet）用于将 Google Contacts 目录导出到 Google Sheets 电子表格，实现通讯录数据向表格的同步。
前置条件
执行本配方前，需要先加载以下技能：
- gws-people
- gws-sheets
主要能力
- 列出 Google Contacts 目录中的联系人信息，读取字段包括姓名（names）、邮箱（emailAddresses）、电话（phoneNumbers）。
- 在 Google Sheets 中创建表头行，列名为 Name、Email、Phone。
- 将每个联系人作为一行追加到指定电子表格的 Contacts 范围中。
使用方式
步骤一：列出联系人
gws people people listDirectoryPeople --params '{"readMask": "names,emailAddresses,phoneNumbers", "sources": ["DIRECTORY_SOURCE_TYPE_DOMAIN_PROFILE"], "pageSize": 100}' --format json
步骤二：创建表头行
gws sheets +append --spreadsheet SHEET_ID --range 'Contacts' --json-values '[["Name", "Email", "Phone"]]'
步骤三：逐条追加联系人数据行
gws sheets +append --spreadsheet SHEET_ID --range 'Contacts' --json-values '[["Jane Doe", "jane@company.com", "+1-555-0100"]]'
其中 SHEET_ID 需替换为目标电子表格的实际 ID。
适用场景
- 需要将 Google 通讯录目录批量导出到表格进行查看或备份。
- 需要以表格形式整理联系人姓名、邮箱和电话信息，便于后续处理。
限制
- 必须预先加载 gws-people 与 gws-sheets 技能。
- 联系人来源限定为 DIRECTORY_SOURCE_TYPE_DOMAIN_PROFILE（域配置文件目录）。
- 分页大小为 100，若联系人数量超过该值，需按分页机制继续获取。
- 关于收费、价格、平台支持范围及具体效果，资料中暂未提供。