用途
Log Deal Update to Sheet 是一个配方(recipe),用于把交易(Deal)的状态更新追加到 Google Sheets 中用于销售跟踪的电子表格里。它依赖同插件提供的底层能力来操作 Google Drive 和 Google Sheets。
前置条件
执行该配方前,必须先加载以下两个技能:
- gws-sheets
- gws-drive
使用方式
配方按以下步骤执行:
1. 查找跟踪表格
使用 gws drive files list 命令,按文件名为 Sales Pipeline、MIME 类型为 Google 电子表格的条件进行查找:
gws drive files list --params '{"q": "name = '\''Sales Pipeline'\'' and mimeType = '\''application/vnd.google-apps.spreadsheet'\''"}'
2. 读取当前数据
使用 gws sheets +read 命令读取该表格 Pipeline 工作表中 A1:F 范围的数据:
gws sheets +read --spreadsheet SHEET_ID --range "Pipeline!A1:F"
3. 追加新行
使用 gws sheets +append 命令向 Pipeline 工作表追加一行新记录:
gws sheets +append --spreadsheet SHEET_ID --range 'Pipeline' --values '["2026-03-21", "Acme Corp", "Proposal Sent", "$50,000", "Q2", "jdoe"]'
示例中的行数据依次为:日期、公司名称、交易阶段、金额、季度、负责人。
适用场景
适用于销售流程管理:在 Google Sheets 中维护销售管道(Sales Pipeline)表格时,将单个交易的最新状态以新增行的方式记录下来。
限制
关于该配方的错误处理、并发写入行为、权限要求细节、支持的字段格式以及是否可自定义表格或工作表名称等,资料中暂未提供。