recipe-sync-contacts-to-sheet

用途：将 Google Contacts 目录导出到 Google Sheets 电子表格，适合需要把组织通讯录整理成表格进行查看、归档或后续处理的使用场景。

前置条件：执行本 recipe 前，需先加载以下技能：gws-people、gws-sheets。资料未说明这些技能的安装方式与获取途径。

主要步骤：

1. 列出联系人，命令为：gws people people listDirectoryPeople --params '{"readMask": "names,emailAddresses,phoneNumbers", "sources": ["DIRECTORY_SOURCE_TYPE_DOMAIN_PROFILE"], "pageSize": 100}' --format json
2. 创建表头，命令为：gws sheets +append --spreadsheet SHEET_ID --range 'Contacts' --values '["Name", "Email", "Phone"]'
3. 逐条追加联系人行，示例命令为：gws sheets +append --spreadsheet SHEET_ID --range 'Contacts' --values '["Jane Doe", "jane@company.com", "+1-555-0100"]'

使用方式说明：需要将命令中的 SHEET_ID 替换为目标电子表格的实际 ID；联系人数据来源于域目录资料（DIRECTORY_SOURCE_TYPE_DOMAIN_PROFILE），读取字段为姓名、邮箱、电话号码，分页大小为 100。示例中的联系人为演示数据。

适用场景：组织通讯录导出、联系人信息汇总到表格、基于 Google Workspace 命令行工具的数据搬运。

限制：资料未提供关于权限要求、配额限制、错误处理、分页遍历方式、字段映射规则以及是否支持个人联系人来源的说明。