SuperAPI AI 工具集

recipe-log-deal-update

办公与效率

查看项目

更新于 10-16 06:10

技能介绍

用途

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)表格时,将单个交易的最新状态以新增行的方式记录下来。

限制

关于该配方的错误处理、并发写入行为、权限要求细节、支持的字段格式以及是否可自定义表格或工作表名称等,资料中暂未提供。